← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/glib/xml/byte_order.xml

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/xml/byte_order.xml
1
1
<refentry id="glib-Byte-Order-Macros">
2
2
<refmeta>
3
 
<refentrytitle role="top_of_page">Byte Order Macros</refentrytitle>
 
3
<refentrytitle role="top_of_page" id="glib-Byte-Order-Macros.top_of_page">Byte Order Macros</refentrytitle>
4
4
<manvolnum>3</manvolnum>
5
5
<refmiscinfo>GLIB Library</refmiscinfo>
6
6
</refmeta>
8
8
<refnamediv>
9
9
<refname>Byte Order Macros</refname>
10
10
<refpurpose>a portable way to convert between different byte orders</refpurpose>
11
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
12
11
</refnamediv>
13
12
 
14
 
<refsynopsisdiv role="synopsis">
 
13
<refsynopsisdiv id="glib-Byte-Order-Macros.synopsis" role="synopsis">
15
14
<title role="synopsis.title">Synopsis</title>
16
15
 
17
16
<synopsis>
18
17
 
19
18
#include &lt;glib.h&gt;
20
19
 
21
 
 
22
 
#define             <link linkend="G-BYTE-ORDER:CAPS">G_BYTE_ORDER</link>
23
 
#define             <link linkend="G-LITTLE-ENDIAN:CAPS">G_LITTLE_ENDIAN</link>
24
 
#define             <link linkend="G-BIG-ENDIAN:CAPS">G_BIG_ENDIAN</link>
25
 
#define             <link linkend="G-PDP-ENDIAN:CAPS">G_PDP_ENDIAN</link>
 
20
#define             <link linkend="G-BYTE-ORDER--CAPS">G_BYTE_ORDER</link>
 
21
#define             <link linkend="G-LITTLE-ENDIAN--CAPS">G_LITTLE_ENDIAN</link>
 
22
#define             <link linkend="G-BIG-ENDIAN--CAPS">G_BIG_ENDIAN</link>
 
23
#define             <link linkend="G-PDP-ENDIAN--CAPS">G_PDP_ENDIAN</link>
26
24
 
27
25
#define             <link linkend="g-htonl">g_htonl</link>                             (val)
28
26
#define             <link linkend="g-htons">g_htons</link>                             (val)
29
27
#define             <link linkend="g-ntohl">g_ntohl</link>                             (val)
30
28
#define             <link linkend="g-ntohs">g_ntohs</link>                             (val)
31
29
 
32
 
#define             <link linkend="GINT-FROM-BE:CAPS">GINT_FROM_BE</link>                        (val)
33
 
#define             <link linkend="GINT-FROM-LE:CAPS">GINT_FROM_LE</link>                        (val)
34
 
#define             <link linkend="GINT-TO-BE:CAPS">GINT_TO_BE</link>                          (val)
35
 
#define             <link linkend="GINT-TO-LE:CAPS">GINT_TO_LE</link>                          (val)
36
 
 
37
 
#define             <link linkend="GUINT-FROM-BE:CAPS">GUINT_FROM_BE</link>                       (val)
38
 
#define             <link linkend="GUINT-FROM-LE:CAPS">GUINT_FROM_LE</link>                       (val)
39
 
#define             <link linkend="GUINT-TO-BE:CAPS">GUINT_TO_BE</link>                         (val)
40
 
#define             <link linkend="GUINT-TO-LE:CAPS">GUINT_TO_LE</link>                         (val)
41
 
 
42
 
#define             <link linkend="GLONG-FROM-BE:CAPS">GLONG_FROM_BE</link>                       (val)
43
 
#define             <link linkend="GLONG-FROM-LE:CAPS">GLONG_FROM_LE</link>                       (val)
44
 
#define             <link linkend="GLONG-TO-BE:CAPS">GLONG_TO_BE</link>                         (val)
45
 
#define             <link linkend="GLONG-TO-LE:CAPS">GLONG_TO_LE</link>                         (val)
46
 
 
47
 
#define             <link linkend="GULONG-FROM-BE:CAPS">GULONG_FROM_BE</link>                      (val)
48
 
#define             <link linkend="GULONG-FROM-LE:CAPS">GULONG_FROM_LE</link>                      (val)
49
 
#define             <link linkend="GULONG-TO-BE:CAPS">GULONG_TO_BE</link>                        (val)
50
 
#define             <link linkend="GULONG-TO-LE:CAPS">GULONG_TO_LE</link>                        (val)
51
 
 
52
 
#define             <link linkend="GINT16-FROM-BE:CAPS">GINT16_FROM_BE</link>                      (val)
53
 
#define             <link linkend="GINT16-FROM-LE:CAPS">GINT16_FROM_LE</link>                      (val)
54
 
#define             <link linkend="GINT16-TO-BE:CAPS">GINT16_TO_BE</link>                        (val)
55
 
#define             <link linkend="GINT16-TO-LE:CAPS">GINT16_TO_LE</link>                        (val)
56
 
 
57
 
#define             <link linkend="GUINT16-FROM-BE:CAPS">GUINT16_FROM_BE</link>                     (val)
58
 
#define             <link linkend="GUINT16-FROM-LE:CAPS">GUINT16_FROM_LE</link>                     (val)
59
 
#define             <link linkend="GUINT16-TO-BE:CAPS">GUINT16_TO_BE</link>                       (val)
60
 
#define             <link linkend="GUINT16-TO-LE:CAPS">GUINT16_TO_LE</link>                       (val)
61
 
 
62
 
#define             <link linkend="GINT32-FROM-BE:CAPS">GINT32_FROM_BE</link>                      (val)
63
 
#define             <link linkend="GINT32-FROM-LE:CAPS">GINT32_FROM_LE</link>                      (val)
64
 
#define             <link linkend="GINT32-TO-BE:CAPS">GINT32_TO_BE</link>                        (val)
65
 
#define             <link linkend="GINT32-TO-LE:CAPS">GINT32_TO_LE</link>                        (val)
66
 
 
67
 
#define             <link linkend="GUINT32-FROM-BE:CAPS">GUINT32_FROM_BE</link>                     (val)
68
 
#define             <link linkend="GUINT32-FROM-LE:CAPS">GUINT32_FROM_LE</link>                     (val)
69
 
#define             <link linkend="GUINT32-TO-BE:CAPS">GUINT32_TO_BE</link>                       (val)
70
 
#define             <link linkend="GUINT32-TO-LE:CAPS">GUINT32_TO_LE</link>                       (val)
71
 
 
72
 
#define             <link linkend="GINT64-FROM-BE:CAPS">GINT64_FROM_BE</link>                      (val)
73
 
#define             <link linkend="GINT64-FROM-LE:CAPS">GINT64_FROM_LE</link>                      (val)
74
 
#define             <link linkend="GINT64-TO-BE:CAPS">GINT64_TO_BE</link>                        (val)
75
 
#define             <link linkend="GINT64-TO-LE:CAPS">GINT64_TO_LE</link>                        (val)
76
 
 
77
 
#define             <link linkend="GUINT64-FROM-BE:CAPS">GUINT64_FROM_BE</link>                     (val)
78
 
#define             <link linkend="GUINT64-FROM-LE:CAPS">GUINT64_FROM_LE</link>                     (val)
79
 
#define             <link linkend="GUINT64-TO-BE:CAPS">GUINT64_TO_BE</link>                       (val)
80
 
#define             <link linkend="GUINT64-TO-LE:CAPS">GUINT64_TO_LE</link>                       (val)
81
 
 
82
 
#define             <link linkend="GUINT16-SWAP-BE-PDP:CAPS">GUINT16_SWAP_BE_PDP</link>                 (val)
83
 
#define             <link linkend="GUINT16-SWAP-LE-BE:CAPS">GUINT16_SWAP_LE_BE</link>                  (val)
84
 
#define             <link linkend="GUINT16-SWAP-LE-PDP:CAPS">GUINT16_SWAP_LE_PDP</link>                 (val)
85
 
 
86
 
#define             <link linkend="GUINT32-SWAP-BE-PDP:CAPS">GUINT32_SWAP_BE_PDP</link>                 (val)
87
 
#define             <link linkend="GUINT32-SWAP-LE-BE:CAPS">GUINT32_SWAP_LE_BE</link>                  (val)
88
 
#define             <link linkend="GUINT32-SWAP-LE-PDP:CAPS">GUINT32_SWAP_LE_PDP</link>                 (val)
89
 
 
90
 
#define             <link linkend="GUINT64-SWAP-LE-BE:CAPS">GUINT64_SWAP_LE_BE</link>                  (val)
91
 
 
 
30
#define             <link linkend="GINT-FROM-BE--CAPS">GINT_FROM_BE</link>                        (val)
 
31
#define             <link linkend="GINT-FROM-LE--CAPS">GINT_FROM_LE</link>                        (val)
 
32
#define             <link linkend="GINT-TO-BE--CAPS">GINT_TO_BE</link>                          (val)
 
33
#define             <link linkend="GINT-TO-LE--CAPS">GINT_TO_LE</link>                          (val)
 
34
 
 
35
#define             <link linkend="GUINT-FROM-BE--CAPS">GUINT_FROM_BE</link>                       (val)
 
36
#define             <link linkend="GUINT-FROM-LE--CAPS">GUINT_FROM_LE</link>                       (val)
 
37
#define             <link linkend="GUINT-TO-BE--CAPS">GUINT_TO_BE</link>                         (val)
 
38
#define             <link linkend="GUINT-TO-LE--CAPS">GUINT_TO_LE</link>                         (val)
 
39
 
 
40
#define             <link linkend="GLONG-FROM-BE--CAPS">GLONG_FROM_BE</link>                       (val)
 
41
#define             <link linkend="GLONG-FROM-LE--CAPS">GLONG_FROM_LE</link>                       (val)
 
42
#define             <link linkend="GLONG-TO-BE--CAPS">GLONG_TO_BE</link>                         (val)
 
43
#define             <link linkend="GLONG-TO-LE--CAPS">GLONG_TO_LE</link>                         (val)
 
44
 
 
45
#define             <link linkend="GULONG-FROM-BE--CAPS">GULONG_FROM_BE</link>                      (val)
 
46
#define             <link linkend="GULONG-FROM-LE--CAPS">GULONG_FROM_LE</link>                      (val)
 
47
#define             <link linkend="GULONG-TO-BE--CAPS">GULONG_TO_BE</link>                        (val)
 
48
#define             <link linkend="GULONG-TO-LE--CAPS">GULONG_TO_LE</link>                        (val)
 
49
 
 
50
#define             <link linkend="GINT16-FROM-BE--CAPS">GINT16_FROM_BE</link>                      (val)
 
51
#define             <link linkend="GINT16-FROM-LE--CAPS">GINT16_FROM_LE</link>                      (val)
 
52
#define             <link linkend="GINT16-TO-BE--CAPS">GINT16_TO_BE</link>                        (val)
 
53
#define             <link linkend="GINT16-TO-LE--CAPS">GINT16_TO_LE</link>                        (val)
 
54
 
 
55
#define             <link linkend="GUINT16-FROM-BE--CAPS">GUINT16_FROM_BE</link>                     (val)
 
56
#define             <link linkend="GUINT16-FROM-LE--CAPS">GUINT16_FROM_LE</link>                     (val)
 
57
#define             <link linkend="GUINT16-TO-BE--CAPS">GUINT16_TO_BE</link>                       (val)
 
58
#define             <link linkend="GUINT16-TO-LE--CAPS">GUINT16_TO_LE</link>                       (val)
 
59
 
 
60
#define             <link linkend="GINT32-FROM-BE--CAPS">GINT32_FROM_BE</link>                      (val)
 
61
#define             <link linkend="GINT32-FROM-LE--CAPS">GINT32_FROM_LE</link>                      (val)
 
62
#define             <link linkend="GINT32-TO-BE--CAPS">GINT32_TO_BE</link>                        (val)
 
63
#define             <link linkend="GINT32-TO-LE--CAPS">GINT32_TO_LE</link>                        (val)
 
64
 
 
65
#define             <link linkend="GUINT32-FROM-BE--CAPS">GUINT32_FROM_BE</link>                     (val)
 
66
#define             <link linkend="GUINT32-FROM-LE--CAPS">GUINT32_FROM_LE</link>                     (val)
 
67
#define             <link linkend="GUINT32-TO-BE--CAPS">GUINT32_TO_BE</link>                       (val)
 
68
#define             <link linkend="GUINT32-TO-LE--CAPS">GUINT32_TO_LE</link>                       (val)
 
69
 
 
70
#define             <link linkend="GINT64-FROM-BE--CAPS">GINT64_FROM_BE</link>                      (val)
 
71
#define             <link linkend="GINT64-FROM-LE--CAPS">GINT64_FROM_LE</link>                      (val)
 
72
#define             <link linkend="GINT64-TO-BE--CAPS">GINT64_TO_BE</link>                        (val)
 
73
#define             <link linkend="GINT64-TO-LE--CAPS">GINT64_TO_LE</link>                        (val)
 
74
 
 
75
#define             <link linkend="GUINT64-FROM-BE--CAPS">GUINT64_FROM_BE</link>                     (val)
 
76
#define             <link linkend="GUINT64-FROM-LE--CAPS">GUINT64_FROM_LE</link>                     (val)
 
77
#define             <link linkend="GUINT64-TO-BE--CAPS">GUINT64_TO_BE</link>                       (val)
 
78
#define             <link linkend="GUINT64-TO-LE--CAPS">GUINT64_TO_LE</link>                       (val)
 
79
 
 
80
#define             <link linkend="GUINT16-SWAP-BE-PDP--CAPS">GUINT16_SWAP_BE_PDP</link>                 (val)
 
81
#define             <link linkend="GUINT16-SWAP-LE-BE--CAPS">GUINT16_SWAP_LE_BE</link>                  (val)
 
82
#define             <link linkend="GUINT16-SWAP-LE-PDP--CAPS">GUINT16_SWAP_LE_PDP</link>                 (val)
 
83
 
 
84
#define             <link linkend="GUINT32-SWAP-BE-PDP--CAPS">GUINT32_SWAP_BE_PDP</link>                 (val)
 
85
#define             <link linkend="GUINT32-SWAP-LE-BE--CAPS">GUINT32_SWAP_LE_BE</link>                  (val)
 
86
#define             <link linkend="GUINT32-SWAP-LE-PDP--CAPS">GUINT32_SWAP_LE_PDP</link>                 (val)
 
87
 
 
88
#define             <link linkend="GUINT64-SWAP-LE-BE--CAPS">GUINT64_SWAP_LE_BE</link>                  (val)
92
89
</synopsis>
93
90
</refsynopsisdiv>
94
91
 
100
97
 
101
98
 
102
99
 
103
 
<refsect1 role="desc">
 
100
<refsect1 id="glib-Byte-Order-Macros.description" role="desc">
104
101
<title role="desc.title">Description</title>
105
102
<para>
106
103
These macros provide a portable way to determine the host byte order
107
 
and to convert values between different byte orders. 
 
104
and to convert values between different byte orders.
108
105
</para>
109
106
<para>
110
107
The byte order is the order in which bytes are stored to create larger
114
111
<para>
115
112
Some processors store the most significant bytes (i.e. the bytes that
116
113
hold the largest part of the value) first. These are known as big-endian
117
 
processors. 
 
114
processors.
118
115
</para>
119
116
<para>
120
117
Other processors (notably the x86 family) store the most significant byte
136
133
as the standard byte order (which is in fact the big-endian byte order).
137
134
</para>
138
135
<para>
139
 
Note that the byte order conversion macros may evaluate their arguments 
 
136
Note that the byte order conversion macros may evaluate their arguments
140
137
multiple times, thus you should not use them with arguments which have
141
138
side-effects.
142
139
</para>
143
140
</refsect1>
144
141
 
145
 
<refsect1 role="details">
 
142
<refsect1 id="glib-Byte-Order-Macros.details" role="details">
146
143
<title role="details.title">Details</title>
147
 
<refsect2>
148
 
<title><anchor id="G-BYTE-ORDER:CAPS" role="macro"/>G_BYTE_ORDER</title>
149
 
<indexterm><primary>G_BYTE_ORDER</primary></indexterm><programlisting>#define G_BYTE_ORDER G_LITTLE_ENDIAN
 
144
<refsect2 id="G-BYTE-ORDER--CAPS" role="macro">
 
145
<title>G_BYTE_ORDER</title>
 
146
<indexterm zone="G-BYTE-ORDER--CAPS"><primary sortas="G_BYTE_ORDER">G_BYTE_ORDER</primary></indexterm><programlisting>#define G_BYTE_ORDER G_LITTLE_ENDIAN
150
147
</programlisting>
151
148
<para>
152
149
The host byte order.
153
 
This can be either <link linkend="G-LITTLE-ENDIAN:CAPS"><type>G_LITTLE_ENDIAN</type></link> or <link linkend="G-BIG-ENDIAN:CAPS"><type>G_BIG_ENDIAN</type></link> (support for
154
 
<link linkend="G-PDP-ENDIAN:CAPS"><type>G_PDP_ENDIAN</type></link> may be added in future.)
155
 
</para></refsect2>
156
 
<refsect2>
157
 
<title><anchor id="G-LITTLE-ENDIAN:CAPS" role="macro"/>G_LITTLE_ENDIAN</title>
158
 
<indexterm><primary>G_LITTLE_ENDIAN</primary></indexterm><programlisting>#define G_LITTLE_ENDIAN 1234
159
 
</programlisting>
160
 
<para>
161
 
Specifies one of the possible types of byte order.
162
 
See <link linkend="G-BYTE-ORDER:CAPS"><type>G_BYTE_ORDER</type></link>.
163
 
</para></refsect2>
164
 
<refsect2>
165
 
<title><anchor id="G-BIG-ENDIAN:CAPS" role="macro"/>G_BIG_ENDIAN</title>
166
 
<indexterm><primary>G_BIG_ENDIAN</primary></indexterm><programlisting>#define G_BIG_ENDIAN    4321
167
 
</programlisting>
168
 
<para>
169
 
Specifies one of the possible types of byte order.
170
 
See <link linkend="G-BYTE-ORDER:CAPS"><type>G_BYTE_ORDER</type></link>.
171
 
</para></refsect2>
172
 
<refsect2>
173
 
<title><anchor id="G-PDP-ENDIAN:CAPS" role="macro"/>G_PDP_ENDIAN</title>
174
 
<indexterm><primary>G_PDP_ENDIAN</primary></indexterm><programlisting>#define G_PDP_ENDIAN    3412              /* unused, need specific PDP check */   
 
150
This can be either <link linkend="G-LITTLE-ENDIAN--CAPS"><type>G_LITTLE_ENDIAN</type></link> or <link linkend="G-BIG-ENDIAN--CAPS"><type>G_BIG_ENDIAN</type></link> (support for
 
151
<link linkend="G-PDP-ENDIAN--CAPS"><type>G_PDP_ENDIAN</type></link> may be added in future.)
 
152
</para></refsect2>
 
153
<refsect2 id="G-LITTLE-ENDIAN--CAPS" role="macro">
 
154
<title>G_LITTLE_ENDIAN</title>
 
155
<indexterm zone="G-LITTLE-ENDIAN--CAPS"><primary sortas="G_LITTLE_ENDIAN">G_LITTLE_ENDIAN</primary></indexterm><programlisting>#define G_LITTLE_ENDIAN 1234
 
156
</programlisting>
 
157
<para>
 
158
Specifies one of the possible types of byte order.
 
159
See <link linkend="G-BYTE-ORDER--CAPS"><type>G_BYTE_ORDER</type></link>.
 
160
</para></refsect2>
 
161
<refsect2 id="G-BIG-ENDIAN--CAPS" role="macro">
 
162
<title>G_BIG_ENDIAN</title>
 
163
<indexterm zone="G-BIG-ENDIAN--CAPS"><primary sortas="G_BIG_ENDIAN">G_BIG_ENDIAN</primary></indexterm><programlisting>#define G_BIG_ENDIAN    4321
 
164
</programlisting>
 
165
<para>
 
166
Specifies one of the possible types of byte order.
 
167
See <link linkend="G-BYTE-ORDER--CAPS"><type>G_BYTE_ORDER</type></link>.
 
168
</para></refsect2>
 
169
<refsect2 id="G-PDP-ENDIAN--CAPS" role="macro">
 
170
<title>G_PDP_ENDIAN</title>
 
171
<indexterm zone="G-PDP-ENDIAN--CAPS"><primary sortas="G_PDP_ENDIAN">G_PDP_ENDIAN</primary></indexterm><programlisting>#define G_PDP_ENDIAN    3412              /* unused, need specific PDP check */   
175
172
</programlisting>
176
173
<para>
177
174
Specifies one of the possible types of byte order (currently unused).
178
 
See <link linkend="G-BYTE-ORDER:CAPS"><type>G_BYTE_ORDER</type></link>.
 
175
See <link linkend="G-BYTE-ORDER--CAPS"><type>G_BYTE_ORDER</type></link>.
179
176
</para></refsect2>
180
 
<refsect2>
181
 
<title><anchor id="g-htonl" role="macro"/>g_htonl()</title>
182
 
<indexterm><primary>g_htonl</primary></indexterm><programlisting>#define             g_htonl(val)</programlisting>
 
177
<refsect2 id="g-htonl" role="macro">
 
178
<title>g_htonl()</title>
 
179
<indexterm zone="g-htonl"><primary sortas="g_htonl">g_htonl</primary></indexterm><programlisting>#define             g_htonl(val)</programlisting>
183
180
<para>
184
181
Converts a 32-bit integer value from host to network byte order.
185
182
</para><variablelist role="params">
186
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
183
<varlistentry><term><parameter>val</parameter>&#160;:</term>
187
184
<listitem><simpara>a 32-bit integer value in host byte order.
188
185
</simpara></listitem></varlistentry>
189
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to network byte order.
190
 
 
191
 
 
 
186
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to network byte order.
192
187
</simpara></listitem></varlistentry>
193
188
</variablelist></refsect2>
194
 
<refsect2>
195
 
<title><anchor id="g-htons" role="macro"/>g_htons()</title>
196
 
<indexterm><primary>g_htons</primary></indexterm><programlisting>#define             g_htons(val)</programlisting>
 
189
<refsect2 id="g-htons" role="macro">
 
190
<title>g_htons()</title>
 
191
<indexterm zone="g-htons"><primary sortas="g_htons">g_htons</primary></indexterm><programlisting>#define             g_htons(val)</programlisting>
197
192
<para>
198
193
Converts a 16-bit integer value from host to network byte order.
199
194
</para><variablelist role="params">
200
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
195
<varlistentry><term><parameter>val</parameter>&#160;:</term>
201
196
<listitem><simpara>a 16-bit integer value in host byte order.
202
197
</simpara></listitem></varlistentry>
203
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to network byte order.
204
 
 
205
 
 
 
198
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to network byte order.
206
199
</simpara></listitem></varlistentry>
207
200
</variablelist></refsect2>
208
 
<refsect2>
209
 
<title><anchor id="g-ntohl" role="macro"/>g_ntohl()</title>
210
 
<indexterm><primary>g_ntohl</primary></indexterm><programlisting>#define             g_ntohl(val)</programlisting>
 
201
<refsect2 id="g-ntohl" role="macro">
 
202
<title>g_ntohl()</title>
 
203
<indexterm zone="g-ntohl"><primary sortas="g_ntohl">g_ntohl</primary></indexterm><programlisting>#define             g_ntohl(val)</programlisting>
211
204
<para>
212
205
Converts a 32-bit integer value from network to host byte order.
213
206
</para><variablelist role="params">
214
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
207
<varlistentry><term><parameter>val</parameter>&#160;:</term>
215
208
<listitem><simpara>a 32-bit integer value in network byte order.
216
209
</simpara></listitem></varlistentry>
217
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
218
 
 
219
 
 
 
210
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
220
211
</simpara></listitem></varlistentry>
221
212
</variablelist></refsect2>
222
 
<refsect2>
223
 
<title><anchor id="g-ntohs" role="macro"/>g_ntohs()</title>
224
 
<indexterm><primary>g_ntohs</primary></indexterm><programlisting>#define             g_ntohs(val)</programlisting>
 
213
<refsect2 id="g-ntohs" role="macro">
 
214
<title>g_ntohs()</title>
 
215
<indexterm zone="g-ntohs"><primary sortas="g_ntohs">g_ntohs</primary></indexterm><programlisting>#define             g_ntohs(val)</programlisting>
225
216
<para>
226
217
Converts a 16-bit integer value from network to host byte order.
227
218
</para><variablelist role="params">
228
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
219
<varlistentry><term><parameter>val</parameter>&#160;:</term>
229
220
<listitem><simpara>a 16-bit integer value in network byte order.
230
221
</simpara></listitem></varlistentry>
231
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
232
 
 
233
 
 
 
222
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
234
223
</simpara></listitem></varlistentry>
235
224
</variablelist></refsect2>
236
 
<refsect2>
237
 
<title><anchor id="GINT-FROM-BE:CAPS" role="macro"/>GINT_FROM_BE()</title>
238
 
<indexterm><primary>GINT_FROM_BE</primary></indexterm><programlisting>#define GINT_FROM_BE(val) (GINT_TO_BE (val))
 
225
<refsect2 id="GINT-FROM-BE--CAPS" role="macro">
 
226
<title>GINT_FROM_BE()</title>
 
227
<indexterm zone="GINT-FROM-BE--CAPS"><primary sortas="GINT_FROM_BE">GINT_FROM_BE</primary></indexterm><programlisting>#define GINT_FROM_BE(val) (GINT_TO_BE (val))
239
228
</programlisting>
240
229
<para>
241
230
Converts a <link linkend="gint"><type>gint</type></link> value from big-endian to host byte order.
242
231
</para><variablelist role="params">
243
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
232
<varlistentry><term><parameter>val</parameter>&#160;:</term>
244
233
<listitem><simpara>a <link linkend="gint"><type>gint</type></link> value in big-endian byte order.
245
234
</simpara></listitem></varlistentry>
246
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
247
 
 
248
 
 
 
235
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
249
236
</simpara></listitem></varlistentry>
250
237
</variablelist></refsect2>
251
 
<refsect2>
252
 
<title><anchor id="GINT-FROM-LE:CAPS" role="macro"/>GINT_FROM_LE()</title>
253
 
<indexterm><primary>GINT_FROM_LE</primary></indexterm><programlisting>#define GINT_FROM_LE(val) (GINT_TO_LE (val))
 
238
<refsect2 id="GINT-FROM-LE--CAPS" role="macro">
 
239
<title>GINT_FROM_LE()</title>
 
240
<indexterm zone="GINT-FROM-LE--CAPS"><primary sortas="GINT_FROM_LE">GINT_FROM_LE</primary></indexterm><programlisting>#define GINT_FROM_LE(val) (GINT_TO_LE (val))
254
241
</programlisting>
255
242
<para>
256
243
Converts a <link linkend="gint"><type>gint</type></link> value from little-endian to host byte order.
257
244
</para><variablelist role="params">
258
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
245
<varlistentry><term><parameter>val</parameter>&#160;:</term>
259
246
<listitem><simpara>a <link linkend="gint"><type>gint</type></link> value in little-endian byte order.
260
247
</simpara></listitem></varlistentry>
261
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
262
 
 
263
 
 
 
248
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
264
249
</simpara></listitem></varlistentry>
265
250
</variablelist></refsect2>
266
 
<refsect2>
267
 
<title><anchor id="GINT-TO-BE:CAPS" role="macro"/>GINT_TO_BE()</title>
268
 
<indexterm><primary>GINT_TO_BE</primary></indexterm><programlisting>#define GINT_TO_BE(val)             ((gint) GINT32_TO_BE (val))
 
251
<refsect2 id="GINT-TO-BE--CAPS" role="macro">
 
252
<title>GINT_TO_BE()</title>
 
253
<indexterm zone="GINT-TO-BE--CAPS"><primary sortas="GINT_TO_BE">GINT_TO_BE</primary></indexterm><programlisting>#define GINT_TO_BE(val)         ((gint) GINT32_TO_BE (val))
269
254
</programlisting>
270
255
<para>
271
256
Converts a <link linkend="gint"><type>gint</type></link> value from host byte order to big-endian.
272
257
</para><variablelist role="params">
273
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
258
<varlistentry><term><parameter>val</parameter>&#160;:</term>
274
259
<listitem><simpara>a <link linkend="gint"><type>gint</type></link> value in host byte order.
275
260
</simpara></listitem></varlistentry>
276
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian byte order.
277
 
 
278
 
 
 
261
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian byte order.
279
262
</simpara></listitem></varlistentry>
280
263
</variablelist></refsect2>
281
 
<refsect2>
282
 
<title><anchor id="GINT-TO-LE:CAPS" role="macro"/>GINT_TO_LE()</title>
283
 
<indexterm><primary>GINT_TO_LE</primary></indexterm><programlisting>#define GINT_TO_LE(val)             ((gint) GINT32_TO_LE (val))
 
264
<refsect2 id="GINT-TO-LE--CAPS" role="macro">
 
265
<title>GINT_TO_LE()</title>
 
266
<indexterm zone="GINT-TO-LE--CAPS"><primary sortas="GINT_TO_LE">GINT_TO_LE</primary></indexterm><programlisting>#define GINT_TO_LE(val)         ((gint) GINT32_TO_LE (val))
284
267
</programlisting>
285
268
<para>
286
269
Converts a <link linkend="gint"><type>gint</type></link> value from host byte order to little-endian.
287
270
</para><variablelist role="params">
288
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
271
<varlistentry><term><parameter>val</parameter>&#160;:</term>
289
272
<listitem><simpara>a <link linkend="gint"><type>gint</type></link> value in host byte order.
290
273
</simpara></listitem></varlistentry>
291
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian byte order.
292
 
 
293
 
 
 
274
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian byte order.
294
275
</simpara></listitem></varlistentry>
295
276
</variablelist></refsect2>
296
 
<refsect2>
297
 
<title><anchor id="GUINT-FROM-BE:CAPS" role="macro"/>GUINT_FROM_BE()</title>
298
 
<indexterm><primary>GUINT_FROM_BE</primary></indexterm><programlisting>#define GUINT_FROM_BE(val)       (GUINT_TO_BE (val))
 
277
<refsect2 id="GUINT-FROM-BE--CAPS" role="macro">
 
278
<title>GUINT_FROM_BE()</title>
 
279
<indexterm zone="GUINT-FROM-BE--CAPS"><primary sortas="GUINT_FROM_BE">GUINT_FROM_BE</primary></indexterm><programlisting>#define GUINT_FROM_BE(val)     (GUINT_TO_BE (val))
299
280
</programlisting>
300
281
<para>
301
282
Converts a <link linkend="guint"><type>guint</type></link> value from big-endian to host byte order.
302
283
</para><variablelist role="params">
303
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
284
<varlistentry><term><parameter>val</parameter>&#160;:</term>
304
285
<listitem><simpara>a <link linkend="guint"><type>guint</type></link> value in big-endian byte order.
305
286
</simpara></listitem></varlistentry>
306
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
307
 
 
308
 
 
 
287
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
309
288
</simpara></listitem></varlistentry>
310
289
</variablelist></refsect2>
311
 
<refsect2>
312
 
<title><anchor id="GUINT-FROM-LE:CAPS" role="macro"/>GUINT_FROM_LE()</title>
313
 
<indexterm><primary>GUINT_FROM_LE</primary></indexterm><programlisting>#define GUINT_FROM_LE(val)       (GUINT_TO_LE (val))
 
290
<refsect2 id="GUINT-FROM-LE--CAPS" role="macro">
 
291
<title>GUINT_FROM_LE()</title>
 
292
<indexterm zone="GUINT-FROM-LE--CAPS"><primary sortas="GUINT_FROM_LE">GUINT_FROM_LE</primary></indexterm><programlisting>#define GUINT_FROM_LE(val)     (GUINT_TO_LE (val))
314
293
</programlisting>
315
294
<para>
316
295
Converts a <link linkend="guint"><type>guint</type></link> value from little-endian to host byte order.
317
296
</para><variablelist role="params">
318
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
297
<varlistentry><term><parameter>val</parameter>&#160;:</term>
319
298
<listitem><simpara>a <link linkend="guint"><type>guint</type></link> value in little-endian byte order.
320
299
</simpara></listitem></varlistentry>
321
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
322
 
 
323
 
 
 
300
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
324
301
</simpara></listitem></varlistentry>
325
302
</variablelist></refsect2>
326
 
<refsect2>
327
 
<title><anchor id="GUINT-TO-BE:CAPS" role="macro"/>GUINT_TO_BE()</title>
328
 
<indexterm><primary>GUINT_TO_BE</primary></indexterm><programlisting>#define GUINT_TO_BE(val)   ((guint) GUINT32_TO_BE (val))
 
303
<refsect2 id="GUINT-TO-BE--CAPS" role="macro">
 
304
<title>GUINT_TO_BE()</title>
 
305
<indexterm zone="GUINT-TO-BE--CAPS"><primary sortas="GUINT_TO_BE">GUINT_TO_BE</primary></indexterm><programlisting>#define GUINT_TO_BE(val)     ((guint) GUINT32_TO_BE (val))
329
306
</programlisting>
330
307
<para>
331
308
Converts a <link linkend="guint"><type>guint</type></link> value from host byte order to big-endian.
332
309
</para><variablelist role="params">
333
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
310
<varlistentry><term><parameter>val</parameter>&#160;:</term>
334
311
<listitem><simpara>a <link linkend="guint"><type>guint</type></link> value in host byte order.
335
312
</simpara></listitem></varlistentry>
336
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian byte order.
337
 
 
338
 
 
 
313
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian byte order.
339
314
</simpara></listitem></varlistentry>
340
315
</variablelist></refsect2>
341
 
<refsect2>
342
 
<title><anchor id="GUINT-TO-LE:CAPS" role="macro"/>GUINT_TO_LE()</title>
343
 
<indexterm><primary>GUINT_TO_LE</primary></indexterm><programlisting>#define GUINT_TO_LE(val)   ((guint) GUINT32_TO_LE (val))
 
316
<refsect2 id="GUINT-TO-LE--CAPS" role="macro">
 
317
<title>GUINT_TO_LE()</title>
 
318
<indexterm zone="GUINT-TO-LE--CAPS"><primary sortas="GUINT_TO_LE">GUINT_TO_LE</primary></indexterm><programlisting>#define GUINT_TO_LE(val)     ((guint) GUINT32_TO_LE (val))
344
319
</programlisting>
345
320
<para>
346
321
Converts a <link linkend="guint"><type>guint</type></link> value from host byte order to little-endian.
347
322
</para><variablelist role="params">
348
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
323
<varlistentry><term><parameter>val</parameter>&#160;:</term>
349
324
<listitem><simpara>a <link linkend="guint"><type>guint</type></link> value in host byte order.
350
325
</simpara></listitem></varlistentry>
351
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian byte order.
352
 
 
353
 
 
 
326
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian byte order.
354
327
</simpara></listitem></varlistentry>
355
328
</variablelist></refsect2>
356
 
<refsect2>
357
 
<title><anchor id="GLONG-FROM-BE:CAPS" role="macro"/>GLONG_FROM_BE()</title>
358
 
<indexterm><primary>GLONG_FROM_BE</primary></indexterm><programlisting>#define GLONG_FROM_BE(val)       (GLONG_TO_BE (val))
 
329
<refsect2 id="GLONG-FROM-BE--CAPS" role="macro">
 
330
<title>GLONG_FROM_BE()</title>
 
331
<indexterm zone="GLONG-FROM-BE--CAPS"><primary sortas="GLONG_FROM_BE">GLONG_FROM_BE</primary></indexterm><programlisting>#define GLONG_FROM_BE(val)     (GLONG_TO_BE (val))
359
332
</programlisting>
360
333
<para>
361
334
Converts a <link linkend="glong"><type>glong</type></link> value from big-endian to the host byte order.
362
335
</para><variablelist role="params">
363
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
336
<varlistentry><term><parameter>val</parameter>&#160;:</term>
364
337
<listitem><simpara>a <link linkend="glong"><type>glong</type></link> value in big-endian byte order.
365
338
</simpara></listitem></varlistentry>
366
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
367
 
 
368
 
 
 
339
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
369
340
</simpara></listitem></varlistentry>
370
341
</variablelist></refsect2>
371
 
<refsect2>
372
 
<title><anchor id="GLONG-FROM-LE:CAPS" role="macro"/>GLONG_FROM_LE()</title>
373
 
<indexterm><primary>GLONG_FROM_LE</primary></indexterm><programlisting>#define GLONG_FROM_LE(val)       (GLONG_TO_LE (val))
 
342
<refsect2 id="GLONG-FROM-LE--CAPS" role="macro">
 
343
<title>GLONG_FROM_LE()</title>
 
344
<indexterm zone="GLONG-FROM-LE--CAPS"><primary sortas="GLONG_FROM_LE">GLONG_FROM_LE</primary></indexterm><programlisting>#define GLONG_FROM_LE(val)     (GLONG_TO_LE (val))
374
345
</programlisting>
375
346
<para>
376
347
Converts a <link linkend="glong"><type>glong</type></link> value from little-endian to host byte order.
377
348
</para><variablelist role="params">
378
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
349
<varlistentry><term><parameter>val</parameter>&#160;:</term>
379
350
<listitem><simpara>a <link linkend="glong"><type>glong</type></link> value in little-endian byte order.
380
351
</simpara></listitem></varlistentry>
381
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
382
 
 
383
 
 
 
352
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
384
353
</simpara></listitem></varlistentry>
385
354
</variablelist></refsect2>
386
 
<refsect2>
387
 
<title><anchor id="GLONG-TO-BE:CAPS" role="macro"/>GLONG_TO_BE()</title>
388
 
<indexterm><primary>GLONG_TO_BE</primary></indexterm><programlisting>#define GLONG_TO_BE(val)   ((glong) GINT32_TO_BE (val))
 
355
<refsect2 id="GLONG-TO-BE--CAPS" role="macro">
 
356
<title>GLONG_TO_BE()</title>
 
357
<indexterm zone="GLONG-TO-BE--CAPS"><primary sortas="GLONG_TO_BE">GLONG_TO_BE</primary></indexterm><programlisting>#define GLONG_TO_BE(val)     ((glong) GINT32_TO_BE (val))
389
358
</programlisting>
390
359
<para>
391
360
Converts a <link linkend="glong"><type>glong</type></link> value from host byte order to big-endian.
392
361
</para><variablelist role="params">
393
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
362
<varlistentry><term><parameter>val</parameter>&#160;:</term>
394
363
<listitem><simpara>a <link linkend="glong"><type>glong</type></link> value in host byte order.
395
364
</simpara></listitem></varlistentry>
396
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian byte order.
397
 
 
398
 
 
 
365
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian byte order.
399
366
</simpara></listitem></varlistentry>
400
367
</variablelist></refsect2>
401
 
<refsect2>
402
 
<title><anchor id="GLONG-TO-LE:CAPS" role="macro"/>GLONG_TO_LE()</title>
403
 
<indexterm><primary>GLONG_TO_LE</primary></indexterm><programlisting>#define GLONG_TO_LE(val)   ((glong) GINT32_TO_LE (val))
 
368
<refsect2 id="GLONG-TO-LE--CAPS" role="macro">
 
369
<title>GLONG_TO_LE()</title>
 
370
<indexterm zone="GLONG-TO-LE--CAPS"><primary sortas="GLONG_TO_LE">GLONG_TO_LE</primary></indexterm><programlisting>#define GLONG_TO_LE(val)     ((glong) GINT32_TO_LE (val))
404
371
</programlisting>
405
372
<para>
406
373
Converts a <link linkend="glong"><type>glong</type></link> value from host byte order to little-endian.
407
374
</para><variablelist role="params">
408
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
375
<varlistentry><term><parameter>val</parameter>&#160;:</term>
409
376
<listitem><simpara>a <link linkend="glong"><type>glong</type></link> value in host byte order.
410
377
</simpara></listitem></varlistentry>
411
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
412
 
 
413
 
 
 
378
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
414
379
</simpara></listitem></varlistentry>
415
380
</variablelist></refsect2>
416
 
<refsect2>
417
 
<title><anchor id="GULONG-FROM-BE:CAPS" role="macro"/>GULONG_FROM_BE()</title>
418
 
<indexterm><primary>GULONG_FROM_BE</primary></indexterm><programlisting>#define GULONG_FROM_BE(val)     (GULONG_TO_BE (val))
 
381
<refsect2 id="GULONG-FROM-BE--CAPS" role="macro">
 
382
<title>GULONG_FROM_BE()</title>
 
383
<indexterm zone="GULONG-FROM-BE--CAPS"><primary sortas="GULONG_FROM_BE">GULONG_FROM_BE</primary></indexterm><programlisting>#define GULONG_FROM_BE(val) (GULONG_TO_BE (val))
419
384
</programlisting>
420
385
<para>
421
386
Converts a <link linkend="gulong"><type>gulong</type></link> value from big-endian to host byte order.
422
387
</para><variablelist role="params">
423
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
388
<varlistentry><term><parameter>val</parameter>&#160;:</term>
424
389
<listitem><simpara>a <link linkend="gulong"><type>gulong</type></link> value in big-endian byte order.
425
390
</simpara></listitem></varlistentry>
426
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
427
 
 
428
 
 
 
391
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
429
392
</simpara></listitem></varlistentry>
430
393
</variablelist></refsect2>
431
 
<refsect2>
432
 
<title><anchor id="GULONG-FROM-LE:CAPS" role="macro"/>GULONG_FROM_LE()</title>
433
 
<indexterm><primary>GULONG_FROM_LE</primary></indexterm><programlisting>#define GULONG_FROM_LE(val)     (GULONG_TO_LE (val))
 
394
<refsect2 id="GULONG-FROM-LE--CAPS" role="macro">
 
395
<title>GULONG_FROM_LE()</title>
 
396
<indexterm zone="GULONG-FROM-LE--CAPS"><primary sortas="GULONG_FROM_LE">GULONG_FROM_LE</primary></indexterm><programlisting>#define GULONG_FROM_LE(val) (GULONG_TO_LE (val))
434
397
</programlisting>
435
398
<para>
436
399
Converts a <link linkend="gulong"><type>gulong</type></link> value from little-endian to host byte order.
437
400
</para><variablelist role="params">
438
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
401
<varlistentry><term><parameter>val</parameter>&#160;:</term>
439
402
<listitem><simpara>a <link linkend="gulong"><type>gulong</type></link> value in little-endian byte order.
440
403
</simpara></listitem></varlistentry>
441
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
442
 
 
443
 
 
 
404
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
444
405
</simpara></listitem></varlistentry>
445
406
</variablelist></refsect2>
446
 
<refsect2>
447
 
<title><anchor id="GULONG-TO-BE:CAPS" role="macro"/>GULONG_TO_BE()</title>
448
 
<indexterm><primary>GULONG_TO_BE</primary></indexterm><programlisting>#define GULONG_TO_BE(val) ((gulong) GUINT32_TO_BE (val))
 
407
<refsect2 id="GULONG-TO-BE--CAPS" role="macro">
 
408
<title>GULONG_TO_BE()</title>
 
409
<indexterm zone="GULONG-TO-BE--CAPS"><primary sortas="GULONG_TO_BE">GULONG_TO_BE</primary></indexterm><programlisting>#define GULONG_TO_BE(val) ((gulong) GUINT32_TO_BE (val))
449
410
</programlisting>
450
411
<para>
451
412
Converts a <link linkend="gulong"><type>gulong</type></link> value from host byte order to big-endian.
452
413
</para><variablelist role="params">
453
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
414
<varlistentry><term><parameter>val</parameter>&#160;:</term>
454
415
<listitem><simpara>a <link linkend="gulong"><type>gulong</type></link> value in host byte order.
455
416
</simpara></listitem></varlistentry>
456
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
457
 
 
458
 
 
 
417
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
459
418
</simpara></listitem></varlistentry>
460
419
</variablelist></refsect2>
461
 
<refsect2>
462
 
<title><anchor id="GULONG-TO-LE:CAPS" role="macro"/>GULONG_TO_LE()</title>
463
 
<indexterm><primary>GULONG_TO_LE</primary></indexterm><programlisting>#define GULONG_TO_LE(val) ((gulong) GUINT32_TO_LE (val))
 
420
<refsect2 id="GULONG-TO-LE--CAPS" role="macro">
 
421
<title>GULONG_TO_LE()</title>
 
422
<indexterm zone="GULONG-TO-LE--CAPS"><primary sortas="GULONG_TO_LE">GULONG_TO_LE</primary></indexterm><programlisting>#define GULONG_TO_LE(val) ((gulong) GUINT32_TO_LE (val))
464
423
</programlisting>
465
424
<para>
466
425
Converts a <link linkend="gulong"><type>gulong</type></link> value from host byte order to little-endian.
467
426
</para><variablelist role="params">
468
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
427
<varlistentry><term><parameter>val</parameter>&#160;:</term>
469
428
<listitem><simpara>a <link linkend="gulong"><type>gulong</type></link> value in host byte order.
470
429
</simpara></listitem></varlistentry>
471
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
472
 
 
473
 
 
 
430
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
474
431
</simpara></listitem></varlistentry>
475
432
</variablelist></refsect2>
476
 
<refsect2>
477
 
<title><anchor id="GINT16-FROM-BE:CAPS" role="macro"/>GINT16_FROM_BE()</title>
478
 
<indexterm><primary>GINT16_FROM_BE</primary></indexterm><programlisting>#define GINT16_FROM_BE(val)     (GINT16_TO_BE (val))
 
433
<refsect2 id="GINT16-FROM-BE--CAPS" role="macro">
 
434
<title>GINT16_FROM_BE()</title>
 
435
<indexterm zone="GINT16-FROM-BE--CAPS"><primary sortas="GINT16_FROM_BE">GINT16_FROM_BE</primary></indexterm><programlisting>#define GINT16_FROM_BE(val) (GINT16_TO_BE (val))
479
436
</programlisting>
480
437
<para>
481
438
Converts a <link linkend="gint16"><type>gint16</type></link> value from big-endian to host byte order.
482
439
</para><variablelist role="params">
483
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
440
<varlistentry><term><parameter>val</parameter>&#160;:</term>
484
441
<listitem><simpara>a <link linkend="gint16"><type>gint16</type></link> value in big-endian byte order.
485
442
</simpara></listitem></varlistentry>
486
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
487
 
 
488
 
 
 
443
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
489
444
</simpara></listitem></varlistentry>
490
445
</variablelist></refsect2>
491
 
<refsect2>
492
 
<title><anchor id="GINT16-FROM-LE:CAPS" role="macro"/>GINT16_FROM_LE()</title>
493
 
<indexterm><primary>GINT16_FROM_LE</primary></indexterm><programlisting>#define GINT16_FROM_LE(val)     (GINT16_TO_LE (val))
 
446
<refsect2 id="GINT16-FROM-LE--CAPS" role="macro">
 
447
<title>GINT16_FROM_LE()</title>
 
448
<indexterm zone="GINT16-FROM-LE--CAPS"><primary sortas="GINT16_FROM_LE">GINT16_FROM_LE</primary></indexterm><programlisting>#define GINT16_FROM_LE(val) (GINT16_TO_LE (val))
494
449
</programlisting>
495
450
<para>
496
451
Converts a <link linkend="gint16"><type>gint16</type></link> value from little-endian to host byte order.
497
452
</para><variablelist role="params">
498
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
453
<varlistentry><term><parameter>val</parameter>&#160;:</term>
499
454
<listitem><simpara>a <link linkend="gint16"><type>gint16</type></link> value in little-endian byte order.
500
455
</simpara></listitem></varlistentry>
501
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
502
 
 
503
 
 
 
456
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
504
457
</simpara></listitem></varlistentry>
505
458
</variablelist></refsect2>
506
 
<refsect2>
507
 
<title><anchor id="GINT16-TO-BE:CAPS" role="macro"/>GINT16_TO_BE()</title>
508
 
<indexterm><primary>GINT16_TO_BE</primary></indexterm><programlisting>#define GINT16_TO_BE(val) ((gint16) GUINT16_SWAP_LE_BE (val))
 
459
<refsect2 id="GINT16-TO-BE--CAPS" role="macro">
 
460
<title>GINT16_TO_BE()</title>
 
461
<indexterm zone="GINT16-TO-BE--CAPS"><primary sortas="GINT16_TO_BE">GINT16_TO_BE</primary></indexterm><programlisting>#define GINT16_TO_BE(val) ((gint16) GUINT16_SWAP_LE_BE (val))
509
462
</programlisting>
510
463
<para>
511
464
Converts a <link linkend="gint16"><type>gint16</type></link> value from host byte order to big-endian.
512
465
</para><variablelist role="params">
513
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
466
<varlistentry><term><parameter>val</parameter>&#160;:</term>
514
467
<listitem><simpara>a <link linkend="gint16"><type>gint16</type></link> value in host byte order.
515
468
</simpara></listitem></varlistentry>
516
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
517
 
 
518
 
 
 
469
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
519
470
</simpara></listitem></varlistentry>
520
471
</variablelist></refsect2>
521
 
<refsect2>
522
 
<title><anchor id="GINT16-TO-LE:CAPS" role="macro"/>GINT16_TO_LE()</title>
523
 
<indexterm><primary>GINT16_TO_LE</primary></indexterm><programlisting>#define GINT16_TO_LE(val) ((gint16) (val))
 
472
<refsect2 id="GINT16-TO-LE--CAPS" role="macro">
 
473
<title>GINT16_TO_LE()</title>
 
474
<indexterm zone="GINT16-TO-LE--CAPS"><primary sortas="GINT16_TO_LE">GINT16_TO_LE</primary></indexterm><programlisting>#define GINT16_TO_LE(val) ((gint16) (val))
524
475
</programlisting>
525
476
<para>
526
477
Converts a <link linkend="gint16"><type>gint16</type></link> value from host byte order to little-endian.
527
478
</para><variablelist role="params">
528
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
479
<varlistentry><term><parameter>val</parameter>&#160;:</term>
529
480
<listitem><simpara>a <link linkend="gint16"><type>gint16</type></link> value in host byte order.
530
481
</simpara></listitem></varlistentry>
531
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
532
 
 
533
 
 
 
482
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
534
483
</simpara></listitem></varlistentry>
535
484
</variablelist></refsect2>
536
 
<refsect2>
537
 
<title><anchor id="GUINT16-FROM-BE:CAPS" role="macro"/>GUINT16_FROM_BE()</title>
538
 
<indexterm><primary>GUINT16_FROM_BE</primary></indexterm><programlisting>#define GUINT16_FROM_BE(val)   (GUINT16_TO_BE (val))
 
485
<refsect2 id="GUINT16-FROM-BE--CAPS" role="macro">
 
486
<title>GUINT16_FROM_BE()</title>
 
487
<indexterm zone="GUINT16-FROM-BE--CAPS"><primary sortas="GUINT16_FROM_BE">GUINT16_FROM_BE</primary></indexterm><programlisting>#define GUINT16_FROM_BE(val)     (GUINT16_TO_BE (val))
539
488
</programlisting>
540
489
<para>
541
490
Converts a <link linkend="guint16"><type>guint16</type></link> value from big-endian to host byte order.
542
491
</para><variablelist role="params">
543
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
492
<varlistentry><term><parameter>val</parameter>&#160;:</term>
544
493
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in big-endian byte order.
545
494
</simpara></listitem></varlistentry>
546
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
547
 
 
548
 
 
 
495
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
549
496
</simpara></listitem></varlistentry>
550
497
</variablelist></refsect2>
551
 
<refsect2>
552
 
<title><anchor id="GUINT16-FROM-LE:CAPS" role="macro"/>GUINT16_FROM_LE()</title>
553
 
<indexterm><primary>GUINT16_FROM_LE</primary></indexterm><programlisting>#define GUINT16_FROM_LE(val)   (GUINT16_TO_LE (val))
 
498
<refsect2 id="GUINT16-FROM-LE--CAPS" role="macro">
 
499
<title>GUINT16_FROM_LE()</title>
 
500
<indexterm zone="GUINT16-FROM-LE--CAPS"><primary sortas="GUINT16_FROM_LE">GUINT16_FROM_LE</primary></indexterm><programlisting>#define GUINT16_FROM_LE(val)     (GUINT16_TO_LE (val))
554
501
</programlisting>
555
502
<para>
556
503
Converts a <link linkend="guint16"><type>guint16</type></link> value from little-endian to host byte order.
557
504
</para><variablelist role="params">
558
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
505
<varlistentry><term><parameter>val</parameter>&#160;:</term>
559
506
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in little-endian byte order.
560
507
</simpara></listitem></varlistentry>
561
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
562
 
 
563
 
 
 
508
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
564
509
</simpara></listitem></varlistentry>
565
510
</variablelist></refsect2>
566
 
<refsect2>
567
 
<title><anchor id="GUINT16-TO-BE:CAPS" role="macro"/>GUINT16_TO_BE()</title>
568
 
<indexterm><primary>GUINT16_TO_BE</primary></indexterm><programlisting>#define GUINT16_TO_BE(val)       (GUINT16_SWAP_LE_BE (val))
 
511
<refsect2 id="GUINT16-TO-BE--CAPS" role="macro">
 
512
<title>GUINT16_TO_BE()</title>
 
513
<indexterm zone="GUINT16-TO-BE--CAPS"><primary sortas="GUINT16_TO_BE">GUINT16_TO_BE</primary></indexterm><programlisting>#define GUINT16_TO_BE(val)     (GUINT16_SWAP_LE_BE (val))
569
514
</programlisting>
570
515
<para>
571
516
Converts a <link linkend="guint16"><type>guint16</type></link> value from host byte order to big-endian.
572
517
</para><variablelist role="params">
573
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
518
<varlistentry><term><parameter>val</parameter>&#160;:</term>
574
519
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in host byte order.
575
520
</simpara></listitem></varlistentry>
576
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
577
 
 
578
 
 
 
521
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
579
522
</simpara></listitem></varlistentry>
580
523
</variablelist></refsect2>
581
 
<refsect2>
582
 
<title><anchor id="GUINT16-TO-LE:CAPS" role="macro"/>GUINT16_TO_LE()</title>
583
 
<indexterm><primary>GUINT16_TO_LE</primary></indexterm><programlisting>#define GUINT16_TO_LE(val)       ((guint16) (val))
 
524
<refsect2 id="GUINT16-TO-LE--CAPS" role="macro">
 
525
<title>GUINT16_TO_LE()</title>
 
526
<indexterm zone="GUINT16-TO-LE--CAPS"><primary sortas="GUINT16_TO_LE">GUINT16_TO_LE</primary></indexterm><programlisting>#define GUINT16_TO_LE(val)     ((guint16) (val))
584
527
</programlisting>
585
528
<para>
586
529
Converts a <link linkend="guint16"><type>guint16</type></link> value from host byte order to little-endian.
587
530
</para><variablelist role="params">
588
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
531
<varlistentry><term><parameter>val</parameter>&#160;:</term>
589
532
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in host byte order.
590
533
</simpara></listitem></varlistentry>
591
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
592
 
 
593
 
 
 
534
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
594
535
</simpara></listitem></varlistentry>
595
536
</variablelist></refsect2>
596
 
<refsect2>
597
 
<title><anchor id="GINT32-FROM-BE:CAPS" role="macro"/>GINT32_FROM_BE()</title>
598
 
<indexterm><primary>GINT32_FROM_BE</primary></indexterm><programlisting>#define GINT32_FROM_BE(val)     (GINT32_TO_BE (val))
 
537
<refsect2 id="GINT32-FROM-BE--CAPS" role="macro">
 
538
<title>GINT32_FROM_BE()</title>
 
539
<indexterm zone="GINT32-FROM-BE--CAPS"><primary sortas="GINT32_FROM_BE">GINT32_FROM_BE</primary></indexterm><programlisting>#define GINT32_FROM_BE(val) (GINT32_TO_BE (val))
599
540
</programlisting>
600
541
<para>
601
542
Converts a <link linkend="gint32"><type>gint32</type></link> value from big-endian to host byte order.
602
543
</para><variablelist role="params">
603
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
544
<varlistentry><term><parameter>val</parameter>&#160;:</term>
604
545
<listitem><simpara>a <link linkend="gint32"><type>gint32</type></link> value in big-endian byte order.
605
546
</simpara></listitem></varlistentry>
606
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
607
 
 
608
 
 
 
547
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
609
548
</simpara></listitem></varlistentry>
610
549
</variablelist></refsect2>
611
 
<refsect2>
612
 
<title><anchor id="GINT32-FROM-LE:CAPS" role="macro"/>GINT32_FROM_LE()</title>
613
 
<indexterm><primary>GINT32_FROM_LE</primary></indexterm><programlisting>#define GINT32_FROM_LE(val)     (GINT32_TO_LE (val))
 
550
<refsect2 id="GINT32-FROM-LE--CAPS" role="macro">
 
551
<title>GINT32_FROM_LE()</title>
 
552
<indexterm zone="GINT32-FROM-LE--CAPS"><primary sortas="GINT32_FROM_LE">GINT32_FROM_LE</primary></indexterm><programlisting>#define GINT32_FROM_LE(val) (GINT32_TO_LE (val))
614
553
</programlisting>
615
554
<para>
616
555
Converts a <link linkend="gint32"><type>gint32</type></link> value from little-endian to host byte order.
617
556
</para><variablelist role="params">
618
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
557
<varlistentry><term><parameter>val</parameter>&#160;:</term>
619
558
<listitem><simpara>a <link linkend="gint32"><type>gint32</type></link> value in little-endian byte order.
620
559
</simpara></listitem></varlistentry>
621
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
622
 
 
623
 
 
 
560
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
624
561
</simpara></listitem></varlistentry>
625
562
</variablelist></refsect2>
626
 
<refsect2>
627
 
<title><anchor id="GINT32-TO-BE:CAPS" role="macro"/>GINT32_TO_BE()</title>
628
 
<indexterm><primary>GINT32_TO_BE</primary></indexterm><programlisting>#define GINT32_TO_BE(val) ((gint32) GUINT32_SWAP_LE_BE (val))
 
563
<refsect2 id="GINT32-TO-BE--CAPS" role="macro">
 
564
<title>GINT32_TO_BE()</title>
 
565
<indexterm zone="GINT32-TO-BE--CAPS"><primary sortas="GINT32_TO_BE">GINT32_TO_BE</primary></indexterm><programlisting>#define GINT32_TO_BE(val) ((gint32) GUINT32_SWAP_LE_BE (val))
629
566
</programlisting>
630
567
<para>
631
568
Converts a <link linkend="gint32"><type>gint32</type></link> value from host byte order to big-endian.
632
569
</para><variablelist role="params">
633
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
570
<varlistentry><term><parameter>val</parameter>&#160;:</term>
634
571
<listitem><simpara>a <link linkend="gint32"><type>gint32</type></link> value in host byte order.
635
572
</simpara></listitem></varlistentry>
636
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
637
 
 
638
 
 
 
573
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
639
574
</simpara></listitem></varlistentry>
640
575
</variablelist></refsect2>
641
 
<refsect2>
642
 
<title><anchor id="GINT32-TO-LE:CAPS" role="macro"/>GINT32_TO_LE()</title>
643
 
<indexterm><primary>GINT32_TO_LE</primary></indexterm><programlisting>#define GINT32_TO_LE(val) ((gint32) (val))
 
576
<refsect2 id="GINT32-TO-LE--CAPS" role="macro">
 
577
<title>GINT32_TO_LE()</title>
 
578
<indexterm zone="GINT32-TO-LE--CAPS"><primary sortas="GINT32_TO_LE">GINT32_TO_LE</primary></indexterm><programlisting>#define GINT32_TO_LE(val) ((gint32) (val))
644
579
</programlisting>
645
580
<para>
646
581
Converts a <link linkend="gint32"><type>gint32</type></link> value from host byte order to little-endian.
647
582
</para><variablelist role="params">
648
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
583
<varlistentry><term><parameter>val</parameter>&#160;:</term>
649
584
<listitem><simpara>a <link linkend="gint32"><type>gint32</type></link> value in host byte order.
650
585
</simpara></listitem></varlistentry>
651
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
652
 
 
653
 
 
 
586
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
654
587
</simpara></listitem></varlistentry>
655
588
</variablelist></refsect2>
656
 
<refsect2>
657
 
<title><anchor id="GUINT32-FROM-BE:CAPS" role="macro"/>GUINT32_FROM_BE()</title>
658
 
<indexterm><primary>GUINT32_FROM_BE</primary></indexterm><programlisting>#define GUINT32_FROM_BE(val)   (GUINT32_TO_BE (val))
 
589
<refsect2 id="GUINT32-FROM-BE--CAPS" role="macro">
 
590
<title>GUINT32_FROM_BE()</title>
 
591
<indexterm zone="GUINT32-FROM-BE--CAPS"><primary sortas="GUINT32_FROM_BE">GUINT32_FROM_BE</primary></indexterm><programlisting>#define GUINT32_FROM_BE(val)     (GUINT32_TO_BE (val))
659
592
</programlisting>
660
593
<para>
661
594
Converts a <link linkend="guint32"><type>guint32</type></link> value from big-endian to host byte order.
662
595
</para><variablelist role="params">
663
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
596
<varlistentry><term><parameter>val</parameter>&#160;:</term>
664
597
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in big-endian byte order.
665
598
</simpara></listitem></varlistentry>
666
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
667
 
 
668
 
 
 
599
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
669
600
</simpara></listitem></varlistentry>
670
601
</variablelist></refsect2>
671
 
<refsect2>
672
 
<title><anchor id="GUINT32-FROM-LE:CAPS" role="macro"/>GUINT32_FROM_LE()</title>
673
 
<indexterm><primary>GUINT32_FROM_LE</primary></indexterm><programlisting>#define GUINT32_FROM_LE(val)   (GUINT32_TO_LE (val))
 
602
<refsect2 id="GUINT32-FROM-LE--CAPS" role="macro">
 
603
<title>GUINT32_FROM_LE()</title>
 
604
<indexterm zone="GUINT32-FROM-LE--CAPS"><primary sortas="GUINT32_FROM_LE">GUINT32_FROM_LE</primary></indexterm><programlisting>#define GUINT32_FROM_LE(val)     (GUINT32_TO_LE (val))
674
605
</programlisting>
675
606
<para>
676
607
Converts a <link linkend="guint32"><type>guint32</type></link> value from little-endian to host byte order.
677
608
</para><variablelist role="params">
678
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
609
<varlistentry><term><parameter>val</parameter>&#160;:</term>
679
610
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in little-endian byte order.
680
611
</simpara></listitem></varlistentry>
681
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
682
 
 
683
 
 
 
612
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
684
613
</simpara></listitem></varlistentry>
685
614
</variablelist></refsect2>
686
 
<refsect2>
687
 
<title><anchor id="GUINT32-TO-BE:CAPS" role="macro"/>GUINT32_TO_BE()</title>
688
 
<indexterm><primary>GUINT32_TO_BE</primary></indexterm><programlisting>#define GUINT32_TO_BE(val)       (GUINT32_SWAP_LE_BE (val))
 
615
<refsect2 id="GUINT32-TO-BE--CAPS" role="macro">
 
616
<title>GUINT32_TO_BE()</title>
 
617
<indexterm zone="GUINT32-TO-BE--CAPS"><primary sortas="GUINT32_TO_BE">GUINT32_TO_BE</primary></indexterm><programlisting>#define GUINT32_TO_BE(val)     (GUINT32_SWAP_LE_BE (val))
689
618
</programlisting>
690
619
<para>
691
620
Converts a <link linkend="guint32"><type>guint32</type></link> value from host byte order to big-endian.
692
621
</para><variablelist role="params">
693
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
622
<varlistentry><term><parameter>val</parameter>&#160;:</term>
694
623
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in host byte order.
695
624
</simpara></listitem></varlistentry>
696
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
697
 
 
698
 
 
 
625
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
699
626
</simpara></listitem></varlistentry>
700
627
</variablelist></refsect2>
701
 
<refsect2>
702
 
<title><anchor id="GUINT32-TO-LE:CAPS" role="macro"/>GUINT32_TO_LE()</title>
703
 
<indexterm><primary>GUINT32_TO_LE</primary></indexterm><programlisting>#define GUINT32_TO_LE(val)       ((guint32) (val))
 
628
<refsect2 id="GUINT32-TO-LE--CAPS" role="macro">
 
629
<title>GUINT32_TO_LE()</title>
 
630
<indexterm zone="GUINT32-TO-LE--CAPS"><primary sortas="GUINT32_TO_LE">GUINT32_TO_LE</primary></indexterm><programlisting>#define GUINT32_TO_LE(val)     ((guint32) (val))
704
631
</programlisting>
705
632
<para>
706
633
Converts a <link linkend="guint32"><type>guint32</type></link> value from host byte order to little-endian.
707
634
</para><variablelist role="params">
708
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
635
<varlistentry><term><parameter>val</parameter>&#160;:</term>
709
636
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in host byte order.
710
637
</simpara></listitem></varlistentry>
711
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
712
 
 
713
 
 
 
638
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
714
639
</simpara></listitem></varlistentry>
715
640
</variablelist></refsect2>
716
 
<refsect2>
717
 
<title><anchor id="GINT64-FROM-BE:CAPS" role="macro"/>GINT64_FROM_BE()</title>
718
 
<indexterm><primary>GINT64_FROM_BE</primary></indexterm><programlisting>#define GINT64_FROM_BE(val)     (GINT64_TO_BE (val))
 
641
<refsect2 id="GINT64-FROM-BE--CAPS" role="macro">
 
642
<title>GINT64_FROM_BE()</title>
 
643
<indexterm zone="GINT64-FROM-BE--CAPS"><primary sortas="GINT64_FROM_BE">GINT64_FROM_BE</primary></indexterm><programlisting>#define GINT64_FROM_BE(val) (GINT64_TO_BE (val))
719
644
</programlisting>
720
645
<para>
721
646
Converts a <link linkend="gint64"><type>gint64</type></link> value from big-endian to host byte order.
722
647
</para><variablelist role="params">
723
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
648
<varlistentry><term><parameter>val</parameter>&#160;:</term>
724
649
<listitem><simpara>a <link linkend="gint64"><type>gint64</type></link> value in big-endian byte order.
725
650
</simpara></listitem></varlistentry>
726
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
727
 
 
728
 
 
 
651
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
729
652
</simpara></listitem></varlistentry>
730
653
</variablelist></refsect2>
731
 
<refsect2>
732
 
<title><anchor id="GINT64-FROM-LE:CAPS" role="macro"/>GINT64_FROM_LE()</title>
733
 
<indexterm><primary>GINT64_FROM_LE</primary></indexterm><programlisting>#define GINT64_FROM_LE(val)     (GINT64_TO_LE (val))
 
654
<refsect2 id="GINT64-FROM-LE--CAPS" role="macro">
 
655
<title>GINT64_FROM_LE()</title>
 
656
<indexterm zone="GINT64-FROM-LE--CAPS"><primary sortas="GINT64_FROM_LE">GINT64_FROM_LE</primary></indexterm><programlisting>#define GINT64_FROM_LE(val) (GINT64_TO_LE (val))
734
657
</programlisting>
735
658
<para>
736
659
Converts a <link linkend="gint64"><type>gint64</type></link> value from little-endian to host byte order.
737
660
</para><variablelist role="params">
738
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
661
<varlistentry><term><parameter>val</parameter>&#160;:</term>
739
662
<listitem><simpara>a <link linkend="gint64"><type>gint64</type></link> value in little-endian byte order.
740
663
</simpara></listitem></varlistentry>
741
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
742
 
 
743
 
 
 
664
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
744
665
</simpara></listitem></varlistentry>
745
666
</variablelist></refsect2>
746
 
<refsect2>
747
 
<title><anchor id="GINT64-TO-BE:CAPS" role="macro"/>GINT64_TO_BE()</title>
748
 
<indexterm><primary>GINT64_TO_BE</primary></indexterm><programlisting>#define GINT64_TO_BE(val) ((gint64) GUINT64_SWAP_LE_BE (val))
 
667
<refsect2 id="GINT64-TO-BE--CAPS" role="macro">
 
668
<title>GINT64_TO_BE()</title>
 
669
<indexterm zone="GINT64-TO-BE--CAPS"><primary sortas="GINT64_TO_BE">GINT64_TO_BE</primary></indexterm><programlisting>#define GINT64_TO_BE(val) ((gint64) GUINT64_SWAP_LE_BE (val))
749
670
</programlisting>
750
671
<para>
751
672
Converts a <link linkend="gint64"><type>gint64</type></link> value from host byte order to big-endian.
752
673
</para><variablelist role="params">
753
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
674
<varlistentry><term><parameter>val</parameter>&#160;:</term>
754
675
<listitem><simpara>a <link linkend="gint64"><type>gint64</type></link> value in host byte order.
755
676
</simpara></listitem></varlistentry>
756
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
757
 
 
758
 
 
 
677
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
759
678
</simpara></listitem></varlistentry>
760
679
</variablelist></refsect2>
761
 
<refsect2>
762
 
<title><anchor id="GINT64-TO-LE:CAPS" role="macro"/>GINT64_TO_LE()</title>
763
 
<indexterm><primary>GINT64_TO_LE</primary></indexterm><programlisting>#define GINT64_TO_LE(val) ((gint64) (val))
 
680
<refsect2 id="GINT64-TO-LE--CAPS" role="macro">
 
681
<title>GINT64_TO_LE()</title>
 
682
<indexterm zone="GINT64-TO-LE--CAPS"><primary sortas="GINT64_TO_LE">GINT64_TO_LE</primary></indexterm><programlisting>#define GINT64_TO_LE(val) ((gint64) (val))
764
683
</programlisting>
765
684
<para>
766
685
Converts a <link linkend="gint64"><type>gint64</type></link> value from host byte order to little-endian.
767
686
</para><variablelist role="params">
768
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
687
<varlistentry><term><parameter>val</parameter>&#160;:</term>
769
688
<listitem><simpara>a <link linkend="gint64"><type>gint64</type></link> value in host byte order.
770
689
</simpara></listitem></varlistentry>
771
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
772
 
 
773
 
 
 
690
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
774
691
</simpara></listitem></varlistentry>
775
692
</variablelist></refsect2>
776
 
<refsect2>
777
 
<title><anchor id="GUINT64-FROM-BE:CAPS" role="macro"/>GUINT64_FROM_BE()</title>
778
 
<indexterm><primary>GUINT64_FROM_BE</primary></indexterm><programlisting>#define GUINT64_FROM_BE(val)   (GUINT64_TO_BE (val))
 
693
<refsect2 id="GUINT64-FROM-BE--CAPS" role="macro">
 
694
<title>GUINT64_FROM_BE()</title>
 
695
<indexterm zone="GUINT64-FROM-BE--CAPS"><primary sortas="GUINT64_FROM_BE">GUINT64_FROM_BE</primary></indexterm><programlisting>#define GUINT64_FROM_BE(val)     (GUINT64_TO_BE (val))
779
696
</programlisting>
780
697
<para>
781
698
Converts a <link linkend="guint64"><type>guint64</type></link> value from big-endian to host byte order.
782
699
</para><variablelist role="params">
783
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
700
<varlistentry><term><parameter>val</parameter>&#160;:</term>
784
701
<listitem><simpara>a <link linkend="guint64"><type>guint64</type></link> value in big-endian byte order.
785
702
</simpara></listitem></varlistentry>
786
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
787
 
 
788
 
 
 
703
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
789
704
</simpara></listitem></varlistentry>
790
705
</variablelist></refsect2>
791
 
<refsect2>
792
 
<title><anchor id="GUINT64-FROM-LE:CAPS" role="macro"/>GUINT64_FROM_LE()</title>
793
 
<indexterm><primary>GUINT64_FROM_LE</primary></indexterm><programlisting>#define GUINT64_FROM_LE(val)   (GUINT64_TO_LE (val))
 
706
<refsect2 id="GUINT64-FROM-LE--CAPS" role="macro">
 
707
<title>GUINT64_FROM_LE()</title>
 
708
<indexterm zone="GUINT64-FROM-LE--CAPS"><primary sortas="GUINT64_FROM_LE">GUINT64_FROM_LE</primary></indexterm><programlisting>#define GUINT64_FROM_LE(val)     (GUINT64_TO_LE (val))
794
709
</programlisting>
795
710
<para>
796
711
Converts a <link linkend="guint64"><type>guint64</type></link> value from little-endian to host byte order.
797
712
</para><variablelist role="params">
798
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
713
<varlistentry><term><parameter>val</parameter>&#160;:</term>
799
714
<listitem><simpara>a <link linkend="guint64"><type>guint64</type></link> value in little-endian byte order.
800
715
</simpara></listitem></varlistentry>
801
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to host byte order.
802
 
 
803
 
 
 
716
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to host byte order.
804
717
</simpara></listitem></varlistentry>
805
718
</variablelist></refsect2>
806
 
<refsect2>
807
 
<title><anchor id="GUINT64-TO-BE:CAPS" role="macro"/>GUINT64_TO_BE()</title>
808
 
<indexterm><primary>GUINT64_TO_BE</primary></indexterm><programlisting>#define GUINT64_TO_BE(val)       (GUINT64_SWAP_LE_BE (val))
 
719
<refsect2 id="GUINT64-TO-BE--CAPS" role="macro">
 
720
<title>GUINT64_TO_BE()</title>
 
721
<indexterm zone="GUINT64-TO-BE--CAPS"><primary sortas="GUINT64_TO_BE">GUINT64_TO_BE</primary></indexterm><programlisting>#define GUINT64_TO_BE(val)     (GUINT64_SWAP_LE_BE (val))
809
722
</programlisting>
810
723
<para>
811
724
Converts a <link linkend="guint64"><type>guint64</type></link> value from host byte order to big-endian.
812
725
</para><variablelist role="params">
813
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
726
<varlistentry><term><parameter>val</parameter>&#160;:</term>
814
727
<listitem><simpara>a <link linkend="guint64"><type>guint64</type></link> value in host byte order.
815
728
</simpara></listitem></varlistentry>
816
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to big-endian.
817
 
 
818
 
 
 
729
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to big-endian.
819
730
</simpara></listitem></varlistentry>
820
731
</variablelist></refsect2>
821
 
<refsect2>
822
 
<title><anchor id="GUINT64-TO-LE:CAPS" role="macro"/>GUINT64_TO_LE()</title>
823
 
<indexterm><primary>GUINT64_TO_LE</primary></indexterm><programlisting>#define GUINT64_TO_LE(val)       ((guint64) (val))
 
732
<refsect2 id="GUINT64-TO-LE--CAPS" role="macro">
 
733
<title>GUINT64_TO_LE()</title>
 
734
<indexterm zone="GUINT64-TO-LE--CAPS"><primary sortas="GUINT64_TO_LE">GUINT64_TO_LE</primary></indexterm><programlisting>#define GUINT64_TO_LE(val)     ((guint64) (val))
824
735
</programlisting>
825
736
<para>
826
737
Converts a <link linkend="guint64"><type>guint64</type></link> value from host byte order to little-endian.
827
738
</para><variablelist role="params">
828
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
739
<varlistentry><term><parameter>val</parameter>&#160;:</term>
829
740
<listitem><simpara>a <link linkend="guint64"><type>guint64</type></link> value in host byte order.
830
741
</simpara></listitem></varlistentry>
831
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to little-endian.
832
 
 
833
 
 
 
742
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to little-endian.
834
743
</simpara></listitem></varlistentry>
835
744
</variablelist></refsect2>
836
 
<refsect2>
837
 
<title><anchor id="GUINT16-SWAP-BE-PDP:CAPS" role="macro"/>GUINT16_SWAP_BE_PDP()</title>
838
 
<indexterm><primary>GUINT16_SWAP_BE_PDP</primary></indexterm><programlisting>#define GUINT16_SWAP_BE_PDP(val)   (GUINT16_SWAP_LE_BE (val))
 
745
<refsect2 id="GUINT16-SWAP-BE-PDP--CAPS" role="macro">
 
746
<title>GUINT16_SWAP_BE_PDP()</title>
 
747
<indexterm zone="GUINT16-SWAP-BE-PDP--CAPS"><primary sortas="GUINT16_SWAP_BE_PDP">GUINT16_SWAP_BE_PDP</primary></indexterm><programlisting>#define GUINT16_SWAP_BE_PDP(val)     (GUINT16_SWAP_LE_BE (val))
839
748
</programlisting>
840
749
<para>
841
750
Converts a <link linkend="guint16"><type>guint16</type></link> value between big-endian and pdp-endian byte order.
842
751
The conversion is symmetric so it can be used both ways.
843
752
</para><variablelist role="params">
844
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
753
<varlistentry><term><parameter>val</parameter>&#160;:</term>
845
754
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in big-endian or pdp-endian byte order.
846
755
</simpara></listitem></varlistentry>
847
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
848
 
 
849
 
 
 
756
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
850
757
</simpara></listitem></varlistentry>
851
758
</variablelist></refsect2>
852
 
<refsect2>
853
 
<title><anchor id="GUINT16-SWAP-LE-BE:CAPS" role="macro"/>GUINT16_SWAP_LE_BE()</title>
854
 
<indexterm><primary>GUINT16_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT16_SWAP_LE_BE(val)</programlisting>
 
759
<refsect2 id="GUINT16-SWAP-LE-BE--CAPS" role="macro">
 
760
<title>GUINT16_SWAP_LE_BE()</title>
 
761
<indexterm zone="GUINT16-SWAP-LE-BE--CAPS"><primary sortas="GUINT16_SWAP_LE_BE">GUINT16_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT16_SWAP_LE_BE(val)</programlisting>
855
762
<para>
856
763
Converts a <link linkend="guint16"><type>guint16</type></link> value between little-endian and big-endian byte order.
857
764
The conversion is symmetric so it can be used both ways.
858
765
</para><variablelist role="params">
859
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
766
<varlistentry><term><parameter>val</parameter>&#160;:</term>
860
767
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in little-endian or big-endian byte order.
861
768
</simpara></listitem></varlistentry>
862
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
863
 
 
864
 
 
 
769
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
865
770
</simpara></listitem></varlistentry>
866
771
</variablelist></refsect2>
867
 
<refsect2>
868
 
<title><anchor id="GUINT16-SWAP-LE-PDP:CAPS" role="macro"/>GUINT16_SWAP_LE_PDP()</title>
869
 
<indexterm><primary>GUINT16_SWAP_LE_PDP</primary></indexterm><programlisting>#define GUINT16_SWAP_LE_PDP(val)   ((guint16) (val))
 
772
<refsect2 id="GUINT16-SWAP-LE-PDP--CAPS" role="macro">
 
773
<title>GUINT16_SWAP_LE_PDP()</title>
 
774
<indexterm zone="GUINT16-SWAP-LE-PDP--CAPS"><primary sortas="GUINT16_SWAP_LE_PDP">GUINT16_SWAP_LE_PDP</primary></indexterm><programlisting>#define GUINT16_SWAP_LE_PDP(val)     ((guint16) (val))
870
775
</programlisting>
871
776
<para>
872
777
Converts a <link linkend="guint16"><type>guint16</type></link> value between little-endian and pdp-endian byte order.
873
778
The conversion is symmetric so it can be used both ways.
874
779
</para><variablelist role="params">
875
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
780
<varlistentry><term><parameter>val</parameter>&#160;:</term>
876
781
<listitem><simpara>a <link linkend="guint16"><type>guint16</type></link> value in little-endian or pdp-endian byte order.
877
782
</simpara></listitem></varlistentry>
878
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
879
 
 
880
 
 
 
783
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
881
784
</simpara></listitem></varlistentry>
882
785
</variablelist></refsect2>
883
 
<refsect2>
884
 
<title><anchor id="GUINT32-SWAP-BE-PDP:CAPS" role="macro"/>GUINT32_SWAP_BE_PDP()</title>
885
 
<indexterm><primary>GUINT32_SWAP_BE_PDP</primary></indexterm><programlisting>#define             GUINT32_SWAP_BE_PDP(val)</programlisting>
 
786
<refsect2 id="GUINT32-SWAP-BE-PDP--CAPS" role="macro">
 
787
<title>GUINT32_SWAP_BE_PDP()</title>
 
788
<indexterm zone="GUINT32-SWAP-BE-PDP--CAPS"><primary sortas="GUINT32_SWAP_BE_PDP">GUINT32_SWAP_BE_PDP</primary></indexterm><programlisting>#define             GUINT32_SWAP_BE_PDP(val)</programlisting>
886
789
<para>
887
790
Converts a <link linkend="guint32"><type>guint32</type></link> value between big-endian and pdp-endian byte order.
888
791
The conversion is symmetric so it can be used both ways.
889
792
</para><variablelist role="params">
890
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
793
<varlistentry><term><parameter>val</parameter>&#160;:</term>
891
794
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in big-endian or pdp-endian byte order.
892
795
</simpara></listitem></varlistentry>
893
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
894
 
 
895
 
 
 
796
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
896
797
</simpara></listitem></varlistentry>
897
798
</variablelist></refsect2>
898
 
<refsect2>
899
 
<title><anchor id="GUINT32-SWAP-LE-BE:CAPS" role="macro"/>GUINT32_SWAP_LE_BE()</title>
900
 
<indexterm><primary>GUINT32_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT32_SWAP_LE_BE(val)</programlisting>
 
799
<refsect2 id="GUINT32-SWAP-LE-BE--CAPS" role="macro">
 
800
<title>GUINT32_SWAP_LE_BE()</title>
 
801
<indexterm zone="GUINT32-SWAP-LE-BE--CAPS"><primary sortas="GUINT32_SWAP_LE_BE">GUINT32_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT32_SWAP_LE_BE(val)</programlisting>
901
802
<para>
902
803
Converts a <link linkend="guint32"><type>guint32</type></link> value between little-endian and big-endian byte order.
903
804
The conversion is symmetric so it can be used both ways.
904
805
</para><variablelist role="params">
905
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
806
<varlistentry><term><parameter>val</parameter>&#160;:</term>
906
807
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in little-endian or big-endian byte order.
907
808
</simpara></listitem></varlistentry>
908
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
909
 
 
910
 
 
 
809
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
911
810
</simpara></listitem></varlistentry>
912
811
</variablelist></refsect2>
913
 
<refsect2>
914
 
<title><anchor id="GUINT32-SWAP-LE-PDP:CAPS" role="macro"/>GUINT32_SWAP_LE_PDP()</title>
915
 
<indexterm><primary>GUINT32_SWAP_LE_PDP</primary></indexterm><programlisting>#define             GUINT32_SWAP_LE_PDP(val)</programlisting>
 
812
<refsect2 id="GUINT32-SWAP-LE-PDP--CAPS" role="macro">
 
813
<title>GUINT32_SWAP_LE_PDP()</title>
 
814
<indexterm zone="GUINT32-SWAP-LE-PDP--CAPS"><primary sortas="GUINT32_SWAP_LE_PDP">GUINT32_SWAP_LE_PDP</primary></indexterm><programlisting>#define             GUINT32_SWAP_LE_PDP(val)</programlisting>
916
815
<para>
917
816
Converts a <link linkend="guint32"><type>guint32</type></link> value between little-endian and pdp-endian byte order.
918
817
The conversion is symmetric so it can be used both ways.
919
818
</para><variablelist role="params">
920
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
819
<varlistentry><term><parameter>val</parameter>&#160;:</term>
921
820
<listitem><simpara>a <link linkend="guint32"><type>guint32</type></link> value in little-endian or pdp-endian byte order.
922
821
</simpara></listitem></varlistentry>
923
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
924
 
 
925
 
 
 
822
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
926
823
</simpara></listitem></varlistentry>
927
824
</variablelist></refsect2>
928
 
<refsect2>
929
 
<title><anchor id="GUINT64-SWAP-LE-BE:CAPS" role="macro"/>GUINT64_SWAP_LE_BE()</title>
930
 
<indexterm><primary>GUINT64_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT64_SWAP_LE_BE(val)</programlisting>
 
825
<refsect2 id="GUINT64-SWAP-LE-BE--CAPS" role="macro">
 
826
<title>GUINT64_SWAP_LE_BE()</title>
 
827
<indexterm zone="GUINT64-SWAP-LE-BE--CAPS"><primary sortas="GUINT64_SWAP_LE_BE">GUINT64_SWAP_LE_BE</primary></indexterm><programlisting>#define             GUINT64_SWAP_LE_BE(val)</programlisting>
931
828
<para>
932
829
Converts a <link linkend="guint64"><type>guint64</type></link> value between little-endian and big-endian byte order.
933
830
The conversion is symmetric so it can be used both ways.
934
831
</para><variablelist role="params">
935
 
<varlistentry><term><parameter>val</parameter>&nbsp;:</term>
 
832
<varlistentry><term><parameter>val</parameter>&#160;:</term>
936
833
<listitem><simpara>a <link linkend="guint64"><type>guint64</type></link> value in little-endian or big-endian byte order.
937
834
</simpara></listitem></varlistentry>
938
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara><parameter>val</parameter> converted to the opposite byte order.
939
 
 
940
 
 
 
835
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>@val converted to the opposite byte order.
941
836
</simpara></listitem></varlistentry>
942
837
</variablelist></refsect2>
943
838
 
946
841
 
947
842
 
948
843
 
949
 
 
950
 
<refsect1><refsect2 /><refsect2 /></refsect1>
951
844
</refentry>