![]() |
![]() |
![]() |
libinftext-0.3 Reference Manual | ![]() |
---|---|---|---|---|
InfTextBuffer; InfTextBufferIface; InfTextBufferIter; const gchar* inf_text_buffer_get_encoding (InfTextBuffer *buffer); guint inf_text_buffer_get_length (InfTextBuffer *buffer); InfTextChunk* inf_text_buffer_get_slice (InfTextBuffer *buffer, guint pos, guint len); void inf_text_buffer_insert_text (InfTextBuffer *buffer, guint pos, gconstpointer text, gsize bytes, guint len, InfUser *user); void inf_text_buffer_insert_chunk (InfTextBuffer *buffer, guint pos, InfTextChunk *chunk, InfUser *user); void inf_text_buffer_erase_text (InfTextBuffer *buffer, guint pos, guint len, InfUser *user); InfTextBufferIter* inf_text_buffer_create_iter (InfTextBuffer *buffer); void inf_text_buffer_destroy_iter (InfTextBuffer *buffer, InfTextBufferIter *iter); gboolean inf_text_buffer_iter_next (InfTextBuffer *buffer, InfTextBufferIter *iter); gboolean inf_text_buffer_iter_prev (InfTextBuffer *buffer, InfTextBufferIter *iter); gpointer inf_text_buffer_iter_get_text (InfTextBuffer *buffer, InfTextBufferIter *iter); guint inf_text_buffer_iter_get_length (InfTextBuffer *buffer, InfTextBufferIter *iter); gsize inf_text_buffer_iter_get_bytes (InfTextBuffer *buffer, InfTextBufferIter *iter); guint inf_text_buffer_iter_get_author (InfTextBuffer *buffer, InfTextBufferIter *iter);
typedef struct { GTypeInterface parent; /* Virtual table */ const gchar* (*get_encoding)(InfTextBuffer* buffer); guint(*get_length)(InfTextBuffer* buffer); InfTextChunk*(*get_slice)(InfTextBuffer* buffer, guint pos, guint len); InfTextBufferIter*(*create_iter)(InfTextBuffer* buffer); void(*destroy_iter)(InfTextBuffer* buffer, InfTextBufferIter* iter); gboolean(*iter_next)(InfTextBuffer* buffer, InfTextBufferIter* iter); gboolean(*iter_prev)(InfTextBuffer* buffer, InfTextBufferIter* iter); gpointer(*iter_get_text)(InfTextBuffer* buffer, InfTextBufferIter* iter); guint(*iter_get_length)(InfTextBuffer* buffer, InfTextBufferIter* iter); gsize(*iter_get_bytes)(InfTextBuffer* buffer, InfTextBufferIter* iter); guint(*iter_get_author)(InfTextBuffer* buffer, InfTextBufferIter* iter); /* Signals */ void(*insert_text)(InfTextBuffer* buffer, guint pos, InfTextChunk* chunk, InfUser* user); void(*erase_text)(InfTextBuffer* buffer, guint pos, guint len, InfUser* user); } InfTextBufferIface;
const gchar* inf_text_buffer_get_encoding (InfTextBuffer *buffer);
Returns the character encoding that the buffer uses. This means that all InfTextChunk return values are encoded in this encoding and all InfTextChunk parameters are expected to be encoded in that encoding.
|
A InfTextBuffer. |
Returns : |
The character encoding for buffer .
|
guint inf_text_buffer_get_length (InfTextBuffer *buffer);
Returns the number of characters in buffer
.
|
A InfTextBuffer. |
Returns : |
The length of buffer .
|
InfTextChunk* inf_text_buffer_get_slice (InfTextBuffer *buffer, guint pos, guint len);
Reads len
characters, starting at pos
, from the buffer, and returns them
as a InfTextChunk.
|
A InfTextBuffer. |
|
Character offset of where to start extracting. |
|
Number of characters to extract. |
Returns : |
A InfTextChunk. |
void inf_text_buffer_insert_text (InfTextBuffer *buffer, guint pos, gconstpointer text, gsize bytes, guint len, InfUser *user);
Inserts text
into buffer
as written by author
. text
must be encoded in
the character encoding of the buffer, see inf_text_buffer_get_encoding()
.
|
A InfTextBuffer. |
|
A character offset into buffer .
|
|
A pointer to the text to insert. |
|
The length (in bytes) of text .
|
|
The length (in characters) of text .
|
|
A InfUser that has inserted the new text, or NULL .
|
void inf_text_buffer_insert_chunk (InfTextBuffer *buffer, guint pos, InfTextChunk *chunk, InfUser *user);
Inserts a InfTextChunk into buffer
. user
must not necessarily be the
author of chunk
(chunk
may even consist of multiple segments). This
happens when undoing a delete operation that erased another user's text.
|
A InfTextBuffer. |
|
A character offset into buffer .
|
|
A InfTextChunk. |
|
A InfUser inserting chunk , or NULL .
|
void inf_text_buffer_erase_text (InfTextBuffer *buffer, guint pos, guint len, InfUser *user);
Erases characters from the text buffer.
|
A InfTextBuffer. |
|
The position to begin deleting characters from. |
|
The amount of characters to delete. |
|
A InfUser that erases the text, or NULL .
|
InfTextBufferIter* inf_text_buffer_create_iter (InfTextBuffer *buffer);
Creates a InfTextBufferIter pointing to the first segmnet of buffer
.
A InfTextBufferIter is used to traverse the buffer contents in steps of
so-called segments each of which is written by the same user. The function
returns NULL
if there are no segments (i.e. the buffer is empty).
The iterator stays valid as long as the buffer remains unmodified and
must be freed with inf_text_buffer_destroy_iter()
before.
|
A InfTextBuffer. |
Returns : |
A InfTextBufferIter to be freed by
inf_text_buffer_destroy_iter() when done using it, or NULL .
|
void inf_text_buffer_destroy_iter (InfTextBuffer *buffer, InfTextBufferIter *iter);
Destroys a InfTextBufferIter created by inf_text_buffer_create_iter()
.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
gboolean inf_text_buffer_iter_next (InfTextBuffer *buffer, InfTextBufferIter *iter);
Moves iter
to point to the next segment in the buffer. If iter
already
points to the last segment, iter
is left unmodified and the function
returns FALSE
.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
Whether iter was moved.
|
gboolean inf_text_buffer_iter_prev (InfTextBuffer *buffer, InfTextBufferIter *iter);
Moves iter
to point to the previous segment in the buffer. If iter
already points to the first segment, iter
is left unmodified and the
function returns FALSE
.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
Whether iter was moved.
|
gpointer inf_text_buffer_iter_get_text (InfTextBuffer *buffer, InfTextBufferIter *iter);
Returns the text of the segment iter
points to. It is encoded in
buffer
's encoding (see inf_text_buffer_get_encoding()
).
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
The text of the segment iter points to. Free with g_free()
when done using it.
|
guint inf_text_buffer_iter_get_length (InfTextBuffer *buffer, InfTextBufferIter *iter);
Returns the length of the segment iter
points to, in characters.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
The number of characters of the segment iter points to.
|
gsize inf_text_buffer_iter_get_bytes (InfTextBuffer *buffer, InfTextBufferIter *iter);
Returns the length of the segment iter
points to, in bytes.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
The number of bytes of the segment iter points to.
|
guint inf_text_buffer_iter_get_author (InfTextBuffer *buffer, InfTextBufferIter *iter);
Returns the user ID of the user that has written the segment iter
points
to.
|
A InfTextBuffer. |
|
A InfTextBufferIter pointing into buffer .
|
Returns : |
The user ID of the user that wrote the segment iter points
to.
|
"erase-text"
signalvoid user_function (InfTextBuffer *inftextbuffer, guint arg1, guint arg2, InfUser *arg3, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"insert-text"
signalvoid user_function (InfTextBuffer *inftextbuffer, guint arg1, InfTextChunk *arg2, InfUser *arg3, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
user data set when the signal handler was connected. |