SegmentFinder


public abstract class SegmentFinder
extends Object

java.lang.Object
   ↳ android.text.SegmentFinder


Finds text segment boundaries within text. Subclasses can implement different types of text segments. Grapheme clusters and words are examples of possible text segments. These are implemented by GraphemeClusterSegmentFinder and WordSegmentFinder.

Text segments may not overlap, so every character belongs to at most one text segment. A character may belong to no text segments.

For example, WordSegmentFinder subdivides the text "Hello, World!" into four text segments: "Hello", ",", "World", "!". The space character does not belong to any text segments.

Summary

Nested classes

class SegmentFinder.PrescribedSegmentFinder

The default SegmentFinder implementation based on given segment ranges. 

Constants

int DONE

Return value of previousStartBoundary(int), previousEndBoundary(int), nextStartBoundary(int), and nextEndBoundary(int) when there are no boundaries of the specified type in the specified direction.

Public constructors

SegmentFinder()

Public methods

abstract int nextEndBoundary(int offset)

Returns the character offset of the next text segment end boundary after the specified character offset, or DONE if there are none.

abstract int nextStartBoundary(int offset)

Returns the character offset of the next text segment start boundary after the specified character offset, or DONE if there are none.

abstract int previousEndBoundary(int offset)

Returns the character offset of the previous text segment end boundary before the specified character offset, or DONE if there are none.

abstract int previousStartBoundary(int offset)

Returns the character offset of the previous text segment start boundary before the specified character offset, or DONE if there are none.

Inherited methods

Constants

DONE

Added in API level 34
public static final int DONE

Return value of previousStartBoundary(int), previousEndBoundary(int), nextStartBoundary(int), and nextEndBoundary(int) when there are no boundaries of the specified type in the specified direction.

Constant Value: -1 (0xffffffff)

Public constructors

SegmentFinder

public SegmentFinder ()

Public methods

nextEndBoundary

Added in API level 34
public abstract int nextEndBoundary (int offset)

Returns the character offset of the next text segment end boundary after the specified character offset, or DONE if there are none.

Parameters
offset int: Value is 0 or greater

Returns
int

nextStartBoundary

Added in API level 34
public abstract int nextStartBoundary (int offset)

Returns the character offset of the next text segment start boundary after the specified character offset, or DONE if there are none.

Parameters
offset int: Value is 0 or greater

Returns
int

previousEndBoundary

Added in API level 34
public abstract int previousEndBoundary (int offset)

Returns the character offset of the previous text segment end boundary before the specified character offset, or DONE if there are none.

Parameters
offset int: Value is 0 or greater

Returns
int

previousStartBoundary

Added in API level 34
public abstract int previousStartBoundary (int offset)

Returns the character offset of the previous text segment start boundary before the specified character offset, or DONE if there are none.

Parameters
offset int: Value is 0 or greater

Returns
int