Spec-Zone.ru › OpenJDK 27

Класс StringTokenizer

java.lang.Object
java.util.StringTokenizer
Все реализуемые интерфейсы:
Enumeration<Object>
public class StringTokenizer extends Object implements Enumeration<Object>
Класс StringTokenizer позволяет приложению разбивать строку на токены. Метод токенизации намного проще, чем используемый классом 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
См. также:
  • StreamTokenizer

Краткое описание конструкторов

Конструктор Описание
StringTokenizer(String str)
Создает токенизатор строк для указанной строки.
StringTokenizer(String str, String delim)
Создает токенизатор строк для указанной строки.
StringTokenizer(String str, String delim, boolean returnDelims)
Создает токенизатор строк для указанной строки.

Краткое описание методов

Модификатор и тип Метод Описание
int countTokens()
Вычисляет, сколько раз можно вызвать метод nextToken этого токенизатора, прежде чем он вызовет исключение.
boolean hasMoreElements()
Возвращает то же значение, что и метод hasMoreTokens.
boolean hasMoreTokens()
Проверяет, есть ли в строке этого токенизатора еще доступные токены.
Object nextElement()
Возвращает то же значение, что и метод nextToken, но объявленный тип возвращаемого значения — Object, а не String.
String nextToken()
Возвращает следующий токен этого токенизатора строк.
String nextToken(String delim)
Возвращает следующий токен в строке этого токенизатора.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Определяет, «равен ли» этот объект другому объекту.
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(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе Enumeration

asIterator
Модификатор и тип Метод Описание
default Iterator<Object> 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.
См. также:
  • Enumeration
  • hasMoreTokens()

nextElement

public Object nextElement()
Возвращает то же значение, что и метод nextToken, но объявленный тип возвращаемого значения — Object, а не String. Этот метод существует для того, чтобы данный класс мог реализовать интерфейс Enumeration.
Определено в:
nextElement в интерфейсе Enumeration<Object>
Возвращает:
следующий токен в строке.
Выбрасывает:
NoSuchElementException — если в строке этого токенизатора больше нет токенов.
См. также:
  • Enumeration
  • nextToken()

countTokens

public int countTokens()
Вычисляет, сколько раз можно вызвать метод nextToken этого токенизатора, прежде чем он вызовет исключение. Текущая позиция не изменяется.
Возвращает:
число токенов, оставшихся в строке при текущем наборе разделителей.
См. также:
  • nextToken()

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API