Chapter 8
The String Class
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
java.lang.String
+String()
Constructs an empty string
+String(value: String)
Constructs a string with the specified string literal value
+String(value: char[])
Constructs a string with the specified character array
+charAt(index: int): char
Returns the character at the specified index from this string
+compareTo(anotherString: String): int
Compares this string with another string
+compareToIgnoreCase(anotherString: String): int Compares this string with another string ignoring case
+concat(anotherString: String): String
Concat this string with another string
+endsWith(suffix: String): boolean
Returns true if this string ends with the specified suffix
+equals(anotherString: String): boolean
Returns true if this string is equal to anther string
+equalsIgnoreCase(anotherString: String): boolean Checks if this string equals anther string ignoring case
+getChars(int srcBegin, int srcEnd, char[] dst, int Copies characters from this string into the destination character
dstBegin): void
array
+indexOf(ch: int): int
Returns the index of the first occurrence of ch
+indexOf(ch: int, fromIndex: int): int
Returns the index of the first occurrence of ch after fromIndex
+indexOf(str: String): int
Returns the index of the first occurrence of str
+indexOf(str: String, fromIndex: int): int
Returns the index of the first occurrence of str after fromIndex
+lastIndexOf(ch: int): int
Returns the index of the last occurrence of ch
+lastIndexOf(ch: int, fromIndex: int): int
Returns the index of the last occurrence of ch before fromIndex
+lastIndexOf(str: String): int
Returns the index of the last occurrence of str
+lastIndexOf(str: String, fromIndex: int): int
Returns the index of the last occurrence of str before fromIndex
+regionMatches(toffset: int, other: String, offset:
int, len: int): boolean
Returns true if the specified subregion of this string exactly
matches the specified subregion of the string argument
+length(): int
Returns the number of characters in this string
+replace(oldChar: char, newChar: char): String
Returns a new string with oldChar replaced by newChar
+startsWith(prefix: String): boolean
Returns true if this string starts with the specified prefix
+subString(beginIndex: int): String
Returns the substring from beginIndex
+subString(beginIndex: int, endIndex: int): String
Returns the substring from beginIndex to endIndex-1.
+toCharArray(): char[]
Returns a char array consisting characters from this string
+toLowerCase(): String
Returns a new string with all characters converted to lowercase
+toString(): String
Returns a new string with itself
+toUpperCase(): String
Returns a new string with all characters converted to uppercase
+trim(): String
Returns a string with blank characters trimmed on both sides
+copyValueOf(data: char[]): String
Returns a new string consisting of the char array data
+valueOf(c: char): String
Returns a string consisting of the character c
+valueOf(data: char[]): String
Same as copyValueOf(data: char[]): String
+valueOf(d: double): String
Returns a string representing the double value
+valueOf(f: float): String
Returns a string representing the float value
int): String
Liang,+valueOf(i:
Introduction
to Java
hts
Returns
a string
representing
the int value
Programming, Sixth
Edition,
(c)
2007 Pearson
Education, Inc. All rig
+valueOf(l:0-13-222158-6
long): String
reserved.
Returns a string representing the long value
Constructing Strings
String newString = new String(stringLiteral);
String message = new String("Welcome to Java");
String message = new String();
char[] charArray = {g, o, o, d};
String message = new String(charArray);
Since strings are used frequently, Java provides a shorthand initializer for creating a
string:
String message = "Welcome to Java";
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
Strings Are Immutable
A String object is immutable; its contents cannot be changed.
Does the following code change the contents of the string?
String s = "Java";
s = "HTML";
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
animation
Trace Code
String s = "Java";
s = "HTML";
After executing s = "HTML";
After executing String s = "Java";
s
: String
String object for "Java"
Contents cannot be changed
: String
String object for "Java"
This string object is
now unreferenced
: String
String object for "HTML"
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
animation
Trace Code
String s = "Java";
s = "HTML";
After executing s = "HTML";
After executing String s = "Java";
s
: String
String object for "Java"
Contents cannot be changed
: String
String object for "Java"
This string object is
now unreferenced
: String
String object for "HTML"
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
Finding String Length
Finding string length using the length()
method:
message = "Welcome";
message.length() (returns 7)
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
Retrieving Individual Characters
in a String
Do not use message[0]
Use message.charAt(index)
Index starts from 0
Indices
message
message.charAt(0)
message.length() is 15
10 11 12 13 14
J
message.charAt(14)
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
String Concatenation
String s3 = s1.concat(s2);
String s3 = s1 + s2;
s1 + s2 + s3 + s4 + s5 same as
(((s1.concat(s2)).concat(s3)).concat(s4)).concat(s5);
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
Extracting Substrings
You can extract a single character from a string using the
charAt method. You can also extract a substring from a
string using the substring method in the String class.
String s1 = "Welcome to Java";
String s2 = s1.substring(0, 11) + "HTML";
Indices
message
message.substring(0, 11)
10 11 12 13 14
J
message.substring(11)
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
10
String Comparisons
equals
String s1 = new String("Welcome);
String s2 = "welcome";
if (s1.equals(s2)){
// s1 and s2 have the same contents
}
if (s1 == s2) {
// s1 and s2 have the same reference
}
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
11
String Comparisons, cont.
compareTo(Object object)
String s1 = new String("Welcome);
String s2 = "welcome";
if (s1.compareTo(s2) > 0) {
// s1 is greater than s2
}
else if (s1.compareTo(s2) == 0) {
// s1 and s2 have the same contents
}
else
// s1 is less than s2
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
12
String Conversions
The contents of a string cannot be changed once
the string is created. But you can convert a string
to a new string using the following methods:
toLowerCase
Welcome.toLowerCase() -> welcome
toUpperCase
Welcome.toUpperCase() -> WELCOME
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
13
Trim
Welcome.trim() -> Welcome
replace(oldChar, newChar)
Welcome.replace(e, A) -> WAlcomA
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
14
Finding a Character or a
Substring in a String
"Welcome
"Welcome
"Welcome
"Welcome
"Welcome
"Welcome
"Welcome
to
to
to
to
to
to
to
Java".indexOf('W')returns 0.
Java".indexOf('x')returns -1.
Java".indexOf('o', 5)returns 9.
Java".indexOf("come")returns 3.
Java".indexOf("Java", 5)returns 11.
Java".indexOf("java", 5)returns -1.
Java".lastIndexOf('a')returns 14.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
15
Convert Character and Numbers
to Strings
The String class provides several static valueOf
methods for converting a character, an array of
characters, and numeric values to strings. These
methods have the same name valueOf with
different argument types char, char[], double, long,
int, and float. For example, to convert a double
value to a string, use String.valueOf(5.44). The
return value is string consists of characters 5, .,
4, and 4.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
16
Example:
Finding Palindromes
Objective:
Checking whether a string
is a palindrome: a string that reads the
same forward and backward.
CheckPalindrome
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
17
The Character Class
java.lang.Character
+Character(value: char)
Constructs a character object with char value
+charValue(): char
Returns the char value from this object
+compareTo(anotherCharacter: Character): int
Compares this character with another
+equals(anotherCharacter: Character): boolean Returns true if this character equals to another
+isDigit(ch: char): boolean
Returns true if the specified character is a digit
+isLetter(ch: char): boolean
Returns true if the specified character is a letter
+isLetterOrDigit(ch: char): boolean
Returns true if the character is a letter or a digit
+isLowerCase(ch: char): boolean
Returns true if the character is a lowercase letter
+isUpperCase(ch: char): boolean
Returns true if the character is an uppercase letter
+toLowerCase(ch: char): char
Returns the lowercase of the specified character
+toUpperCase(ch: char): char
Returns the uppercase of the specified character
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
18
Examples
Character charObject = new Character('b');
charObject.compareTo(new Character('a')) returns 1
charObject.compareTo(new Character('b')) returns 0
charObject.compareTo(new Character('c')) returns -1
charObject.compareTo(new Character('d') returns 2
charObject.equals(new Character('b')) returns true
charObject.equals(new Character('d')) returns false
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
19
Example: Counting Each Letter
in a String
This example gives a program that counts the
number of occurrence of each letter in a string.
Assume the letters are not case-sensitive.
CountEachLetter
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
20
The StringBuffer Class
The StringBuffer class is an alternative to the
String class. In general, a string buffer can be
used wherever a string is used.
StringBuffer is more flexible than String.
You can add, insert, or append new contents
into a string buffer. However, the value of
a String object is fixed once the string is created.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
21
java.lang.StringBuffer
+StringBuffer()
Constructs an empty string buffer with capacity 16
+StringBuffer(capacity: int)
Constructs a string buffer with the specified capacity
+StringBuffer(str: String)
Constructs a string buffer with the specified string
+append(data: char[]): StringBuffer
Appends a char array into this string buffer
+append(data: char[], offset: int, len: int): StringBuffer
Appends a subarray in data into this string buffer
+append(v: aPrimitiveType): StringBuffer
Appends a primitive type value as string to this buffer
+append(str: String): StringBuffer
Appends a string to this string buffer
+capacity(): int
Returns the capacity of this string buffer
+charAt(index: int): char
Returns the character at the specified index
+delete(startIndex: int, endIndex: int): StringBuffer
Deletes characters from startIndex to endIndex
+deleteCharAt(int index): StringBuffer
Deletes a character at the specified index
+insert(index: int, data: char[], offset: int, len: int):
StringBuffer
Inserts a subarray of the data in the array to the buffer at
the specified index
+insert(offset: int, data: char[]): StringBuffer
Inserts data to this buffer at the position offset
+insert(offset: int, b: aPrimitiveType): StringBuffer
Inserts a value converted to string into this buffer
+insert(offset: int, str: String): StringBuffer
Inserts a string into this buffer at the position offset
+length(): int
Returns the number of characters in this buffer
+replace(int startIndex, int endIndex, String str):
StringBuffer
Replaces the characters in this buffer from startIndex to
endIndex with the specified string
+reverse(): StringBuffer
Reveres the characters in the buffer
+setCharAt(index: int, ch: char): void
Sets a new character at the specified index in this buffer
+setLength(newLength: int): void
Sets a new length in this buffer
+substring(startIndex: int): String
Returns a substring starting at startIndex
Liang, Introduction
to Java Programming,
(c) 2007
Pearson Education,
Inc. All rig
+substring(startIndex:
int, endIndex:
int): String Sixth Edition,
Returns
a substring
from startIndex
to endIndex
hts reserved. 0-13-222158-6
22
StringBuffer Constructors
public StringBuffer()
No characters, initial capacity 16 characters.
public StringBuffer(int length)
No characters, initial capacity specified by the length
argument.
public StringBuffer(String str)
Represents the same sequence of characters
as the string argument. Initial capacity 16
plus the length of the string argument.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
23
Appending New Contents
into a String Buffer
StringBuffer strBuf = new StringBuffer();
strBuf.append("Welcome");
strBuf.append(' ');
strBuf.append("to");
strBuf.append(' ');
strBuf.append("Java");
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
24
Main Method Is Just a Regular Method
You can call a regular method by passing actual
parameters. Can you pass arguments to main? Of
course, yes. For example, the main method in class
B is invoked by a method in A, as shown below:
public class A {
public static void main(String[] args) {
String[] strings = {"New York",
"Boston", "Atlanta"};
B.main(strings);
}
}
class B {
public static void main(String[] args) {
for (int i = 0; i < args.length; i++)
System.out.println(args[i]);
}
}
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
25
Optional
Matching Strings
"Java".matches("Java");
"Java".equals("Java");
"Java is fun".matches("Java.*")
"Java is cool".matches("Java.*")
"Java is powerful".matches("Java.*")
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
26
Text I/O
This section introduces how to read/write strings
and numeric values from/to a text file using the
Scanner and PrintWriter classes.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
27
Writing Data Using PrintWriter
WriteData
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
28
Reading Data Using Scanner
java.util.Scanner
+Scanner(source: File)
Creates a Scanner that produces values scanned from the specified file.
+Scanner(source: String)
Creates a Scanner that produces values scanned from the specified string.
+close()
Closes this scanner.
Returns true if this scanner has another token in its input.
+hasNext(): boolean
Returns next token as a string.
+next(): String
+nextByte(): byte
+nextShort(): short
+nextInt(): int
+nextLong(): long
+nextFloat(): float
+nextDouble(): double
+useDelimiter(pattern: String):
Scanner
Returns next token as a byte.
Returns next token as a short.
Returns next token as an int.
Returns next token as a long.
Returns next token as a float.
Returns next token as a double.
Sets this scanners delimiting pattern.
ReadData
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
29
The StringTokenizer Class
java.util.StringTokenizer
+StringTokenizer(s: String)
Constructs a string tokenizer for the string.
+StringTokenizer(s: String, delimiters: Constructs a string tokenizer for the string
with the specified delimiters.
String)
+StringTokenizer(s: String, delimiters: Constructs a string tokenizer for the string
with the delimiters and returnDelims.
String, returnDelimiters: boolean)
Returns the number of remaining tokens.
+countTokens(): int
+hasMoreTokens(): boolean
Returns true if there are more tokens left.
+nextToken(): String
Returns the next token.
+nextToken(delimiters: String): String Returns the next token using new delimiters.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
30
Examples 1
String s = "Java is cool.";
StringTokenizer tokenizer = new StringTokenizer(s);
System.out.println("The total number of tokens is " +
tokenizer.countTokens());
while (tokenizer.hasMoreTokens())
System.out.println(tokenizer.nextToken());
The code displays
The total number of tokens is 3
Java
is
cool.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
31
Examples 2
String s = "Java is cool.";
StringTokenizer tokenizer = new StringTokenizer(s, "ac");
System.out.println("The total number of tokens is " +
tokenizer.countTokens());
while (tokenizer.hasMoreTokens())
System.out.println(tokenizer.nextToken());
The code displays
The total number of tokens is 4
J
v
is
ool.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
32
Examples 3
String s = "Java is cool.";
StringTokenizer tokenizer = new StringTokenizer(s, "ac", true);
System.out.println("The total number of tokens is " +
tokenizer.countTokens());
while (tokenizer.hasMoreTokens())
System.out.println(tokenizer.nextToken());
The code displays
The total number of tokens is 7
J
a
v
a
is
c
ool.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
33
No no-arg Constructor in
StringTokenizer
The StringTokenizer class does not have a no-arg
constructor. Normally it is a good programming
practice to provide a no-arg constructor for each
class. On rare occasions, however, a no-arg
constructor does not make sense. StringTokenizer
is such an example. A StringTokenizer object
must be created for a string, which should be
passed as an argument from a constructor.
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
34
JDK 1.5
Feature
The Scanner Class
The delimiters are single characters in StringTokenizer. You can use the
new JDK 1.5 java.util.Scanner class to specify a word as a delimiter.
String s = "Welcome to Java! Java is fun! Java is cool!";
Scanner scanner = new Scanner(s);
scanner.useDelimiter("Java");
Creates an instance of Scanner for the
string.
Sets Java as a delimiter.
while (scanner.hasNext())
System.out.println(scanner.next());
hasNext() returns true if there are
still more tokens left.
The next() method returns a token as a
string.
Welcome to
!
is fun!
is cool!
Output
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
35
JDK 1.5
Feature
Scanning Primitive Type Values
If a token is a primitive data type value, you can use the methods nextByte(),
nextShort(), nextInt(), nextLong(), nextFloat(), nextDouble(), or nextBoolean() to
obtain it. For example, the following code adds all numbers in the string. Note
that the delimiter is space by default.
String s = "1 2 3 4";
Scanner scanner = new Scanner(s);
int sum = 0;
while (scanner.hasNext())
sum += scanner.nextInt();
System.out.println("Sum is " + sum);
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
36
JDK 1.5
Feature
Console Input Using Scanner
Another important application of the Scanner class is to read input
from the console. For example, the following code reads an int value
from the keyboard:
System.out.print("Please enter an int value: ");
Scanner scanner = new Scanner(System.in);
int i = scanner.nextInt();
Liang, Introduction to Java Programming, Sixth Edition, (c) 2007 Pearson Education, Inc. All rig
hts reserved. 0-13-222158-6
37
