com.ibm.icu.util

Interface RangeValueIterator

public interface RangeValueIterator

Interface for enabling iteration over sets of <int index, int value>, where index is the sorted integer index in ascending order and value, its associated integer value.

The result for each iteration is the consecutive range of <int index, int value> with the same value. Result is represented by <start, limit, value> where

• start is the starting integer of the result range
• limit is 1 after the maximum integer that follows start, such that all integers between start and (limit - 1), inclusive, have the same associated integer value.
• value is the integer value that all integers from start to (limit - 1) share in common.

Hence value(start) = value(start + 1) = .... = value(start + n) = .... = value(limit - 1). However value(start -1) != value(start) and value(limit) != value(start).

Most implementations will be created by factory methods, such as the character type iterator in UCharacter.getTypeIterator. See example below.

Example of use:

 RangeValueIterator iterator = UCharacter.getTypeIterator();
 RangeValueIterator.Element result = new RangeValueIterator.Element();
 while (iterator.next(result)) {
     System.out.println("Codepoint \\u" +
                        Integer.toHexString(result.start) +
                        " to codepoint \\u" +
                        Integer.toHexString(result.limit - 1) +
                        " has the character type " + result.value);
 }
 

Author:

synwee

Status:

Stable ICU 2.6.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	RangeValueIterator.Element Return result wrapper for com.ibm.icu.util.RangeValueIterator.

Method Summary

Modifier and Type	Method and Description
boolean	next(RangeValueIterator.Element element) Returns the next maximal result range with a common value and returns true if we are not at the end of the iteration, false otherwise.
void	reset() Resets the iterator to the beginning of the iteration.

Method Detail

next

boolean next(RangeValueIterator.Element element)

Returns the next maximal result range with a common value and returns true if we are not at the end of the iteration, false otherwise.

If this returns a false, the contents of elements will not be updated.

Parameters:

element - for storing the result range and value

Returns:

true if we are not at the end of the iteration, false otherwise.

See Also:

RangeValueIterator.Element

Status:

Stable ICU 2.6.

reset

void reset()

Resets the iterator to the beginning of the iteration.

Status:

Stable ICU 2.6.