|  |  |  | liblangtag Documentation |  | 
|---|---|---|---|---|
| Top | Description | ||||
lt_string_t * lt_string_append (lt_string_t *string,const char *str); lt_string_t * lt_string_append_c (lt_string_t *string,char c); lt_string_t * lt_string_append_filename (lt_string_t *string,const char *path); char lt_string_at (lt_string_t *string,ssize_t pos); void lt_string_clear (lt_string_t *string); char * lt_string_free (lt_string_t *string,lt_bool_t free_segment); size_t lt_string_length (const lt_string_t *string); lt_string_t * lt_string_new (const char *string); lt_string_t * lt_string_ref (lt_string_t *string); lt_string_t * lt_string_replace_c (lt_string_t *string,size_t pos,char c); lt_string_t; lt_string_t * lt_string_truncate (lt_string_t *string,ssize_t len); void lt_string_unref (lt_string_t *string); const char * lt_string_value (const lt_string_t *string);
lt_string_t * lt_string_append (lt_string_t *string,const char *str);
Adds a string onto the end of a lt_string_t, expanding it if necessary.
| 
 | a lt_string_t | 
| 
 | the string to append onto the end of string | 
| Returns : | the same stringobject. [transfer none] | 
lt_string_t * lt_string_append_c (lt_string_t *string,char c);
Adds a byte onto the end of a lt_string_t, expanding it if necessary.
| 
 | a lt_string_t | 
| 
 | the byte to append onto the end of string | 
| Returns : | the same stringobject. [transfer none] | 
lt_string_t * lt_string_append_filename (lt_string_t *string,const char *path);
Adds a string onto the end of a lt_string_t as a file path.
| 
 | a lt_string_t | 
| 
 | the string to append onto the end of stringas a file path | 
| Returns : | the same stringobject. [transfer none] | 
char lt_string_at (lt_string_t *string,ssize_t pos);
Obtain a byte in a lt_string_t at pos. If pos is a negative,
the position is calculated from current size. i.e. if the buffer
contains "abc", and pos is -1, this will returns 'c' then.
| 
 | a lt_string_t | 
| 
 | position in stringwhere to obtain the byte | 
| Returns : | the byte in stringatpos | 
void                lt_string_clear                     (lt_string_t *string);
Clean up the buffer in string.
| 
 | a lt_string_t | 
char * lt_string_free (lt_string_t *string,lt_bool_t free_segment);
Frees the memory allocated for the lt_string_t.
If free_segment is TRUE it also frees the character data.  If
it's FALSE, the caller gains ownership of the buffer and must
free it after use with free().
| 
 | a lt_string_t | 
| 
 | if TRUE, the actual character data is freed as well | 
| Returns : | the character data of string(i.e.NULLiffree_segmentisTRUE) | 
size_t              lt_string_length                    (const lt_string_t *string);
Returns the number of characters in buffer for string.
| 
 | a lt_string_t | 
| Returns : | the number of characters | 
lt_string_t *       lt_string_new                       (const char *string);
Creates an instance of lt_string_t with string.
| 
 | an initial string to set | 
| Returns : | a new instance of lt_string_t. | 
lt_string_t *       lt_string_ref                       (lt_string_t *string);
Increases the reference count of string.
| 
 | a lt_string_t | 
| Returns : | the same stringobject. [transfer none] | 
lt_string_t * lt_string_replace_c (lt_string_t *string,size_t pos,char c);
Replaces a character in string at pos.
| 
 | a lt_string_t | 
| 
 | position in stringwhere replacement should happen | 
| 
 | the byte to replace | 
| Returns : | the same stringobject. [transfer none] | 
typedef struct _lt_string_t lt_string_t;
All the fields in the lt_string_t structure are private to the lt_string_t implementation.
lt_string_t * lt_string_truncate (lt_string_t *string,ssize_t len);
Truncates the characters in the buffer according to len. if len is
a negative, how many characters is truncated will be calculated from
current size. i.e. if the buffer contains "abc", and len is -1,
the buffer will be "ab" after this call.
| 
 | a lt_string_t | 
| 
 | the number of characters to be truncated from the buffer. | 
| Returns : | the same stringobject. [transfer none] | 
void                lt_string_unref                     (lt_string_t *string);
Decreases the reference count of string. when its reference count
drops to 0, the object is finalized (i.e. its memory is freed).
| 
 | a lt_string_t | 
const char *        lt_string_value                     (const lt_string_t *string);
Returns the buffer in string.
| 
 | a lt_string_t | 
| Returns : | a string which stringhas. |