API Overview API Index Package Overview Direct link to this page
JDK 1.6
  java.lang. String View Source
Author(s)
Lee Boynton
Arthur van Hoff
Since
JDK1.0
Version
1.204, 06/09/06
Serial
Hierarchy
 Object
      String
Implements
 Serializable
 Comparable
 CharSequence
Subclasses
Description
publicfinal class String
  The String class represents character strings.
Constructors
public String ()
  Initializes a newly created String object so that it represents an empty character sequence.
public String (byte[] bytes)
  Constructs a new String by decoding the specified array of bytes using the platform's default charset.
public String (byte[] bytes, Charset charset)
  Constructs a new String by decoding the specified array of bytes using the specified charset.
@Deprecated
public String (byte[] ascii, int hibyte)
  Allocates a new String containing characters constructed from an array of 8-bit integer values.
public String (byte[] bytes, int offset, int length)
  Constructs a new String by decoding the specified subarray of bytes using the platform's default charset.
public String (byte[] bytes, int offset, int length, Charset charset)
  Constructs a new String by decoding the specified subarray of bytes using the specified charset.
@Deprecated
public String (byte[] ascii, int hibyte, int offset, int count)
  Allocates a new String constructed from a subarray of an array of 8-bit integer values.
public String (byte[] bytes, int offset, int length, String charsetName) throws UnsupportedEncodingException
  Constructs a new String by decoding the specified subarray of bytes using the specified charset.
public String (byte[] bytes, String charsetName) throws UnsupportedEncodingException
  Constructs a new String by decoding the specified array of bytes using the specified charset.
public String (char[] value)
  Allocates a new String so that it represents the sequence of characters currently contained in the character array argument.
public String (char[] value, int offset, int count)
  Allocates a new String that contains characters from a subarray of the character array argument.
public String (int[] codePoints, int offset, int count)
  Allocates a new String that contains characters from a subarray of the Unicode code point array argument.
pack-private String (int offset, int count, char[] value)
public String (String original)
  Initializes a newly created String object so that it represents the same sequence of characters as the argument; in other words, the newly created string is a copy of the argument string.
public String (StringBuffer buffer)
  Allocates a new string that contains the sequence of characters currently contained in the string buffer argument.
public String (StringBuilder builder)
  Allocates a new string that contains the sequence of characters currently contained in the string builder argument.
Methods
Hide/Show inherited methods
public char charAt (int index) [Specified in CharSequence]
  Returns the char value at the specified index.
public int codePointAt (int index)
  Returns the character (Unicode code point) at the specified index.
public int codePointBefore (int index)
  Returns the character (Unicode code point) before the specified index.
public int codePointCount (int beginIndex, int endIndex)
  Returns the number of Unicode code points in the specified text range of this String.
public int compareTo (String anotherString)
  Compares two strings lexicographically.
public int compareToIgnoreCase (String str)
  Compares two strings lexicographically, ignoring case differences.
public String concat (String str)
  Concatenates the specified string to the end of this string.
public boolean contains (CharSequence s)
  Returns true if and only if this string contains the specified sequence of char values.
public boolean contentEquals (CharSequence cs)
  Compares this string to the specified CharSequence.
public boolean contentEquals (StringBuffer sb)
  Compares this string to the specified StringBuffer.
publicstatic String copyValueOf (char[] data)
  Returns a String that represents the character sequence in the array specified.
publicstatic String copyValueOf (char[] data, int offset, int count)
  Returns a String that represents the character sequence in the array specified.
public boolean endsWith (String suffix)
  Tests if this string ends with the specified suffix.
public boolean equals (Object anObject)
  Compares this string to the specified object.
public boolean equalsIgnoreCase (String anotherString)
  Compares this String to another String, ignoring case considerations.
publicstatic String format (Locale l, String format, Object args)
  Returns a formatted string using the specified locale, format string, and arguments.
publicstatic String format (String format, Object args)
  Returns a formatted string using the specified format string and arguments.
public byte getBytes ()
  Encodes this String into a sequence of bytes using the platform's default charset, storing the result into a new byte array.
public byte getBytes (Charset charset)
  Encodes this String into a sequence of bytes using the given charset, storing the result into a new byte array.
@Deprecated
public void getBytes (int srcBegin, int srcEnd, byte[] dst, int dstBegin)
  Copies characters from this string into the destination byte array.
public byte getBytes (String charsetName) throws UnsupportedEncodingException
  Encodes this String into a sequence of bytes using the named charset, storing the result into a new byte array.
pack-private void getChars (char[] dst, int dstBegin)
  Copy characters from this string into dst starting at dstBegin.
public void getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin)
  Copies characters from this string into the destination character array.
public int hashCode ()
  Returns a hash code for this string.
pack-privatestatic int indexOf (char[] source, int sourceOffset, int sourceCount, char[] target, int targetOffset, int targetCount, int fromIndex)
  Code shared by String and StringBuffer to do searches.
public int indexOf (int ch)
  Returns the index within this string of the first occurrence of the specified character.
public int indexOf (int ch, int fromIndex)
  Returns the index within this string of the first occurrence of the specified character, starting the search at the specified index.
public int indexOf (String str)
  Returns the index within this string of the first occurrence of the specified substring.
public int indexOf (String str, int fromIndex)
  Returns the index within this string of the first occurrence of the specified substring, starting at the specified index.
publicnative String intern ()
  Returns a canonical representation for the string object.
public boolean isEmpty ()
  Returns true if, and only if, String.length() is 0.
pack-privatestatic int lastIndexOf (char[] source, int sourceOffset, int sourceCount, char[] target, int targetOffset, int targetCount, int fromIndex)
  Code shared by String and StringBuffer to do searches.
public int lastIndexOf (int ch)
  Returns the index within this string of the last occurrence of the specified character.
public int lastIndexOf (int ch, int fromIndex)
  Returns the index within this string of the last occurrence of the specified character, searching backward starting at the specified index.
public int lastIndexOf (String str)
  Returns the index within this string of the rightmost occurrence of the specified substring.
public int lastIndexOf (String str, int fromIndex)
  Returns the index within this string of the last occurrence of the specified substring, searching backward starting at the specified index.
public int length () [Specified in CharSequence]
  Returns the length of this string.
public boolean matches (String regex)
  Tells whether or not this string matches the given regular expression.
public int offsetByCodePoints (int index, int codePointOffset)
  Returns the index within this String that is offset from the given index by codePointOffset code points.
public boolean regionMatches (boolean ignoreCase, int toffset, String other, int ooffset, int len)
  Tests if two string regions are equal.
public boolean regionMatches (int toffset, String other, int ooffset, int len)
  Tests if two string regions are equal.
public String replace (char oldChar, char newChar)
  Returns a new string resulting from replacing all occurrences of oldChar in this string with newChar.
public String replace (CharSequence target, CharSequence replacement)
  Replaces each substring of this string that matches the literal target sequence with the specified literal replacement sequence.
public String replaceAll (String regex, String replacement)
  Replaces each substring of this string that matches the given regular expression with the given replacement.
public String replaceFirst (String regex, String replacement)
  Replaces the first substring of this string that matches the given regular expression with the given replacement.
public String split (String regex)
  Splits this string around matches of the given regular expression.
public String split (String regex, int limit)
  Splits this string around matches of the given regular expression.
public boolean startsWith (String prefix)
  Tests if this string starts with the specified prefix.
public boolean startsWith (String prefix, int toffset)
  Tests if the substring of this string beginning at the specified index starts with the specified prefix.
public CharSequence subSequence (int beginIndex, int endIndex) [Specified in CharSequence]
  Returns a new character sequence that is a subsequence of this sequence.
public String substring (int beginIndex)
  Returns a new string that is a substring of this string.
public String substring (int beginIndex, int endIndex)
  Returns a new string that is a substring of this string.
public char toCharArray ()
  Converts this string to a new character array.
public String toLowerCase ()
  Converts all of the characters in this String to lower case using the rules of the default locale.
public String toLowerCase (Locale locale)
  Converts all of the characters in this String to lower case using the rules of the given Locale.
public String toString () [Specified in CharSequence]
  This object (which is already a string!) is itself returned.
public String toUpperCase ()
  Converts all of the characters in this String to upper case using the rules of the default locale.
public String toUpperCase (Locale locale)
  Converts all of the characters in this String to upper case using the rules of the given Locale.
public String trim ()
  Returns a copy of the string, with leading and trailing whitespace omitted.
publicstatic String valueOf (boolean b)
  Returns the string representation of the boolean argument.
publicstatic String valueOf (char c)
  Returns the string representation of the char argument.
publicstatic String valueOf (char[] data)
  Returns the string representation of the char array argument.
publicstatic String valueOf (char[] data, int offset, int count)
  Returns the string representation of a specific subarray of the char array argument.
publicstatic String valueOf (double d)
  Returns the string representation of the double argument.
publicstatic String valueOf (float f)
  Returns the string representation of the float argument.
publicstatic String valueOf (int i)
  Returns the string representation of the int argument.
publicstatic String valueOf (long l)
  Returns the string representation of the long argument.
publicstatic String valueOf (Object obj)
  Returns the string representation of the Object argument.
Fields
Hide/Show inherited fields
publicfinalstatic Comparator<String> CASE_INSENSITIVE_ORDER
  A Comparator that orders String objects as by compareToIgnoreCase.
Nested Classes
Generated By: JavaOnTracks Doclet 0.1.4     ©Thibaut Colar