Function

Pango.ScriptIter.new

Declaration [src]

PangoScriptIter*
pango_script_iter_new (
  const char* text,
  int length
)

Description [src]

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 pango_script_iter_free().

Available since:1.4

Parameters

text const char*
 

a UTF-8 string

 The data is owned by the caller of the function
 The string is a NUL terminated UTF-8 string
length int
 

length of text, or -1 if text is nul-terminated.

Return value

Returns: PangoScriptIter

the new script iterator, initialized to point at the first range in the text, which should be freed with pango_script_iter_free(). If the string is empty, it will point at an empty range.

The caller of the function takes ownership of the data, and is responsible for freeing it