commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nia...@apache.org
Subject svn commit: r1056864 - /commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
Date Sun, 09 Jan 2011 02:10:44 GMT
Author: niallp
Date: Sun Jan  9 02:10:44 2011
New Revision: 1056864

URL: http://svn.apache.org/viewvc?rev=1056864&view=rev
Log:
Port LANG-643 to LANG 2.x Branch - Javadoc StringUtils.left() claims to throw an exception
on negative lenth, but doesn't

Modified:
    commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java

Modified: commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
URL: http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java?rev=1056864&r1=1056863&r2=1056864&view=diff
==============================================================================
--- commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
(original)
+++ commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
Sun Jan  9 02:10:44 2011
@@ -1937,7 +1937,7 @@ public class StringUtils {
      *
      * <p>If <code>len</code> characters are not available, or the
      * String is <code>null</code>, the String will be returned without
-     * an exception. An exception is thrown if len is negative.</p>
+     * an exception. An empty String is returned if len is negative.</p>
      *
      * <pre>
      * StringUtils.left(null, *)    = null
@@ -1949,7 +1949,7 @@ public class StringUtils {
      * </pre>
      *
      * @param str  the String to get the leftmost characters from, may be null
-     * @param len  the length of the required String, must be zero or positive
+     * @param len  the length of the required String
      * @return the leftmost characters, <code>null</code> if null String input
      */
     public static String left(String str, int len) {
@@ -1970,7 +1970,7 @@ public class StringUtils {
      *
      * <p>If <code>len</code> characters are not available, or the String
      * is <code>null</code>, the String will be returned without an
-     * an exception. An exception is thrown if len is negative.</p>
+     * an exception. An empty String is returned if len is negative.</p>
      *
      * <pre>
      * StringUtils.right(null, *)    = null
@@ -1982,7 +1982,7 @@ public class StringUtils {
      * </pre>
      *
      * @param str  the String to get the rightmost characters from, may be null
-     * @param len  the length of the required String, must be zero or positive
+     * @param len  the length of the required String
      * @return the rightmost characters, <code>null</code> if null String input
      */
     public static String right(String str, int len) {
@@ -2004,7 +2004,8 @@ public class StringUtils {
      * <p>If <code>len</code> characters are not available, the remainder
      * of the String will be returned without an exception. If the
      * String is <code>null</code>, <code>null</code> will be returned.
-     * An exception is thrown if len is negative.</p>
+     * An empty String is returned if len is negative or exceeds the
+     * length of <code>str</code>.</p>
      *
      * <pre>
      * StringUtils.mid(null, *, *)    = null
@@ -2019,7 +2020,7 @@ public class StringUtils {
      *
      * @param str  the String to get the characters from, may be null
      * @param pos  the position to start from, negative treated as zero
-     * @param len  the length of the required String, must be zero or positive
+     * @param len  the length of the required String
      * @return the middle characters, <code>null</code> if null String input
      */
     public static String mid(String str, int pos, int len) {



Mime
View raw message