mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 11:26:16 +01:00
Improvements pointed out by Behdad Esfahbod (#314460):
2005-08-26 Matthias Clasen <mclasen@redhat.com> Improvements pointed out by Behdad Esfahbod (#314460): * glib/tmpl/strings.sgml: Fix up some character/byte sloppyness. * glib/tmpl/iochannels.sgml: Don't mention deprecated functions in the introduction.
This commit is contained in:
parent
1b43764b52
commit
c593d2b180
@ -1,3 +1,13 @@
|
|||||||
|
2005-08-26 Matthias Clasen <mclasen@redhat.com>
|
||||||
|
|
||||||
|
Improvements pointed out by Behdad Esfahbod (#314460):
|
||||||
|
|
||||||
|
* glib/tmpl/strings.sgml: Fix up some character/byte
|
||||||
|
sloppyness.
|
||||||
|
|
||||||
|
* glib/tmpl/iochannels.sgml: Don't mention deprecated
|
||||||
|
functions in the introduction.
|
||||||
|
|
||||||
2005-08-23 Matthias Clasen <mclasen@redhat.com>
|
2005-08-23 Matthias Clasen <mclasen@redhat.com>
|
||||||
|
|
||||||
* === Released 2.8.1 ===
|
* === Released 2.8.1 ===
|
||||||
|
@ -21,7 +21,7 @@ manner using g_io_channel_new_file().
|
|||||||
<para>
|
<para>
|
||||||
Once a #GIOChannel has been created, it can be used in a generic manner
|
Once a #GIOChannel has been created, it can be used in a generic manner
|
||||||
with the functions g_io_channel_read_chars(), g_io_channel_write_chars(),
|
with the functions g_io_channel_read_chars(), g_io_channel_write_chars(),
|
||||||
g_io_channel_seek_position(), and g_io_channel_close().
|
g_io_channel_seek_position(), and g_io_channel_shutdown().
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
To add a #GIOChannel to the
|
To add a #GIOChannel to the
|
||||||
|
@ -25,7 +25,7 @@ The #GString struct contains the public fields of a #GString.
|
|||||||
The <structfield>str</structfield> field points to the character data.
|
The <structfield>str</structfield> field points to the character data.
|
||||||
It may move as text is added.
|
It may move as text is added.
|
||||||
The <structfield>len</structfield> field contains the length of the string,
|
The <structfield>len</structfield> field contains the length of the string,
|
||||||
not including the terminating nul character.
|
not including the terminating nul byte.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The <structfield>str</structfield> field is nul-terminated and so can be used as an ordinary C
|
The <structfield>str</structfield> field is nul-terminated and so can be used as an ordinary C
|
||||||
@ -59,7 +59,7 @@ provided, @init need not be nul-terminated, and can contain embedded nul bytes.
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_sized_new ##### -->
|
<!-- ##### FUNCTION g_string_sized_new ##### -->
|
||||||
<para>
|
<para>
|
||||||
Creates a new #GString, with enough space for @dfl_size characters.
|
Creates a new #GString, with enough space for @dfl_size bytes.
|
||||||
This is useful if you are going to add a lot of text to the string and
|
This is useful if you are going to add a lot of text to the string and
|
||||||
don't want it to be reallocated too often.
|
don't want it to be reallocated too often.
|
||||||
</para>
|
</para>
|
||||||
@ -70,7 +70,7 @@ don't want it to be reallocated too often.
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_assign ##### -->
|
<!-- ##### FUNCTION g_string_assign ##### -->
|
||||||
<para>
|
<para>
|
||||||
Copies the characters from a string into a #GString, destroying any previous
|
Copies the bytes from a string into a #GString, destroying any previous
|
||||||
contents. It is rather like the standard strcpy() function, except that
|
contents. It is rather like the standard strcpy() function, except that
|
||||||
you do not have to worry about having enough space to copy the string.
|
you do not have to worry about having enough space to copy the string.
|
||||||
</para>
|
</para>
|
||||||
@ -148,11 +148,11 @@ Adds a string onto the end of a #GString, expanding it if necessary.
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_append_c ##### -->
|
<!-- ##### FUNCTION g_string_append_c ##### -->
|
||||||
<para>
|
<para>
|
||||||
Adds a character onto the end of a #GString, expanding it if necessary.
|
Adds a byte onto the end of a #GString, expanding it if necessary.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@string: a #GString.
|
@string: a #GString.
|
||||||
@c: the character to append onto the end of the #GString.
|
@c: the byte to append onto the end of the #GString.
|
||||||
@Returns: the #GString.
|
@Returns: the #GString.
|
||||||
|
|
||||||
|
|
||||||
@ -190,11 +190,11 @@ Adds a string on to the start of a #GString, expanding it if necessary.
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_prepend_c ##### -->
|
<!-- ##### FUNCTION g_string_prepend_c ##### -->
|
||||||
<para>
|
<para>
|
||||||
Adds a character onto the start of a #GString, expanding it if necessary.
|
Adds a byte onto the start of a #GString, expanding it if necessary.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@string: a #GString.
|
@string: a #GString.
|
||||||
@c: the character to prepend on the start of the #GString.
|
@c: the byte to prepend on the start of the #GString.
|
||||||
@Returns: the #GString.
|
@Returns: the #GString.
|
||||||
|
|
||||||
|
|
||||||
@ -233,12 +233,12 @@ Inserts a copy of a string into a #GString, expanding it if necessary.
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_insert_c ##### -->
|
<!-- ##### FUNCTION g_string_insert_c ##### -->
|
||||||
<para>
|
<para>
|
||||||
Inserts a character into a #GString, expanding it if necessary.
|
Inserts a byte into a #GString, expanding it if necessary.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@string: a #GString.
|
@string: a #GString.
|
||||||
@pos: the position to insert the character.
|
@pos: the position to insert the byte.
|
||||||
@c: the character to insert.
|
@c: the byte to insert.
|
||||||
@Returns: the #GString.
|
@Returns: the #GString.
|
||||||
|
|
||||||
|
|
||||||
@ -268,20 +268,20 @@ Inserts @len bytes of @val into @string at @pos. Because @len is provided, @val
|
|||||||
|
|
||||||
<!-- ##### FUNCTION g_string_erase ##### -->
|
<!-- ##### FUNCTION g_string_erase ##### -->
|
||||||
<para>
|
<para>
|
||||||
Removes @len characters from a #GString, starting at position @pos.
|
Removes @len bytes from a #GString, starting at position @pos.
|
||||||
The rest of the #GString is shifted down to fill the gap.
|
The rest of the #GString is shifted down to fill the gap.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@string: a #GString.
|
@string: a #GString.
|
||||||
@pos: the position of the characters to remove.
|
@pos: the position of the content to remove.
|
||||||
@len: the number of characters to remove, or -1 to remove all
|
@len: the number of bytes to remove, or -1 to remove all
|
||||||
following characters.
|
following bytes.
|
||||||
@Returns: the #GString.
|
@Returns: the #GString.
|
||||||
|
|
||||||
|
|
||||||
<!-- ##### FUNCTION g_string_truncate ##### -->
|
<!-- ##### FUNCTION g_string_truncate ##### -->
|
||||||
<para>
|
<para>
|
||||||
Cuts off the end of the GString, leaving the first @len characters.
|
Cuts off the end of the GString, leaving the first @len bytes.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@string: a #GString.
|
@string: a #GString.
|
||||||
|
Loading…
Reference in New Issue
Block a user