Method

Gtk.TextBuffer.get_text

Declaration [src]

char*
gtk_text_buffer_get_text (
  GtkTextBuffer* buffer,
  const GtkTextIter* start,
  const GtkTextIter* end,
  gboolean include_hidden_chars
)

Description [src]

Returns the text in the range [start,end).

Excludes undisplayed text (text marked with tags that set the invisibility attribute) if include_hidden_chars is FALSE. Does not include characters representing embedded images, so byte and character indexes into the returned string do not correspond to byte and character indexes into the buffer. Contrast with gtk_text_buffer_get_slice().

Parameters

start GtkTextIter
 

start of a range

 Ownership is not transferred to the callee
end GtkTextIter
 

end of a range

 Ownership is not transferred to the callee
include_hidden_chars gboolean
 

whether to include invisible text

Return value

Returns: char*

an allocated UTF-8 string

Ownership of the data is transferred to the caller
The string is a NUL terminated UTF-8 string