java.util

Класс StringTokenizer

java.lang. Объект

java.util. StringTokenizer

Все Реализованные Интерфейсы:

Перечисление <Объект>

public class StringTokenizer
extends Object
implements Enumeration<Object>

Строковый класс токенизатора позволяет приложению повреждать строку в маркеры. tokenization метод намного более прост чем тот, используемый 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 (int x=0; x<result.length; x++)
         System.out.println(result[x]);
 

печатает следующий вывод:

     this
     is
     a
     test
 

С тех пор:

JDK1.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() Тесты, если есть больше маркеров, доступных от строки этого токенизатора.
Объект	nextElement() Возвращает то же самое значение как nextToken метод, за исключением того, что его объявленное возвращаемое значение Object вместо String.
Строка	nextToken() Возвращает следующий маркер из этого строкового токенизатора.
Строка	nextToken(String delim) Возвращает следующий маркер в этой строковой строке токенизатора.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

StringTokenizer

public StringTokenizer(String str,
               String delim,
               boolean returnDelims)

Создает строковый токенизатор для указанной строки. Все символы в delim параметром являются разделители для того, чтобы разделить маркеры.

Если returnDelims флаг true, тогда символы-разделители также возвращаются как маркеры. Каждый разделитель возвращается как строка длины один. Если флаг 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()