Added in API level 1

Bidi

class Bidi
kotlin.Any
   ↳ java.text.Bidi

This class implements the Unicode Bidirectional Algorithm.

A Bidi object provides information on the bidirectional reordering of the text used to create it. This is required, for example, to properly display Arabic or Hebrew text. These languages are inherently mixed directional, as they order numbers from left-to-right while ordering most other text from right-to-left.

Once created, a Bidi object can be queried to see if the text it represents is all left-to-right or all right-to-left. Such objects are very lightweight and this text is relatively easy to process.

If there are multiple runs of text, information about the runs can be accessed by indexing to get the start, limit, and level of a run. The level represents both the direction and the 'nesting level' of a directional run. Odd levels are right-to-left, while even levels are left-to-right. So for example level 0 represents left-to-right text, while level 1 represents right-to-left text, and level 2 represents left-to-right text embedded in a right-to-left run.

Summary

Constants
static Int

Constant indicating that the base direction depends on the first strong directional character in the text according to the Unicode Bidirectional Algorithm.

static Int

Constant indicating that the base direction depends on the first strong directional character in the text according to the Unicode Bidirectional Algorithm.

static Int

Constant indicating base direction is left-to-right.

static Int

Constant indicating base direction is right-to-left.

Public constructors
Bidi(paragraph: String!, flags: Int)

Create Bidi from the given paragraph of text and base direction.

Create Bidi from the given paragraph of text.

Bidi(text: CharArray!, textStart: Int, embeddings: ByteArray!, embStart: Int, paragraphLength: Int, flags: Int)

Create Bidi from the given text, embedding, and direction information.

Public methods
Boolean

Return true if the base direction is left-to-right.

Bidi!
createLineBidi(lineStart: Int, lineLimit: Int)

Create a Bidi object representing the bidi information on a line of text within the paragraph represented by the current Bidi.

Int

Return the base level (0 if left-to-right, 1 if right-to-left).

Int

Return the length of text in the line.

Int
getLevelAt(offset: Int)

Return the resolved level of the character at offset.

Int

Return the number of level runs.

Int

Return the level of the nth logical run in this line.

Int

Return the index of the character past the end of the nth logical run in this line, as an offset from the start of the line.

Int

Return the index of the character at the start of the nth logical run in this line, as an offset from the start of the line.

Boolean

Return true if the line is all left-to-right text and the base direction is left-to-right.

Boolean

Return true if the line is not left-to-right or right-to-left.

Boolean

Return true if the line is all right-to-left text, and the base direction is right-to-left.

static Unit
reorderVisually(levels: ByteArray!, levelStart: Int, objects: Array<Any!>!, objectStart: Int, count: Int)

Reorder the objects in the array into visual order based on their levels.

static Boolean
requiresBidi(text: CharArray!, start: Int, limit: Int)

Return true if the specified text requires bidi analysis.

String

Display the bidi internal state, used in debugging.

Constants

DIRECTION_DEFAULT_LEFT_TO_RIGHT

Added in API level 1
static val DIRECTION_DEFAULT_LEFT_TO_RIGHT: Int

Constant indicating that the base direction depends on the first strong directional character in the text according to the Unicode Bidirectional Algorithm. If no strong directional character is present, the base direction is left-to-right.

Value: -2

DIRECTION_DEFAULT_RIGHT_TO_LEFT

Added in API level 1
static val DIRECTION_DEFAULT_RIGHT_TO_LEFT: Int

Constant indicating that the base direction depends on the first strong directional character in the text according to the Unicode Bidirectional Algorithm. If no strong directional character is present, the base direction is right-to-left.

Value: -1

DIRECTION_LEFT_TO_RIGHT

Added in API level 1
static val DIRECTION_LEFT_TO_RIGHT: Int

Constant indicating base direction is left-to-right.

Value: 0

DIRECTION_RIGHT_TO_LEFT

Added in API level 1
static val DIRECTION_RIGHT_TO_LEFT: Int

Constant indicating base direction is right-to-left.

Value: 1

Public constructors

Bidi

Added in API level 1
Bidi(
    paragraph: String!,
    flags: Int)

Create Bidi from the given paragraph of text and base direction.

Parameters
paragraph String!: a paragraph of text
flags Int: a collection of flags that control the algorithm. The algorithm understands the flags DIRECTION_LEFT_TO_RIGHT, DIRECTION_RIGHT_TO_LEFT, DIRECTION_DEFAULT_LEFT_TO_RIGHT, and DIRECTION_DEFAULT_RIGHT_TO_LEFT. Other values are reserved.

Bidi

Added in API level 1
Bidi(paragraph: AttributedCharacterIterator!)

Create Bidi from the given paragraph of text.

The RUN_DIRECTION attribute in the text, if present, determines the base direction (left-to-right or right-to-left). If not present, the base direction is computes using the Unicode Bidirectional Algorithm, defaulting to left-to-right if there are no strong directional characters in the text. This attribute, if present, must be applied to all the text in the paragraph.

The BIDI_EMBEDDING attribute in the text, if present, represents embedding level information. Negative values from -1 to -62 indicate overrides at the absolute value of the level. Positive values from 1 to 62 indicate embeddings. Where values are zero or not defined, the base embedding level as determined by the base direction is assumed.

The NUMERIC_SHAPING attribute in the text, if present, converts European digits to other decimal digits before running the bidi algorithm. This attribute, if present, must be applied to all the text in the paragraph.

Parameters
paragraph AttributedCharacterIterator!: a paragraph of text with optional character and paragraph attribute information

Bidi

Added in API level 1
Bidi(
    text: CharArray!,
    textStart: Int,
    embeddings: ByteArray!,
    embStart: Int,
    paragraphLength: Int,
    flags: Int)

Create Bidi from the given text, embedding, and direction information. The embeddings array may be null. If present, the values represent embedding level information. Negative values from -1 to -61 indicate overrides at the absolute value of the level. Positive values from 1 to 61 indicate embeddings. Where values are zero, the base embedding level as determined by the base direction is assumed.

Parameters
text CharArray!: an array containing the paragraph of text to process.
textStart Int: the index into the text array of the start of the paragraph.
embeddings ByteArray!: an array containing embedding values for each character in the paragraph. This can be null, in which case it is assumed that there is no external embedding information.
embStart Int: the index into the embedding array of the start of the paragraph.
paragraphLength Int: the length of the paragraph in the text and embeddings arrays.
flags Int: a collection of flags that control the algorithm. The algorithm understands the flags DIRECTION_LEFT_TO_RIGHT, DIRECTION_RIGHT_TO_LEFT, DIRECTION_DEFAULT_LEFT_TO_RIGHT, and DIRECTION_DEFAULT_RIGHT_TO_LEFT. Other values are reserved.

Public methods

baseIsLeftToRight

Added in API level 1
fun baseIsLeftToRight(): Boolean

Return true if the base direction is left-to-right.

Return
Boolean true if the base direction is left-to-right

createLineBidi

Added in API level 1
fun createLineBidi(
    lineStart: Int,
    lineLimit: Int
): Bidi!

Create a Bidi object representing the bidi information on a line of text within the paragraph represented by the current Bidi. This call is not required if the entire paragraph fits on one line.

Parameters
lineStart Int: the offset from the start of the paragraph to the start of the line.
lineLimit Int: the offset from the start of the paragraph to the limit of the line.
Return
Bidi! a Bidi object

getBaseLevel

Added in API level 1
fun getBaseLevel(): Int

Return the base level (0 if left-to-right, 1 if right-to-left).

Return
Int the base level

getLength

Added in API level 1
fun getLength(): Int

Return the length of text in the line.

Return
Int the length of text in the line

getLevelAt

Added in API level 1
fun getLevelAt(offset: Int): Int

Return the resolved level of the character at offset. If offset is < 0 or ≥ the length of the line, return the base direction level.

Parameters
offset Int: the index of the character for which to return the level
Return
Int the resolved level of the character at offset

getRunCount

Added in API level 1
fun getRunCount(): Int

Return the number of level runs.

Return
Int the number of level runs

getRunLevel

Added in API level 1
fun getRunLevel(run: Int): Int

Return the level of the nth logical run in this line.

Parameters
run Int: the index of the run, between 0 and getRunCount()
Return
Int the level of the run

getRunLimit

Added in API level 1
fun getRunLimit(run: Int): Int

Return the index of the character past the end of the nth logical run in this line, as an offset from the start of the line. For example, this will return the length of the line for the last run on the line.

Parameters
run Int: the index of the run, between 0 and getRunCount()
Return
Int limit the limit of the run

getRunStart

Added in API level 1
fun getRunStart(run: Int): Int

Return the index of the character at the start of the nth logical run in this line, as an offset from the start of the line.

Parameters
run Int: the index of the run, between 0 and getRunCount()
Return
Int the start of the run

isLeftToRight

Added in API level 1
fun isLeftToRight(): Boolean

Return true if the line is all left-to-right text and the base direction is left-to-right.

Return
Boolean true if the line is all left-to-right text and the base direction is left-to-right

isMixed

Added in API level 1
fun isMixed(): Boolean

Return true if the line is not left-to-right or right-to-left. This means it either has mixed runs of left-to-right and right-to-left text, or the base direction differs from the direction of the only run of text.

Return
Boolean true if the line is not left-to-right or right-to-left.

isRightToLeft

Added in API level 1
fun isRightToLeft(): Boolean

Return true if the line is all right-to-left text, and the base direction is right-to-left.

Return
Boolean true if the line is all right-to-left text, and the base direction is right-to-left

reorderVisually

Added in API level 1
static fun reorderVisually(
    levels: ByteArray!,
    levelStart: Int,
    objects: Array<Any!>!,
    objectStart: Int,
    count: Int
): Unit

Reorder the objects in the array into visual order based on their levels. This is a utility function to use when you have a collection of objects representing runs of text in logical order, each run containing text at a single level. The elements at index from objectStart up to objectStart + count in the objects array will be reordered into visual order assuming each run of text has the level indicated by the corresponding element in the levels array (at index - objectStart + levelStart).

Parameters
levels ByteArray!: an array representing the bidi level of each object
levelStart Int: the start position in the levels array
objects Array<Any!>!: the array of objects to be reordered into visual order
objectStart Int: the start position in the objects array
count Int: the number of objects to reorder

requiresBidi

Added in API level 1
static fun requiresBidi(
    text: CharArray!,
    start: Int,
    limit: Int
): Boolean

Return true if the specified text requires bidi analysis. If this returns false, the text will display left-to-right. Clients can then avoid constructing a Bidi object. Text in the Arabic Presentation Forms area of Unicode is presumed to already be shaped and ordered for display, and so will not cause this function to return true.

Parameters
text CharArray!: the text containing the characters to test
start Int: the start of the range of characters to test
limit Int: the limit of the range of characters to test
Return
Boolean true if the range of characters requires bidi analysis

toString

Added in API level 1
fun toString(): String

Display the bidi internal state, used in debugging.

Return
String a string representation of the object.