Skip to content

Improve Javadoc for StringUtils.isBlank (closes apache/commons-lang#1… #1618

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
NoctisSolvane wants to merge 3 commits into from
+7 −14
Closed

Improve Javadoc for StringUtils.isBlank (closes apache/commons-lang#1… #1618

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3f4c4f4
Improve Javadoc for StringUtils.isBlank (closes apache/commons-lang#1…
NoctisSolvane Mar 22, 2026
13507ea
Removed the @since tag which would probably confuse history and wasn'…
NoctisSolvane Mar 23, 2026
74405e2
Simplify JavaDoc improvement for isBlank based on review feedback
NoctisSolvane Mar 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 7 additions & 14 deletions src/main/java/org/apache/commons/lang3/StringUtils.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3497,20 +3497,13 @@ public static boolean isAsciiPrintable(final CharSequence cs) {
}

/**
* Tests if a CharSequence is empty ({@code "")}, null, or contains only whitespace as defined by {@link Character#isWhitespace(char)}.
*
* <pre>
* StringUtils.isBlank(null) = true
* StringUtils.isBlank("") = true
* StringUtils.isBlank(" ") = true
* StringUtils.isBlank("bob") = false
* StringUtils.isBlank(" bob ") = false
* </pre>
*
* @param cs the CharSequence to check, may be null.
* @return {@code true} if the CharSequence is null, empty or whitespace only.
* @since 2.0
* @since 3.0 Changed signature from isBlank(String) to isBlank(CharSequence)
* Checks if a CharSequence is empty(""), null or whitespace only.
* <p>
* Whitespace is determined by {@link Charachter#isWhiteSpace(char)}
* </p>
*
* @param cs the CharSequence to check, may be null
* @return {@code true} if the CharSequence is empty, null or whitespace only
*/
public static boolean isBlank(final CharSequence cs) {
final int strLen = length(cs);
Expand Down