- java.lang.Object
-
- java.text.StringCharacterIterator
-
- All Implemented Interfaces:
- Cloneable, CharacterIterator
public final class StringCharacterIterator extends Object implements CharacterIterator
StringCharacterIterator
implements theCharacterIterator
protocol for aString
. TheStringCharacterIterator
class iterates over the entireString
.- See Also:
CharacterIterator
-
-
Field Summary
-
Fields inherited from interface java.text.CharacterIterator
DONE
-
-
Constructor Summary
Constructors Constructor and Description StringCharacterIterator(String text)
Constructs an iterator with an initial index of 0.StringCharacterIterator(String text, int pos)
Constructs an iterator with the specified initial index.StringCharacterIterator(String text, int begin, int end, int pos)
Constructs an iterator over the given range of the given string, with the index set at the specified position.
-
Method Summary
Methods Modifier and Type Method and Description Object
clone()
Creates a copy of this iterator.char
current()
Implements CharacterIterator.current() for String.boolean
equals(Object obj)
Compares the equality of two StringCharacterIterator objects.char
first()
Implements CharacterIterator.first() for String.int
getBeginIndex()
Implements CharacterIterator.getBeginIndex() for String.int
getEndIndex()
Implements CharacterIterator.getEndIndex() for String.int
getIndex()
Implements CharacterIterator.getIndex() for String.int
hashCode()
Computes a hashcode for this iterator.char
last()
Implements CharacterIterator.last() for String.char
next()
Implements CharacterIterator.next() for String.char
previous()
Implements CharacterIterator.previous() for String.char
setIndex(int p)
Implements CharacterIterator.setIndex() for String.void
setText(String text)
Reset this iterator to point to a new string.
-
-
-
Constructor Detail
-
StringCharacterIterator
public StringCharacterIterator(String text)
Constructs an iterator with an initial index of 0.
-
StringCharacterIterator
public StringCharacterIterator(String text, int pos)
Constructs an iterator with the specified initial index.- Parameters:
text
- The String to be iterated overpos
- Initial iterator position
-
StringCharacterIterator
public StringCharacterIterator(String text, int begin, int end, int pos)
Constructs an iterator over the given range of the given string, with the index set at the specified position.- Parameters:
text
- The String to be iterated overbegin
- Index of the first characterend
- Index of the character following the last characterpos
- Initial iterator position
-
-
Method Detail
-
setText
public void setText(String text)
Reset this iterator to point to a new string. This package-visible method is used by other java.text classes that want to avoid allocating new StringCharacterIterator objects every time their setText method is called.- Parameters:
text
- The String to be iterated over- Since:
- 1.2
-
first
public char first()
Implements CharacterIterator.first() for String.- Specified by:
first
in interfaceCharacterIterator
- Returns:
- the first character in the text, or DONE if the text is empty
- See Also:
CharacterIterator.first()
-
last
public char last()
Implements CharacterIterator.last() for String.- Specified by:
last
in interfaceCharacterIterator
- Returns:
- the last character in the text, or DONE if the text is empty
- See Also:
CharacterIterator.last()
-
setIndex
public char setIndex(int p)
Implements CharacterIterator.setIndex() for String.- Specified by:
setIndex
in interfaceCharacterIterator
- Parameters:
p
- the position within the text. Valid values range from getBeginIndex() to getEndIndex(). An IllegalArgumentException is thrown if an invalid value is supplied.- Returns:
- the character at the specified position or DONE if the specified position is equal to getEndIndex()
- See Also:
CharacterIterator.setIndex(int)
-
current
public char current()
Implements CharacterIterator.current() for String.- Specified by:
current
in interfaceCharacterIterator
- Returns:
- the character at the current position or DONE if the current position is off the end of the text.
- See Also:
CharacterIterator.current()
-
next
public char next()
Implements CharacterIterator.next() for String.- Specified by:
next
in interfaceCharacterIterator
- Returns:
- the character at the new position or DONE if the new position is off the end of the text range.
- See Also:
CharacterIterator.next()
-
previous
public char previous()
Implements CharacterIterator.previous() for String.- Specified by:
previous
in interfaceCharacterIterator
- Returns:
- the character at the new position or DONE if the current position is equal to getBeginIndex().
- See Also:
CharacterIterator.previous()
-
getBeginIndex
public int getBeginIndex()
Implements CharacterIterator.getBeginIndex() for String.- Specified by:
getBeginIndex
in interfaceCharacterIterator
- Returns:
- the index at which the text begins.
- See Also:
CharacterIterator.getBeginIndex()
-
getEndIndex
public int getEndIndex()
Implements CharacterIterator.getEndIndex() for String.- Specified by:
getEndIndex
in interfaceCharacterIterator
- Returns:
- the index after the last character in the text
- See Also:
CharacterIterator.getEndIndex()
-
getIndex
public int getIndex()
Implements CharacterIterator.getIndex() for String.- Specified by:
getIndex
in interfaceCharacterIterator
- Returns:
- the current index.
- See Also:
CharacterIterator.getIndex()
-
equals
public boolean equals(Object obj)
Compares the equality of two StringCharacterIterator objects.- Overrides:
equals
in classObject
- Parameters:
obj
- the StringCharacterIterator object to be compared with.- Returns:
- true if the given obj is the same as this StringCharacterIterator object; false otherwise.
- See Also:
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
Computes a hashcode for this iterator.- Overrides:
hashCode
in classObject
- Returns:
- A hash code
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 21:37:09 Cette version de la page est en cache (à la date du 21/11/2024 21:37:09) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/text/stringcharacteriterator.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.