ScriptIter#

class ScriptIter(**kwargs)#

A PangoScriptIter is used to iterate through a string and identify ranges in different scripts.

Constructors#

class ScriptIter
classmethod new(text: str, length: int) → ScriptIter#

Create a new PangoScriptIter, used to break a string of Unicode text into runs by Unicode script.

No copy is made of text, so the caller needs to make sure it remains valid until the iterator is freed with free.

Added in version 1.4.

Parameters:

  • text – a UTF-8 string

  • length – length of text, or -1 if text is nul-terminated

Methods#

class ScriptIter
free() → None#

Frees a PangoScriptIter.

Added in version 1.4.

get_range() → tuple[str, str, Script]#

Gets information about the range to which iter currently points.

The range is the set of locations p where *start <= p < *end. (That is, it doesn’t include the character stored at *end)

Note that while the type of the script argument is declared as PangoScript, as of Pango 1.18, this function simply returns GUnicodeScript values. Callers must be prepared to handle unknown values.

Added in version 1.4.

next() → bool#

Advances a PangoScriptIter to the next range.

If iter is already at the end, it is left unchanged and False is returned.

Added in version 1.4.