Method

PangoGlyphItemsplit

since: 1.2

Declaration [src]

PangoGlyphItem*
pango_glyph_item_split (
  PangoGlyphItem* orig,
  const char* text,
  int split_index
)

Description [src]

Modifies orig to cover only the text after split_index, and returns a new item that covers the text before split_index that used to be in orig.

You can think of split_index as the length of the returned item. split_index may not be 0, and it may not be greater than or equal to the length of orig (that is, there must be at least one byte assigned to each item, you can’t create a zero-length item).

This function is similar in function to pango_item_split() (and uses it internally.).

Available since: 1.2

Parameters

text

Type: const char*

Text to which positions in orig apply.

The data is owned by the caller of the method.

The value is a NUL terminated UTF-8 string.

split_index

Type: int

Byte index of position to split item, relative to the start of the item.

Return value

Type: PangoGlyphItem

The newly allocated item representing text before split_index, which should be freed with pango_glyph_item_free().

The caller of the method takes ownership of the returned data, and is responsible for freeing it.

The return value can be NULL.