java.lang

Class String

java.lang.Object

java.lang.String

All Implemented Interfaces:

Serializable, CharSequence, Comparable<String>

public final class String
extends Object
implements Comparable<String>, CharSequence, Serializable

Intrinsic string class.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<String>	CASE_INSENSITIVE_ORDER

Constructor Summary

Constructors

Constructor and Description
String()
String(byte[] bytes)
String(byte[] bytes, int ofs, int len)
String(byte[] bytes, int ofs, int len, String charsetName)
String(byte[] bytes, String charsetName)
String(char[] value)
String(char[] value, int offset, int count)
String(int[] codePoints, int offset, int count)
String(String other)
String(StringBuffer sb)
String(StringBuilder sb)

Method Summary

Modifier and Type	Method and Description
char	charAt(int index)
int	codePointAt(int index)
int	codePointBefore(int index)
int	codePointCount(int beginIndex, int endIndex)
int	compareTo(String other)
int	compareToIgnoreCase(String other)
String	concat(String str)
boolean	contains(CharSequence s)
boolean	contentEquals(CharSequence cs)
boolean	contentEquals(StringBuffer sb)
static String	copyValueOf(char[] v)
static String	copyValueOf(char[] v, int offset, int count)
boolean	endsWith(String suffix)
boolean	equals(Object other)
boolean	equalsIgnoreCase(String other)
byte[]	getBytes()
byte[]	getBytes(String charSet)
void	getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
Class<? extends Object>	getClass() Magic; JSODevirtualizer will use this implementation.
int	hashCode()
int	indexOf(int codePoint)
int	indexOf(int codePoint, int startIndex)
int	indexOf(String str)
int	indexOf(String str, int startIndex)
String	intern()
boolean	isEmpty()
int	lastIndexOf(int codePoint)
int	lastIndexOf(int codePoint, int startIndex)
int	lastIndexOf(String str)
int	lastIndexOf(String str, int start)
int	length()
boolean	matches(String regex) Regular expressions vary from the standard implementation.
int	offsetByCodePoints(int index, int codePointOffset)
boolean	regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)
boolean	regionMatches(int toffset, String other, int ooffset, int len)
String	replace(char from, char to)
String	replace(CharSequence from, CharSequence to)
String	replaceAll(String regex, String replace) Regular expressions vary from the standard implementation.
String	replaceFirst(String regex, String replace) Regular expressions vary from the standard implementation.
String[]	split(String regex) Regular expressions vary from the standard implementation.
String[]	split(String regex, int maxMatch) Regular expressions vary from the standard implementation.
boolean	startsWith(String prefix)
boolean	startsWith(String prefix, int toffset)
CharSequence	subSequence(int beginIndex, int endIndex)
String	substring(int beginIndex)
String	substring(int beginIndex, int endIndex)
char[]	toCharArray()
String	toLowerCase() Transforms the String to lower-case in a locale insensitive way.
String	toLowerCase(Locale locale) If provided locale is Locale.getDefault(), uses javascript's toLocaleLowerCase to do a locale specific transformation.
String	toString()
String	toUpperCase()
String	toUpperCase(Locale locale)
String	trim()
static String	valueOf(boolean x)
static String	valueOf(char x)
static String	valueOf(char[] x)
static String	valueOf(char[] x, int offset, int count)
static String	valueOf(double x)
static String	valueOf(float x)
static String	valueOf(int x)
static String	valueOf(long x)
static String	valueOf(Object x)

Methods inherited from class java.lang.Object

finalize

Field Detail

CASE_INSENSITIVE_ORDER

public static final Comparator<String> CASE_INSENSITIVE_ORDER

Constructor Detail

String

public String()

String

public String(byte[] bytes)

String

public String(byte[] bytes,
              int ofs,
              int len)

String

public String(byte[] bytes,
              int ofs,
              int len,
              String charsetName)
       throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

String

public String(byte[] bytes,
              String charsetName)
       throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

String

public String(char[] value)

String

public String(char[] value,
              int offset,
              int count)

String

public String(int[] codePoints,
              int offset,
              int count)

String

public String(String other)

String

public String(StringBuffer sb)

String

public String(StringBuilder sb)

Method Detail

copyValueOf

public static String copyValueOf(char[] v)

copyValueOf

public static String copyValueOf(char[] v,
                                 int offset,
                                 int count)

valueOf

public static String valueOf(boolean x)

valueOf

public static String valueOf(char x)

valueOf

public static String valueOf(char[] x,
                             int offset,
                             int count)

valueOf

public static String valueOf(char[] x)

valueOf

public static String valueOf(double x)

valueOf

public static String valueOf(float x)

valueOf

public static String valueOf(int x)

valueOf

public static String valueOf(long x)

valueOf

public static String valueOf(Object x)

charAt

public char charAt(int index)

Specified by:

charAt in interface CharSequence

codePointAt

public int codePointAt(int index)

codePointBefore

public int codePointBefore(int index)

codePointCount

public int codePointCount(int beginIndex,
                          int endIndex)

compareTo

public int compareTo(String other)

Specified by:

compareTo in interface Comparable<String>

compareToIgnoreCase

public int compareToIgnoreCase(String other)

concat

public String concat(String str)

contains

public boolean contains(CharSequence s)

contentEquals

public boolean contentEquals(CharSequence cs)

contentEquals

public boolean contentEquals(StringBuffer sb)

endsWith

public boolean endsWith(String suffix)

equals

public boolean equals(Object other)

Overrides:

equals in class Object

equalsIgnoreCase

public boolean equalsIgnoreCase(String other)

getBytes

public byte[] getBytes()

getBytes

public byte[] getBytes(String charSet)
                throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

getChars

public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)

getClass

public Class<? extends Object> getClass()

Magic; JSODevirtualizer will use this implementation.

Each class gets a synthetic stubs for getClass at AST construction time with the exception of Object, JavaScriptObject and subclasses and String; see GwtAstBuilder.createMembers().

These stubs are replaced in ReplaceGetClassOverrides by an access to field __clazz which is initialized in each class prototype to point to the class literal. String is implemented as a plain JavaScript string hence lacking said field.

The devirtualizer JsoDevirtualizer will insert a trampoline that uses this implementation.

Overrides:

getClass in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

indexOf

public int indexOf(int codePoint)

indexOf

public int indexOf(int codePoint,
                   int startIndex)

indexOf

public int indexOf(String str)

indexOf

public int indexOf(String str,
                   int startIndex)

intern

public String intern()

isEmpty

public boolean isEmpty()

lastIndexOf

public int lastIndexOf(int codePoint)

lastIndexOf

public int lastIndexOf(int codePoint,
                       int startIndex)

lastIndexOf

public int lastIndexOf(String str)

lastIndexOf

public int lastIndexOf(String str,
                       int start)

length

public int length()

Specified by:

length in interface CharSequence

matches

public boolean matches(String regex)

Regular expressions vary from the standard implementation. The regex parameter is interpreted by JavaScript as a JavaScript regular expression. For consistency, use only the subset of regular expression syntax common to both Java and JavaScript. TODO(jat): properly handle Java regex syntax

offsetByCodePoints

public int offsetByCodePoints(int index,
                              int codePointOffset)

regionMatches

public boolean regionMatches(boolean ignoreCase,
                             int toffset,
                             String other,
                             int ooffset,
                             int len)

regionMatches

public boolean regionMatches(int toffset,
                             String other,
                             int ooffset,
                             int len)

replace

public String replace(char from,
                      char to)

replace

public String replace(CharSequence from,
                      CharSequence to)

replaceAll

public String replaceAll(String regex,
                         String replace)

Regular expressions vary from the standard implementation. The regex parameter is interpreted by JavaScript as a JavaScript regular expression. For consistency, use only the subset of regular expression syntax common to both Java and JavaScript. TODO(jat): properly handle Java regex syntax

replaceFirst

public String replaceFirst(String regex,
                           String replace)

Regular expressions vary from the standard implementation. The regex parameter is interpreted by JavaScript as a JavaScript regular expression. For consistency, use only the subset of regular expression syntax common to both Java and JavaScript. TODO(jat): properly handle Java regex syntax

split

public String[] split(String regex)

Regular expressions vary from the standard implementation. The regex parameter is interpreted by JavaScript as a JavaScript regular expression. For consistency, use only the subset of regular expression syntax common to both Java and JavaScript.

split

public String[] split(String regex,
                      int maxMatch)

Regular expressions vary from the standard implementation. The regex parameter is interpreted by JavaScript as a JavaScript regular expression. For consistency, use only the subset of regular expression syntax common to both Java and JavaScript. TODO(jat): properly handle Java regex syntax

startsWith

public boolean startsWith(String prefix)

startsWith

public boolean startsWith(String prefix,
                          int toffset)

subSequence

public CharSequence subSequence(int beginIndex,
                                int endIndex)

Specified by:

subSequence in interface CharSequence

substring

public String substring(int beginIndex)

substring

public String substring(int beginIndex,
                        int endIndex)

toCharArray

public char[] toCharArray()

toLowerCase

public String toLowerCase()

Transforms the String to lower-case in a locale insensitive way.

Unlike JRE, we don't do locale specific transformation by default. That is backward compatible for GWT and in most of the cases that is what the developer actually wants. If you want to make a transformation based on native locale of the browser, you can do toLowerCase(Locale.getDefault()) instead.

toLowerCase

public String toLowerCase(Locale locale)

If provided locale is Locale.getDefault(), uses javascript's toLocaleLowerCase to do a locale specific transformation. Otherwise, it will fallback to toLowerCase which performs the right thing for the limited set of Locale's predefined in GWT Locale emulation.

toUpperCase

public String toUpperCase()

toUpperCase

public String toUpperCase(Locale locale)

toString

public String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class Object

trim

public String trim()