THE PACKAGE JAVA.LANG

java.lang.String

20.12

20.12.36

public String toUpperCase()

If this

String

 object does not contain any character that is mapped to a different

character by the method

Character.toUpperCase

 ( 20.5.21), then a reference

to this

String

 object is returned. Otherwise, this method creates a new

String

object representing a character sequence identical in length to the character

sequence represented by this

String

 object and with every character equal to the

result of applying the method

Character.toUpperCase

 to the corresponding

character of this

String

 object.

Examples:

"Fahrvergn gen".toUpperCase()

returns

 "FAHRVERGNUGEN"

"Visit Ljubinje!".toUpperCase()

returns

 "VISIT LJUBINJE!"

20.12.37

public String trim()

If this

String

 object represents an empty character sequence, or the first and last

characters of character sequence represented by this

String

 object both have

codes greater than

\u0020

 (the space character), then a reference to this

String

object is returned.

Otherwise, if there is no character with a code greater than

\u0020

 in the

string, then a new

String

 object representing an empty string is created and

returned.

Otherwise, let

k

 be the index of the first character in the string whose code is

greater than

\u0020

, and let

m

 be the index of the last character in the string

whose code is greater than

\u0020

. A new

String

 object is created, representing

the substring of this string that begins with the character at index

k

 and ends with

the character at index

m

 that is, the result of

this.substring(k, m+1)

.

This method may be used to trim whitespace ( 20.5.19) from the beginning

and end of a string; in fact, it trims all ASCII control characters as well.

20.12.38

public static String valueOf(Object obj)

If the argument is

null

, then a string equal to

"null"

 is returned. Otherwise, the

value of

obj.toString()

 is returned. See the

toString

 method ( 20.1.2).

545