Класс StringTokenizer
- Все реализуемые интерфейсы:
Enumeration<Object>
public class StringTokenizer extends Object implements Enumeration<Object>
StreamTokenizer. Методы StringTokenizer не различают идентификаторы, числа и строки в кавычках, а также не распознают и не пропускают комментарии. Набор разделителей (символов, которые отделяют токены) можно указать при создании объекта или отдельно для каждого токена.
Экземпляр StringTokenizer работает одним из двух способов в зависимости от того, был ли он создан с флагом returnDelims, имеющим значение true или false:
- Если флаг имеет значение
false, символы-разделители служат для разделения токенов. Токен — это максимальная последовательность подряд идущих символов, не являющихся разделителями. - Если флаг имеет значение
true, символы-разделители сами считаются токенами. Таким образом, токеном является либо один символ-разделитель, либо максимальная последовательность подряд идущих символов, не являющихся разделителями.
Объект StringTokenizer внутренне хранит текущую позицию в разбираемой строке. Некоторые операции перемещают эту позицию за обработанные символы.
Токен возвращается путем извлечения подстроки из строки, которая использовалась для создания объекта StringTokenizer.
Ниже приведен пример использования токенизатора. Код:
StringTokenizer st = new StringTokenizer("this is a test");
while (st.hasMoreTokens()) {
System.out.println(st.nextToken());
}
выводит следующий результат:
this
is
a
test
StringTokenizer — устаревший класс, сохраненный для обеспечения совместимости, хотя его использование в новом коде не рекомендуется. Тем, кому требуется эта функциональность, рекомендуется использовать метод split класса String или пакет java.util.regex.
В следующем примере показано, как метод String.split можно использовать для разбиения строки на базовые токены:
String[] result = "this is a test".split("\\s");
for (String r : result)
System.out.println(r);
выводит следующий результат:
this
is
a
test
- Начиная с:
- 1.0
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
StringTokenizer |
Создает токенизатор строк для указанной строки. |
StringTokenizer |
Создает токенизатор строк для указанной строки. |
StringTokenizer |
Создает токенизатор строк для указанной строки. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
countTokens() |
Вычисляет, сколько раз можно вызвать метод nextToken этого токенизатора, прежде чем он вызовет исключение. |
boolean |
hasMoreElements() |
Возвращает то же значение, что и метод hasMoreTokens. |
boolean |
hasMoreTokens() |
Проверяет, есть ли в строке этого токенизатора еще доступные токены. |
Object |
nextElement() |
Возвращает то же значение, что и метод nextToken, но объявленный тип возвращаемого значения — Object, а не String. |
String |
nextToken() |
Возвращает следующий токен этого токенизатора строк. |
String |
nextToken |
Возвращает следующий токен в строке этого токенизатора. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Определяет, «равен ли» этот объект другому объекту. |
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого объекта Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Методы, объявленные в интерфейсе Enumeration
asIterator | Модификатор и тип | Метод | Описание |
|---|---|---|
default Iterator |
asIterator() |
Возвращает Iterator, перебирающий оставшиеся элементы, охватываемые этим перечислением. |
Подробное описание конструкторов
StringTokenizer
public StringTokenizer(String str, String delim, boolean returnDelims)
delim являются разделителями, разделяющими токены. Если флаг returnDelims имеет значение true, символы-разделители также возвращаются как токены. Каждый разделитель возвращается в виде строки, состоящей из одной кодовой точки Unicode этого разделителя (которая может занимать одну или две char). Если флаг имеет значение false, символы-разделители пропускаются и служат только для разделения токенов.
Обратите внимание: если delim имеет значение null, этот конструктор не выбрасывает исключение. Однако попытка вызвать другие методы полученного объекта StringTokenizer может привести к NullPointerException.
- Параметры:
-
str— строка для разбора. -
delim— разделители. -
returnDelims— флаг, указывающий, следует ли возвращать разделители в качестве токенов. - Выбрасывает:
-
NullPointerException— если str имеет значениеnull
StringTokenizer
public StringTokenizer(String str, String delim)
delim являются разделителями, разделяющими токены. Символы-разделители сами не считаются токенами. Обратите внимание: если delim имеет значение null, этот конструктор не выбрасывает исключение. Однако попытка вызвать другие методы полученного объекта StringTokenizer может привести к NullPointerException.
- Параметры:
-
str— строка для разбора. -
delim— разделители. - Выбрасывает:
-
NullPointerException— если str имеет значениеnull
StringTokenizer
public StringTokenizer(String str)
" \t\n\r\f": пробел, табуляция, символ новой строки, возврат каретки и перевод страницы. Символы-разделители сами не считаются токенами.- Параметры:
-
str— строка для разбора. - Выбрасывает:
-
NullPointerException— если str имеет значениеnull
Подробное описание методов
hasMoreTokens
public boolean hasMoreTokens()
true, последующий вызов nextToken без аргументов успешно вернет токен.- Возвращает:
-
trueтогда и только тогда, когда после текущей позиции в строке остался хотя бы один токен; в противном случае —false.
nextToken
public String nextToken()
- Возвращает:
- следующий токен этого токенизатора строк.
- Выбрасывает:
-
NoSuchElementException— если в строке этого токенизатора больше нет токенов.
nextToken
public String nextToken(String delim)
StringTokenizer, заменяется символами строки delim. Затем возвращается следующий токен строки после текущей позиции. Текущая позиция перемещается за распознанный токен. После этого вызова новый набор разделителей остается набором по умолчанию.- Параметры:
-
delim— новые разделители. - Возвращает:
- следующий токен после переключения на новый набор разделителей.
- Выбрасывает:
-
NoSuchElementException— если в строке этого токенизатора больше нет токенов. -
NullPointerException— если delim имеет значениеnull
hasMoreElements
public boolean hasMoreElements()
hasMoreTokens. Этот метод существует для того, чтобы данный класс мог реализовать интерфейс Enumeration.- Определено в:
-
hasMoreElementsв интерфейсеEnumeration<Object> - Возвращает:
-
true, если есть еще токены; в противном случае —false. - См. также:
nextElement
public Object nextElement()
nextToken, но объявленный тип возвращаемого значения — Object, а не String. Этот метод существует для того, чтобы данный класс мог реализовать интерфейс Enumeration.- Определено в:
-
nextElementв интерфейсеEnumeration<Object> - Возвращает:
- следующий токен в строке.
- Выбрасывает:
-
NoSuchElementException— если в строке этого токенизатора больше нет токенов. - См. также:
countTokens
public int countTokens()
nextToken этого токенизатора, прежде чем он вызовет исключение. Текущая позиция не изменяется.- Возвращает:
- число токенов, оставшихся в строке при текущем наборе разделителей.
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.