TextCharPropIterator (The Adobe Experience Manager SDK 2022.11.9850.20221116T162329Z-220900)

All Known Implementing Classes:

TextCharPropCharIterator, TextCharPropDataIterator, TextStreamIterator
```
public interface TextCharPropIterator
```
Abstract class TextCharPropIterator is used in algorithms based on character classification. Semantically, it steps over an implied array of character properties and returns character properties and positions in that array where such properties exist.

This header file provides two common implementations: TextCharPropDataIterator, which handles a real array of character properties, and TextCharPropCharIterator, which processes an array of Unicode characters and returns properties for those characters.

The term "implied array" in the introductory paragraph means that a particular implementation need not store a real array. The interface does use somewhat abstract index values. The implementation can assign any meaning to those values, as long as it returns the same property value for each call with a given index value, and returns index values in the same sequence. Index values are assigned by the implementation and need not start at zero, need not be contiguous and even need not be in ascending order.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`int`	`first()`	Return the index value corresponding to the first element in the logical array.
`int`	`getNextIndex()`
`int`	`next()`
`int`	`next(int nIndex)`	Obtain the character properties corresponding to the current index value and advance the index.

- Method Detail
  - first
```
int first()
```
    Return the index value corresponding to the first element in the logical array.
    
    Returns:
    
    First element's index value. Often zero, but doesn't have to be.
  - next
```
int next(int nIndex)
```
    Obtain the character properties corresponding to the current index value and advance the index.
    
    Parameters:
    
    nIndex - - Current index value. The call must update this parameter to represent the logical next index value. The caller should treat this as an opaque variable and must not alter it (except through this interface) or infer any meaning from its value.
    
    Returns:
    
    True if there were character properties at the given index value; false if past the logical end of the array (if the immediately previous call had returned properties for the last logical position in the array).
  - next
```
int next()
```
  - getNextIndex
```
int getNextIndex()
```