archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 06:14:49 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8138614: (spec str) StringBuffer and StringBuilder methods improperly require "new" String to be returned

Browse source 
Reviewed-by: rgiulietti, shade, alanb, rriggs, liach
This commit is contained in:
Stuart Marks 2025-02-25 15:18:30 +00:00
parent b17c0b63a1
commit 08bc59da9b
1 changed files with 8 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

17
src/java.base/share/classes/java/lang/AbstractStringBuilder.java
View file

@ -1027,13 +1027,13 @@ abstract sealed class AbstractStringBuilder implements Appendable, CharSequence
} }
/** /**
* Returns a new {@code String} that contains a subsequence of * Returns a {@code String} that contains a subsequence of
* characters currently contained in this character sequence. The * characters currently contained in this character sequence. The
* substring begins at the specified index and extends to the end of * substring begins at the specified index and extends to the end of
* this sequence. * this sequence.
* *
* @param start The beginning index, inclusive. * @param start The beginning index, inclusive.
* @return The new string. * @return A string containing the specified subsequence of characters.
* @throws StringIndexOutOfBoundsException if {@code start} is * @throws StringIndexOutOfBoundsException if {@code start} is
* less than zero, or greater than the length of this object. * less than zero, or greater than the length of this object.
*/ */
@ -1042,7 +1042,7 @@ abstract sealed class AbstractStringBuilder implements Appendable, CharSequence
} }
/** /**
* Returns a new character sequence that is a subsequence of this sequence. * Returns a character sequence that is a subsequence of this sequence.
* *
* <p> An invocation of this method of the form * <p> An invocation of this method of the form
* *
@ -1072,14 +1072,14 @@ abstract sealed class AbstractStringBuilder implements Appendable, CharSequence
} }
/** /**
* Returns a new {@code String} that contains a subsequence of * Returns a {@code String} that contains a subsequence of
* characters currently contained in this sequence. The * characters currently contained in this sequence. The
* substring begins at the specified {@code start} and * substring begins at the specified {@code start} and
* extends to the character at index {@code end - 1}. * extends to the character at index {@code end - 1}.
* *
* @param start The beginning index, inclusive. * @param start The beginning index, inclusive.
* @param end The ending index, exclusive. * @param end The ending index, exclusive.
* @return The new string. * @return A string containing the specified subsequence of characters.
* @throws StringIndexOutOfBoundsException if {@code start} * @throws StringIndexOutOfBoundsException if {@code start}
* or {@code end} are negative or greater than * or {@code end} are negative or greater than
* {@code length()}, or {@code start} is * {@code length()}, or {@code start} is
@ -1602,11 +1602,10 @@ abstract sealed class AbstractStringBuilder implements Appendable, CharSequence
/** /**
* Returns a string representing the data in this sequence. * Returns a string representing the data in this sequence.
* A new {@code String} object is allocated and initialized to * The {@code String} object that is returned contains the character
* contain the character sequence currently represented by this * sequence currently represented by this object. Subsequent
* object. This {@code String} is then returned. Subsequent
* changes to this sequence do not affect the contents of the * changes to this sequence do not affect the contents of the
* {@code String}. * returned {@code String}.
* *
* @return a string representation of this sequence of characters. * @return a string representation of this sequence of characters.
*/ */