Method

GtkTextBufferget_iter_at_line_index

Declaration [src]

void
gtk_text_buffer_get_iter_at_line_index (
  GtkTextBuffer* buffer,
  GtkTextIter* iter,
  gint line_number,
  gint byte_index
)

Description [src]

Obtains an iterator pointing to byte_index within the given line. byte_index must be the start of a UTF-8 character. Note bytes, not characters; UTF-8 may encode one character as multiple bytes.

Before the 3.20 version, it was not allowed to pass an invalid location.

Since the 3.20 version, if line_number is greater than the number of lines in the buffer, the end iterator is returned. And if byte_index is off the end of the line, the iterator at the end of the line is returned.

Parameters

iter

Type: GtkTextIter

Iterator to initialize.

The argument will be set by the function.
The returned data is owned by the instance.
line_number

Type: gint

Line number counting from 0

byte_index

Type: gint

Byte index from start of line.