Method

GtkEditableget_chars

Declaration [src]

gchar*
gtk_editable_get_chars (
  GtkEditable* editable,
  gint start_pos,
  gint end_pos
)

Description [src]

Retrieves a sequence of characters. The characters that are retrieved are those characters at positions from start_pos up to, but not including end_pos. If end_pos is negative, then the characters retrieved are those characters from start_pos to the end of the text.

Note that positions are specified in characters, not bytes.

Parameters

start_pos

Type: gint

Start of text.

end_pos

Type: gint

End of text.

Return value

Type: gchar*

A pointer to the contents of the widget as a string. This string is allocated by the GtkEditable implementation and should be freed by the caller.

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

The value is a NUL terminated UTF-8 string.