📄 group__endian__rw__fns.htm
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"><title>MiniGUI V1.6.10 API Reference: Endian specific read/write interfaces</title><link href="doxygen.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.4.2 --><div class="qindex"><a class="qindex" href="index.htm">Main Page</a> | <a class="qindex" href="modules.htm">Modules</a> | <a class="qindex" href="classes.htm">Alphabetical List</a> | <a class="qindex" href="annotated.htm">Data Structures</a> | <a class="qindex" href="dirs.htm">Directories</a> | <a class="qindex" href="files.htm">File List</a> | <a class="qindex" href="functions.htm">Data Fields</a> | <a class="qindex" href="globals.htm">Globals</a> | <a class="qindex" href="pages.htm">Related Pages</a></div><h1>Endian specific read/write interfaces<br><small>[<a class="el" href="group__global__fns.htm">Global/general functions</a>]</small></h1><h2>Defines</h2><ul><li>#define <a class="el" href="group__endian__rw__fns.htm#ga23">ArchSwapLE16</a>(X) (X)<li>#define <a class="el" href="group__endian__rw__fns.htm#ga24">ArchSwapLE32</a>(X) (X)<li>#define <a class="el" href="group__endian__rw__fns.htm#ga25">ArchSwapLE64</a>(X) (X)<li>#define <a class="el" href="group__endian__rw__fns.htm#ga26">ArchSwapBE16</a>(X) ArchSwap16(X)<li>#define <a class="el" href="group__endian__rw__fns.htm#ga27">ArchSwapBE32</a>(X) ArchSwap32(X)<li>#define <a class="el" href="group__endian__rw__fns.htm#ga28">ArchSwapBE64</a>(X) ArchSwap64(X)</ul><h2>Functions</h2><ul><li><a class="el" href="group__basic__types.htm#ga2">Uint16</a> <a class="el" href="group__endian__rw__fns.htm#ga2">MGUI_ReadLE16</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 16-bit little endian integer from a MG_RWops object. <a href="#ga2"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga2">Uint16</a> <a class="el" href="group__endian__rw__fns.htm#ga3">MGUI_ReadBE16</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 16-bit big endian integer from a MG_RWops object. <a href="#ga3"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga4">Uint32</a> <a class="el" href="group__endian__rw__fns.htm#ga4">MGUI_ReadLE32</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 32-bit little endian integer from a MG_RWops object. <a href="#ga4"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga4">Uint32</a> <a class="el" href="group__endian__rw__fns.htm#ga5">MGUI_ReadBE32</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 32-bit big endian integer from a MG_RWops object. <a href="#ga5"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga6">Uint64</a> <a class="el" href="group__endian__rw__fns.htm#ga6">MGUI_ReadLE64</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 64-bit little endian integer from a MG_RWops object. <a href="#ga6"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga6">Uint64</a> <a class="el" href="group__endian__rw__fns.htm#ga7">MGUI_ReadBE64</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *src)<dl class="el"><dd class="mdescRight">Reads a 64-bit big endian integer from a MG_RWops object. <a href="#ga7"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga8">MGUI_WriteLE16</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga2">Uint16</a> value)<dl class="el"><dd class="mdescRight">Writes an 16-bit integer of native format to a MG_RWops object in littlen endianness. <a href="#ga8"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga9">MGUI_WriteBE16</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga2">Uint16</a> value)<dl class="el"><dd class="mdescRight">Writes an 16-bit integer of native format to a MG_RWops object in big endianness. <a href="#ga9"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga10">MGUI_WriteLE32</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga4">Uint32</a> value)<dl class="el"><dd class="mdescRight">Writes an 32-bit integer of native format to a MG_RWops object in littlen endianness. <a href="#ga10"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga11">MGUI_WriteBE32</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga4">Uint32</a> value)<dl class="el"><dd class="mdescRight">Writes an 32-bit integer of native format to a MG_RWops object in big endianness. <a href="#ga11"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga12">MGUI_WriteLE64</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga6">Uint64</a> value)<dl class="el"><dd class="mdescRight">Writes an 64-bit integer of native format to a MG_RWops object in littlen endianness. <a href="#ga12"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga13">MGUI_WriteBE64</a> (<a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *dst, <a class="el" href="group__basic__types.htm#ga6">Uint64</a> value)<dl class="el"><dd class="mdescRight">Writes an 64-bit integer of native format to a MG_RWops object in big endianness. <a href="#ga13"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga2">Uint16</a> <a class="el" href="group__endian__rw__fns.htm#ga14">MGUI_ReadLE16FP</a> (FILE *src)<dl class="el"><dd class="mdescRight">Reads a 16-bit little endian integer from a stdio FILE object. <a href="#ga14"></a><br></dl><li><a class="el" href="group__basic__types.htm#ga4">Uint32</a> <a class="el" href="group__endian__rw__fns.htm#ga15">MGUI_ReadLE32FP</a> (FILE *src)<dl class="el"><dd class="mdescRight">Reads a 32-bit little endian integer from a stdio FILE object. <a href="#ga15"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga16">MGUI_WriteLE16FP</a> (FILE *dst, <a class="el" href="group__basic__types.htm#ga2">Uint16</a> value)<dl class="el"><dd class="mdescRight">Writes an 16-bit integer of native format to a stdio FILE object in littlen endianness. <a href="#ga16"></a><br></dl><li>int <a class="el" href="group__endian__rw__fns.htm#ga17">MGUI_WriteLE32FP</a> (FILE *dst, <a class="el" href="group__basic__types.htm#ga4">Uint32</a> value)<dl class="el"><dd class="mdescRight">Writes an 32-bit integer of native format to a stdio FILE object in littlen endianness. <a href="#ga17"></a><br></dl></ul><hr><a name="_details"></a><h2>Detailed Description</h2>The endian specific read/write functions read and write data of the specified endianness, dynamically translating to the host machine endianness.<p>e.g.: If you want to read a 16 bit value on big-endian machine from an opened file containing little endian values, you would use:<p><div class="fragment"><pre class="fragment"> value = <a class="code" href="group__endian__rw__fns.htm#ga2">MGUI_ReadLE16</a>(rp);</pre></div><p><dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm">General read/write operations</a></dd></dl>Example:<p><div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> fd, len_header;... <span class="keywordflow">if</span> (read (fd, &len_header, <span class="keyword">sizeof</span> (<span class="keywordtype">int</span>)) == -1) <span class="keywordflow">goto</span> error;<span class="preprocessor">#if MGUI_BYTEORDER == MGUI_BIG_ENDIAN</span><span class="preprocessor"></span> <span class="comment">/* If the native system is big endian, calling ArchSwap32 to</span><span class="comment"> * swap the bytes.</span><span class="comment"> */</span> len_header = ArchSwap32 (len_header);<span class="preprocessor">#endif</span><span class="preprocessor"></span>...</pre></div> <hr><h2>Define Documentation</h2><a class="anchor" name="ga26" doxytag="endianrw.h::ArchSwapBE16"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapBE16 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> ArchSwap16(X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 16-bit big endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00434">434</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><a class="anchor" name="ga27" doxytag="endianrw.h::ArchSwapBE32"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapBE32 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> ArchSwap32(X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 32-bit big endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00436">436</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><a class="anchor" name="ga28" doxytag="endianrw.h::ArchSwapBE64"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapBE64 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> ArchSwap64(X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 64-bit big endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00438">438</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><a class="anchor" name="ga23" doxytag="endianrw.h::ArchSwapLE16"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapLE16 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> (X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 16-bit little endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00428">428</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><a class="anchor" name="ga24" doxytag="endianrw.h::ArchSwapLE32"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapLE32 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> (X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 32-bit little endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00430">430</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><a class="anchor" name="ga25" doxytag="endianrw.h::ArchSwapLE64"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define ArchSwapLE64 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">X </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> (X)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Swaps a 64-bit little endian integer to the native endianness. <p>Definition at line <a class="el" href="endianrw_8h-source.htm#l00432">432</a> of file <a class="el" href="endianrw_8h-source.htm">endianrw.h</a>. </td> </tr></table><hr><h2>Function Documentation</h2><a class="anchor" name="ga3" doxytag="endianrw.h::MGUI_ReadBE16"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"><a class="el" href="group__basic__types.htm#ga2">Uint16</a> MGUI_ReadBE16 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> * </td> <td class="mdname1" valign="top" nowrap> <em>src</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Reads a 16-bit big endian integer from a MG_RWops object. <p>This function reads a 16-bit big endian integer from the data source pointed to by <em>src</em>, and return it in native format.<p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The pointer to the MG_RWops object. </td></tr> </table></dl><dl compact><dt><b>Returns:</b></dt><dd>The integer in native endianness.</dd></dl><dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__endian__rw__fns.htm#ga9">MGUI_WriteBE16</a> </dd></dl> </td> </tr></table><a class="anchor" name="ga5" doxytag="endianrw.h::MGUI_ReadBE32"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"><a class="el" href="group__basic__types.htm#ga4">Uint32</a> MGUI_ReadBE32 </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> * </td> <td class="mdname1" valign="top" nowrap> <em>src</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>Reads a 32-bit big endian integer from a MG_RWops object. <p>This function reads a 32-bit big endian integer from the data source pointed to by <em>src</em>, and return it in native format.<p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The pointer to the MG_RWops object. </td></tr> </table></dl>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -