commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ggreg...@apache.org
Subject svn commit: r930911 - /commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
Date Mon, 05 Apr 2010 17:24:48 GMT
Author: ggregory
Date: Mon Apr  5 17:24:48 2010
New Revision: 930911

URL: http://svn.apache.org/viewvc?rev=930911&view=rev
Log:
@since 3.0 Changed signature from methodName(String) to methodName(CharSequence)

Modified:
    commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java

Modified: commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java?rev=930911&r1=930910&r2=930911&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java (original)
+++ commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java Mon
Apr  5 17:24:48 2010
@@ -187,6 +187,7 @@ public class StringUtils {
      *
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if the CharSequence is empty or null
+     * @since 3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)
      */
     public static boolean isEmpty(CharSequence cs) {
         return cs == null || cs.length() == 0;
@@ -205,6 +206,7 @@ public class StringUtils {
      *
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if the CharSequence is not empty and not null
+     * @since 3.0 Changed signature from isNotEmpty(String) to isNotEmpty(CharSequence)
      */
     public static boolean isNotEmpty(CharSequence cs) {
         return !StringUtils.isEmpty(cs);
@@ -224,6 +226,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if the CharSequence is null, empty or whitespace
      * @since 2.0
+     * @since 3.0 Changed signature from isBlank(String) to isBlank(CharSequence)
      */
     public static boolean isBlank(CharSequence cs) {
         int strLen;
@@ -253,6 +256,7 @@ public class StringUtils {
      * @return <code>true</code> if the CharSequence is
      *  not empty and not null and not whitespace
      * @since 2.0
+     * @since 3.0 Changed signature from isNotBlank(String) to isNotBlank(CharSequence)
      */
     public static boolean isNotBlank(CharSequence cs) {
         return !StringUtils.isBlank(cs);
@@ -693,6 +697,7 @@ public class StringUtils {
      * @param cs2  the second CharSequence, may be null
      * @return <code>true</code> if the CharSequences are equal, case sensitive,
or
      *  both <code>null</code>
+     * @since 3.0 Changed signature from equals(String, String) to equals(CharSequence, CharSequence)
      */
     public static boolean equals(CharSequence cs1, CharSequence cs2) {
         return cs1 == null ? cs2 == null : cs1.equals(cs2);
@@ -1365,6 +1370,7 @@ public class StringUtils {
      * @param searchChars  the chars to search for, may be null
      * @return the index of any of the chars, -1 if no match or null input
      * @since 2.0
+     * @since 3.0 Changed signature from indexOfAny(String, char[]) to indexOfAny(CharSequence,
char[])
      */
     public static int indexOfAny(CharSequence cs, char[] searchChars) {
         if (isEmpty(cs) || ArrayUtils.isEmpty(searchChars)) {
@@ -1413,6 +1419,7 @@ public class StringUtils {
      * @param searchChars  the chars to search for, may be null
      * @return the index of any of the chars, -1 if no match or null input
      * @since 2.0
+     * @since 3.0 Changed signature from indexOfAny(String, String) to indexOfAny(CharSequence,
String)
      */
     public static int indexOfAny(CharSequence cs, String searchChars) {
         if (isEmpty(cs) || isEmpty(searchChars)) {
@@ -1533,6 +1540,7 @@ public class StringUtils {
      * @param searchChars  the chars to search for, may be null
      * @return the index of any of the chars, -1 if no match or null input
      * @since 2.0
+     * @since 3.0 Changed signature from indexOfAnyBut(String, char[]) to indexOfAnyBut(CharSequence,
char[])
      */
     public static int indexOfAnyBut(CharSequence cs, char[] searchChars) {
         if (isEmpty(cs) || ArrayUtils.isEmpty(searchChars)) {
@@ -1627,6 +1635,7 @@ public class StringUtils {
      * @param cs  the String to check, may be null
      * @param valid  an array of valid chars, may be null
      * @return true if it only contains valid chars and is non-null
+     * @since 3.0 Changed signature from containsOnly(String, char[]) to containsOnly(CharSequence,
char[])
      */
     public static boolean containsOnly(CharSequence cs, char[] valid) {
         // All these pre-checks are to maintain API with an older version
@@ -1663,6 +1672,7 @@ public class StringUtils {
      * @param validChars  a String of valid chars, may be null
      * @return true if it only contains valid chars and is non-null
      * @since 2.0
+     * @since 3.0 Changed signature from containsOnly(String, String) to containsOnly(CharSequence,
String)
      */
     public static boolean containsOnly(CharSequence cs, String validChars) {
         if (cs == null || validChars == null) {
@@ -1694,6 +1704,7 @@ public class StringUtils {
      * @param searchChars  an array of invalid chars, may be null
      * @return true if it contains none of the invalid chars, or is null
      * @since 2.0
+     * @since 3.0 Changed signature from containsNone(String, char[]) to containsNone(CharSequence,
char[])
      */
     public static boolean containsNone(CharSequence cs, char[] searchChars) {
         if (cs == null || searchChars == null) {
@@ -1746,6 +1757,7 @@ public class StringUtils {
      * @param invalidChars  a String of invalid chars, may be null
      * @return true if it contains none of the invalid chars, or is null
      * @since 2.0
+     * @since 3.0 Changed signature from containsNone(String, String) to containsNone(CharSequence,
String)
      */
     public static boolean containsNone(CharSequence cs, String invalidChars) {
         if (cs == null || invalidChars == null) {
@@ -4716,6 +4728,7 @@ public class StringUtils {
      *         <code>null</code>.
      * @since 2.4
      * @deprecated See {@link CharSequenceUtils#length(CharSequence)}
+     * @since 3.0 Changed signature from length(String) to length(CharSequence)
      */
     public static int length(CharSequence cs) {
         return CharSequenceUtils.length(cs);
@@ -4950,6 +4963,7 @@ public class StringUtils {
      * @see org.apache.commons.lang3.text.WordUtils#capitalize(String)
      * @see #uncapitalize(CharSequence)
      * @since 2.0
+     * @since 3.0 Changed signature from capitalize(String) to capitalize(CharSequence)
      */
     public static String capitalize(CharSequence cs) {
         if (cs == null ) {
@@ -4984,6 +4998,7 @@ public class StringUtils {
      * @see org.apache.commons.lang3.text.WordUtils#uncapitalize(String)
      * @see #capitalize(CharSequence)
      * @since 2.0
+     * @since 3.0 Changed signature from uncapitalize(String) to uncapitalize(CharSequence)
      */
     public static String uncapitalize(CharSequence cs) {
         if (cs == null ) {
@@ -5101,6 +5116,7 @@ public class StringUtils {
      *
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains letters, and is non-null
+     * @since 3.0 Changed signature from isAlpha(String) to isAlpha(CharSequence)
      */
     public static boolean isAlpha(CharSequence cs) {
         if (cs == null) {
@@ -5135,6 +5151,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains letters and space,
      *  and is non-null
+     * @since 3.0 Changed signature from isAlphaSpace(String) to isAlphaSpace(CharSequence)
      */
     public static boolean isAlphaSpace(CharSequence cs) {
         if (cs == null) {
@@ -5168,6 +5185,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains letters or digits,
      *  and is non-null
+     * @since 3.0 Changed signature from isAlphanumeric(String) to isAlphanumeric(CharSequence)
      */
     public static boolean isAlphanumeric(CharSequence cs) {
         if (cs == null) {
@@ -5202,6 +5220,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains letters, digits or space,
      *  and is non-null
+     * @since 3.0 Changed signature from isAlphanumericSpace(String) to isAlphanumericSpace(CharSequence)
      */
     public static boolean isAlphanumericSpace(CharSequence cs) {
         if (cs == null) {
@@ -5240,6 +5259,7 @@ public class StringUtils {
      * @return <code>true</code> if every character is in the range
      *  32 thru 126
      * @since 2.1
+     * @since 3.0 Changed signature from isAsciiPrintable(String) to isAsciiPrintable(CharSequence)
      */
     public static boolean isAsciiPrintable(CharSequence cs) {
         if (cs == null) {
@@ -5274,6 +5294,7 @@ public class StringUtils {
      *
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains digits, and is non-null
+     * @since 3.0 Changed signature from isNumeric(String) to isNumeric(CharSequence)
      */
     public static boolean isNumeric(CharSequence cs) {
         if (cs == null) {
@@ -5310,6 +5331,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains digits or space,
      *  and is non-null
+     * @since 3.0 Changed signature from isNumericSpace(String) to isNumericSpace(CharSequence)
      */
     public static boolean isNumericSpace(CharSequence cs) {
         if (cs == null) {
@@ -5342,6 +5364,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains whitespace, and is non-null
      * @since 2.0
+     * @since 3.0 Changed signature from isWhitespace(String) to isWhitespace(CharSequence)
      */
     public static boolean isWhitespace(CharSequence cs) {
         if (cs == null) {
@@ -5373,6 +5396,7 @@ public class StringUtils {
      * @param cs  the CharSequence to check, may be null
      * @return <code>true</code> if only contains lowercase characters, and is
non-null
      * @since 2.5
+     * @since 3.0 Changed signature from isAllLowerCase(String) to isAllLowerCase(CharSequence)
      */
     public static boolean isAllLowerCase(CharSequence cs) {
         if (cs == null || isEmpty(cs)) {
@@ -5404,6 +5428,7 @@ public class StringUtils {
      * @param cs the CharSequence to check, may be null
      * @return <code>true</code> if only contains uppercase characters, and is
non-null
      * @since 2.5
+     * @since 3.0 Changed signature from isAllUpperCase(String) to isAllUpperCase(CharSequence)
      */
     public static boolean isAllUpperCase(CharSequence cs) {
         if (cs == null || isEmpty(cs)) {
@@ -5750,6 +5775,7 @@ public class StringUtils {
      * @param cs2  the second CharSequence, may be null
      * @return the index where cs1 and cs2 begin to differ; -1 if they are equal
      * @since 2.0
+     * @since 3.0 Changed signature from indexOfDifference(String, String) to indexOfDifference(CharSequence,
CharSequence)
      */
     public static int indexOfDifference(CharSequence cs1, CharSequence cs2) {
         if (cs1 == cs2) {
@@ -5800,6 +5826,7 @@ public class StringUtils {
      * @param css  array of CharSequences, entries may be null
      * @return the index where the strings begin to differ; -1 if they are all equal
      * @since 2.4
+     * @since 3.0 Changed signature from indexOfDifference(String...) to indexOfDifference(CharSequence...)
      */
     public static int indexOfDifference(CharSequence... css) {
         if (css == null || css.length <= 1) {
@@ -5947,6 +5974,7 @@ public class StringUtils {
      * @param t  the second String, must not be null
      * @return result distance
      * @throws IllegalArgumentException if either String input <code>null</code>
+     * @since 3.0 Changed signature from getLevenshteinDistance(String, String) to getLevenshteinDistance(CharSequence,
CharSequence)
      */
     public static int getLevenshteinDistance(CharSequence s, CharSequence t) {
         if (s == null || t == null) {



Mime
View raw message