blob: ac3253a96b58184698735c8ed6289e5c7e0196c2 [file] [log] [blame]
<!-- ##### SECTION Title ##### -->
Base64 Encoding
<!-- ##### SECTION Short_Description ##### -->
encodes and decodes data in Base64 format
<!-- ##### SECTION Long_Description ##### -->
<para>
Base64 is an encoding that allows to encode a sequence of arbitrary
bytes as a sequence of printable ASCII characters. For the definition
of Base64, see <ulink url="http://www.ietf.org/rfc/rfc1421.txt">RFC
1421</ulink> or <ulink url="http://www.ietf.org/rfc/rfc2045.txt">RFC
2045</ulink>. Base64 is most commonly used as a MIME transfer encoding
for email.
</para>
<para>
GLib supports incremental encoding using g_base64_encode_step() and
g_base64_encode_close(). Incremental decoding can be done with
g_base64_decode_step() and g_base64_decode_close(). To encode or
decode data in one go, use g_base64_encode() of g_base64_decode().
</para>
<para>
Support for Base64 encoding has been added in GLib 2.12.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### FUNCTION g_base64_encode_step ##### -->
<para>
</para>
@in:
@len:
@break_lines:
@out:
@state:
@save:
@Returns:
<!-- ##### FUNCTION g_base64_encode_close ##### -->
<para>
</para>
@break_lines:
@out:
@state:
@save:
@Returns:
<!-- ##### FUNCTION g_base64_encode ##### -->
<para>
</para>
@data:
@len:
@Returns:
<!-- ##### FUNCTION g_base64_decode_step ##### -->
<para>
</para>
@in:
@len:
@out:
@state:
@save:
@Returns:
<!-- ##### FUNCTION g_base64_decode ##### -->
<para>
</para>
@text:
@out_len:
@Returns: