insert_text


Description:

public virtual uint insert_text (uint position, string chars, uint n_chars)

Inserts n_chars characters of chars into the contents of the buffer, at position position.

If n_chars is negative, then characters from chars will be inserted until a null-terminator is found. If position or n_chars are out of bounds, or the maximum buffer text length is exceeded, then they are coerced to sane values.

Note that the position and length are in characters, not in bytes.

Parameters:

this

a TextBuffer

position

the position at which to insert text.

chars

the text to insert into the buffer.

n_chars

the length of the text in characters, or -1

Returns:

The number of characters actually inserted.