## Uses of Interface
java.text.CharacterIterator

- Packages that use CharacterIterator
  Package | Description
  --- | ---
  java.awt | Contains all of the classes for creating user interfaces and for painting graphics and images.
  java.text | Provides classes and interfaces for handling text, dates, numbers, and messages in a manner independent of natural languages.
  javax.swing.text | Provides classes and interfaces that deal with editable and noneditable text components.

- - ### Uses of CharacterIterator in java.awt

    Methods in java.awt with parameters of type CharacterIterator
    Modifier and Type | Method | Description
    --- | --- | ---
    `int` | Font.`canDisplayUpTo(CharacterIterator iter, int start, int limit)` Indicates whether or not this `Font` can display the text specified by the `iter` starting at `start` and ending at `limit`.
    `GlyphVector` | Font.`createGlyphVector(FontRenderContext frc, CharacterIterator ci)` Creates a `GlyphVector` by mapping the specified characters to glyphs one-to-one based on the Unicode cmap in this `Font`.
    `LineMetrics` | Font.`getLineMetrics(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)` Returns a `LineMetrics` object created with the specified arguments.
    `LineMetrics` | FontMetrics.`getLineMetrics(CharacterIterator ci, int beginIndex, int limit, Graphics context)` Returns the `LineMetrics` object for the specified `CharacterIterator` in the specified `Graphics` context.
    `Rectangle2D` | Font.`getStringBounds(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)` Returns the logical bounds of the characters indexed in the specified `CharacterIterator` in the specified `FontRenderContext`.
    `Rectangle2D` | FontMetrics.`getStringBounds(CharacterIterator ci, int beginIndex, int limit, Graphics context)` Returns the bounds of the characters indexed in the specified `CharacterIterator` in the specified `Graphics` context.

  - ### Uses of CharacterIterator in java.text

    Subinterfaces of CharacterIterator in java.text
    Modifier and Type | Interface | Description
    --- | --- | ---
    `interface` | `AttributedCharacterIterator` An `AttributedCharacterIterator` allows iteration through both text and related attribute information.

    Classes in java.text that implement CharacterIterator
    Modifier and Type | Class | Description
    --- | --- | ---
    `class` | `StringCharacterIterator` `StringCharacterIterator` implements the `CharacterIterator` protocol for a `String`.

    Methods in java.text that return CharacterIterator
    Modifier and Type | Method | Description
    --- | --- | ---
    `abstract CharacterIterator` | BreakIterator.`getText()` Get the text being scanned

    Methods in java.text with parameters of type CharacterIterator
    Modifier and Type | Method | Description
    --- | --- | ---
    `CollationElementIterator` | RuleBasedCollator.`getCollationElementIterator(CharacterIterator source)` Returns a CollationElementIterator for the given CharacterIterator.
    `void` | CollationElementIterator.`setText(CharacterIterator source)` Set a new string over which to iterate.
    `abstract void` | BreakIterator.`setText(CharacterIterator newText)` Set a new text for scanning.

  - ### Uses of CharacterIterator in javax.swing.text

    Classes in javax.swing.text that implement CharacterIterator
    Modifier and Type | Class | Description
    --- | --- | ---
    `class` | `Segment` A segment of a character array representing a fragment of text.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.