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