Package token

Classe StringTokenizer

Classes de ce package :

Packages - Hiérarchie - Index - Constantes et fonctions

Ascendants


Object
  |
  +--- StringTokenizer

Description


La classe StringTokenizer permet à une application de découper une chaine de caractères en sous-chaines, en se basant sur une série de délimiteurs.

L'ensemble des délimiteurs (les caractères qui séparent les éléments) peut etre redéfini à tout moment.


Aperçu des attributs


_delims L'ensemble des délimiteurs-éléments (caractères de séparation, renvoyés à l'application appelante).
_extracter Objet servant à extraire les sous-chaines résultat.
_index Le pointeur courant sur la chaine.
_line Numéro de la ligne actuellement décodée.
_neutralDelims L'ensemble des délimiteurs neutres (caractères ignorés et non renvoyés à l'application appelante).
_newLine Indique si au moins un saut de ligne est apparu lors de l'acquisition du dernier élément obtenu.
_str La chaine qui est en train d'etre découpée.
_strLength La longueur totale de la chaine.


Aperçu des méthodes


countTokens Retourne le nombre d'éléments restant à lire dans la chaine source.
delete Destructeur de la classe.
getCurrentLine Retourne le numéro de la ligne actuellement en cours de traitement.
hasChangedLine Indique si un au moins un retour à eu lieu lors de la dernière exraction de sous-chaine.
hasMoreTokens Teste s'il existe au moins une sous-chaine disponible à lire dans la chaine.
new Construit un StringTokenizer pour la chaine spécifiée.
nextToken Retourne la sous-chaine decodée suivante.
nextTokenDelim Retourne l'élément suivant lu depuis la chaine, en se basant temporairement sur les délimiteurs passés en paramètre.
setDelims Remplace les délimiteurs précédemment affectés par des nouveaux.
setNeutralDelims Remplace les délimiteurs neutres précédemment affectés par des nouveaux.
setString Change la chaine produisant les éléments.


Référence des attributs


_delims

string _delims;

L'ensemble des délimiteurs-éléments (caractères de séparation, renvoyés à l'application appelante).

_extracter

StringConv _extracter;

Objet servant à extraire les sous-chaines résultat.

_index

int _index;

Le pointeur courant sur la chaine.

_line

int _line;

Numéro de la ligne actuellement décodée.

_neutralDelims

string _neutralDelims;

L'ensemble des délimiteurs neutres (caractères ignorés et non renvoyés à l'application appelante).

_newLine

bool _newLine;

Indique si au moins un saut de ligne est apparu lors de l'acquisition du dernier élément obtenu.

_str

string _str;

La chaine qui est en train d'etre découpée.

_strLength

int _strLength;

La longueur totale de la chaine.


Référence des méthodes


countTokens

int countTokens();

Retourne le nombre d'éléments restant à lire dans la chaine source.

Valeur de retour
le nombre d'éléments restant à lire, ou 0 s'il n'en reste plus

delete

void delete();

Destructeur de la classe.

getCurrentLine

int getCurrentLine();

Retourne le numéro de la ligne actuellement en cours de traitement.

Valeur de retour
le numéro de ligne (la première ligne a le numéro 1)

hasChangedLine

bool hasChangedLine();

Indique si un au moins un retour à eu lieu lors de la dernière exraction de sous-chaine.

Valeur de retour
true si au moins un retour à la ligne a eu lieu, false sinon

hasMoreTokens

bool hasMoreTokens();

Teste s'il existe au moins une sous-chaine disponible à lire dans la chaine.

Valeur de retour
true s'il existe des éléments supplémentaires à lire, false sinon.

new

void new(string str);

Construit un StringTokenizer pour la chaine spécifiée. Les caractères espace, retour chariot, nouvelle ligne et tabulation sont les délimiteurs par défaut séparant les éléments.

Paramètres
str - la chaine à décoder

nextToken

string nextToken();

Retourne la sous-chaine decodée suivante.

Valeur de retour
la sous-chaine, ou une chaine vide si plus rien n'est à lire.

nextTokenDelim

string nextTokenDelim(string delim);

Retourne l'élément suivant lu depuis la chaine, en se basant temporairement sur les délimiteurs passés en paramètre.

Paramètres
delim - délimiteurs à utiliser pendant l'appel de cette fonction.
Valeur de retour
un élément ou une chaine vide si plus rien n'est à lire.

setDelims

void setDelims(string delims);

Remplace les délimiteurs précédemment affectés par des nouveaux. Les délimiteurs sont obligatoirement des caractères simples, et chaque caractère de la chaine passé en paramètre de cette méthode constitue un nouveau délimiteur.

Paramètres
delims - les nouveaux délimiteurs
Voir aussi
setNeutralDelims

setNeutralDelims

void setNeutralDelims(string neutralDelims);

Remplace les délimiteurs neutres précédemment affectés par des nouveaux. Les délimiteurs neutres sont obligatoirement des caractères simples, et chaque caractère de la chaine passé en paramètre de cette méthode constitue un nouveau délimiteur neutre.

Paramètres
neutralDelims - delims les délimiteurs
Voir aussi
setDelims

setString

void setString(string str);

Change la chaine produisant les éléments. Le décodage reprend au début de la nouvelle chaine, et les divers attributs de cette classe sont reinitialises.

Paramètres
str - la nouvelle source des éléments


© Virtualys / E.N.I.B. / LI2 - Tous droits réservés
Dernières modifications :