/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package java.util;
/**
* Breaks a string into tokens; new code should probably use {@link String#split}.
*
* <blockquote>
* <pre>
* // Legacy code:
* StringTokenizer st = new StringTokenizer("a:b:c", ":");
* while (st.hasMoreTokens()) {
* System.err.println(st.nextToken());
* }
*
* // New code:
* for (String token : "a:b:c".split(":")) {
* System.err.println(token);
* }
* </pre>
* </blockquote>
*
* @since 1.0
*/
public class StringTokenizer implements Enumeration<Object> {
private String string;
private String delimiters;
private boolean returnDelimiters;
private int position;
/**
* Constructs a new {@code StringTokenizer} for the parameter string using
* whitespace as the delimiter. The {@code returnDelimiters} flag is set to
* {@code false}.
*
* @param string
* the string to be tokenized.
*/
public StringTokenizer(String string) {
this(string, " \t\n\r\f", false);
}
/**
* Constructs a new {@code StringTokenizer} for the parameter string using
* the specified delimiters. The {@code returnDelimiters} flag is set to
* {@code false}. If {@code delimiters} is {@code null}, this constructor
* doesn't throw an {@code Exception}, but later calls to some methods might
* throw a {@code NullPointerException}.
*
* @param string
* the string to be tokenized.
* @param delimiters
* the delimiters to use.
*/
public StringTokenizer(String string, String delimiters) {
this(string, delimiters, false);
}
/**
* Constructs a new {@code StringTokenizer} for the parameter string using
* the specified delimiters, returning the delimiters as tokens if the
* parameter {@code returnDelimiters} is {@code true}. If {@code delimiters}
* is null this constructor doesn't throw an {@code Exception}, but later
* calls to some methods might throw a {@code NullPointerException}.
*
* @param string
* the string to be tokenized.
* @param delimiters
* the delimiters to use.
* @param returnDelimiters
* {@code true} to return each delimiter as a token.
*/
public StringTokenizer(String string, String delimiters,
boolean returnDelimiters) {
if (string == null) {
throw new NullPointerException("string == null");
}
this.string = string;
this.delimiters = delimiters;
this.returnDelimiters = returnDelimiters;
this.position = 0;
}
/**
* Returns the number of unprocessed tokens remaining in the string.
*
* @return number of tokens that can be retreived before an {@code
* Exception} will result from a call to {@code nextToken()}.
*/
public int countTokens() {
int count = 0;
boolean inToken = false;
for (int i = position, length = string.length(); i < length; i++) {
if (delimiters.indexOf(string.charAt(i), 0) >= 0) {
if (returnDelimiters)
count++;
if (inToken) {
count++;
inToken = false;
}
} else {
inToken = true;
}
}
if (inToken)
count++;
return count;
}
/**
* Returns {@code true} if unprocessed tokens remain. This method is
* implemented in order to satisfy the {@code Enumeration} interface.
*
* @return {@code true} if unprocessed tokens remain.
*/
public boolean hasMoreElements() {
return hasMoreTokens();
}
/**
* Returns {@code true} if unprocessed tokens remain.
*
* @return {@code true} if unprocessed tokens remain.
*/
public boolean hasMoreTokens() {
if (delimiters == null) {
throw new NullPointerException("delimiters == null");
}
int length = string.length();
if (position < length) {
if (returnDelimiters)
return true; // there is at least one character and even if
// it is a delimiter it is a token
// otherwise find a character which is not a delimiter
for (int i = position; i < length; i++)
if (delimiters.indexOf(string.charAt(i), 0) == -1)
return true;
}
return false;
}
/**
* Returns the next token in the string as an {@code Object}. This method is
* implemented in order to satisfy the {@code Enumeration} interface.
*
* @return next token in the string as an {@code Object}
* @throws NoSuchElementException
* if no tokens remain.
*/
public Object nextElement() {
return nextToken();
}
/**
* Returns the next token in the string as a {@code String}.
*
* @return next token in the string as a {@code String}.
* @throws NoSuchElementException
* if no tokens remain.
*/
public String nextToken() {
if (delimiters == null) {
throw new NullPointerException("delimiters == null");
}
int i = position;
int length = string.length();
if (i < length) {
if (returnDelimiters) {
if (delimiters.indexOf(string.charAt(position), 0) >= 0)
return String.valueOf(string.charAt(position++));
for (position++; position < length; position++)
if (delimiters.indexOf(string.charAt(position), 0) >= 0)
return string.substring(i, position);
return string.substring(i);
}
while (i < length && delimiters.indexOf(string.charAt(i), 0) >= 0)
i++;
position = i;
if (i < length) {
for (position++; position < length; position++)
if (delimiters.indexOf(string.charAt(position), 0) >= 0)
return string.substring(i, position);
return string.substring(i);
}
}
throw new NoSuchElementException();
}
/**
* Returns the next token in the string as a {@code String}. The delimiters
* used are changed to the specified delimiters.
*
* @param delims
* the new delimiters to use.
* @return next token in the string as a {@code String}.
* @throws NoSuchElementException
* if no tokens remain.
*/
public String nextToken(String delims) {
this.delimiters = delims;
return nextToken();
}
}