group__general__rw__fns.htm

MINIGUI1.6开发API

  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
The read/write operation structure.     </td>
  </tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="ga5" doxytag="endianrw.h::MGUI_AllocRW"></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="struct__MG__RWops.htm">MG_RWops</a> * MGUI_AllocRW           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Allocates an uninitialized MG_RWops object. 
<p>
This function allocates an uninitialized MG_RWops object. You can specify the fields of the structure, and implemente a customized MG_RWops object.<p>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to allocated MG_RWops structure, NULL indicates error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga0">MG_RWops</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga6" doxytag="endianrw.h::MGUI_FreeRW"></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">void MGUI_FreeRW           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>area</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Frees an MG_RWops object. 
<p>
This function frees the MG_RWops object pointed to by <em>area</em>.<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>area</em>&nbsp;</td><td>The pointer to the MG_RWops object.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga1">MGUI_RWFromFile</a>, <a class="el" href="group__general__rw__fns.htm#ga2">MGUI_RWFromFP</a>, <a class="el" href="group__general__rw__fns.htm#ga3">MGUI_RWFromMem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga4" doxytag="endianrw.h::MGUI_InitMemRW"></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">void MGUI_InitMemRW           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>area</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>void *&nbsp;</td>
          <td class="mdname" nowrap> <em>mem</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>size</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Initializes an MG_RWops object from a block of memory. 
<p>
This function initializes an MG_RWops object pointed to by <em>area</em> from a block of memory pointed to by <em>mem</em>, which is <em>size</em> bytes long.<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>area</em>&nbsp;</td><td>The pointer to the MG_RWops object. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mem</em>&nbsp;</td><td>The pointer to the memory block. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>size</em>&nbsp;</td><td>The size of the memory block.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga0">MG_RWops</a>, <a class="el" href="group__general__rw__fns.htm#ga6">MGUI_FreeRW</a>, <a class="el" href="group__general__rw__fns.htm#ga3">MGUI_RWFromMem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga1" doxytag="endianrw.h::MGUI_RWFromFile"></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="struct__MG__RWops.htm">MG_RWops</a> * MGUI_RWFromFile           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>file</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>mode</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Creates an MG_RWops object from a file. 
<p>
This function uses the mode specified by <em>mode</em> and opens the file <em>file</em> by using stdio function <em>fopen</em>. If success, this function creates a MG_RWops object and returns it.<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>file</em>&nbsp;</td><td>The file name. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The mode will be passed to <em>fopen</em>. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to created MG_RWops structure, NULL indicates error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga0">MG_RWops</a>, <a class="el" href="group__general__rw__fns.htm#ga2">MGUI_RWFromFP</a>, <a class="el" href="group__general__rw__fns.htm#ga6">MGUI_FreeRW</a>, fopen(3) </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga2" doxytag="endianrw.h::MGUI_RWFromFP"></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="struct__MG__RWops.htm">MG_RWops</a> * MGUI_RWFromFP           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">FILE *&nbsp;</td>
          <td class="mdname" nowrap> <em>fp</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>autoclose</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Creates an MG_RWops object from an opened stdio FILE object. 
<p>
This function uses an opened stdio FILE object <em>fp</em> to create a MG_RWops object.<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>fp</em>&nbsp;</td><td>The opened stdio FILE object. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>autoclose</em>&nbsp;</td><td>Indicates whether to close the FILE object when <em>close</em> method is called. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to created MG_RWops structure, NULL indicates error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga0">MG_RWops</a>, <a class="el" href="group__general__rw__fns.htm#ga1">MGUI_RWFromFile</a>, <a class="el" href="group__general__rw__fns.htm#ga6">MGUI_FreeRW</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga3" doxytag="endianrw.h::MGUI_RWFromMem"></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="struct__MG__RWops.htm">MG_RWops</a> * MGUI_RWFromMem           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void *&nbsp;</td>
          <td class="mdname" nowrap> <em>mem</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>size</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Creates an MG_RWops object from a block of memory. 
<p>
This function creates an MG_RWops object from a block of memory pointed to by <em>mem</em>, which is <em>size</em> bytes long.<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>mem</em>&nbsp;</td><td>The pointer to the memory block. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>size</em>&nbsp;</td><td>The size of the memory block.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to created MG_RWops structure, NULL indicates error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga0">MG_RWops</a>, <a class="el" href="group__general__rw__fns.htm#ga6">MGUI_FreeRW</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="endianrw.h::MGUI_RWgetc"></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">int MGUI_RWgetc           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>area</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Reads the next character from an data source. 
<p>
This function reads the next character from the data source pointed to by <em>area</em>, and returns it as an <em>unsigned</em> char cast to an <em>int</em>, or <em>EOF</em> on end of file or error.<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>area</em>&nbsp;</td><td>The pointer to the MG_RWops object.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The character read, <em>EOF</em> indicates end-of-file or error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__general__rw__fns.htm#ga13">MGUI_RWread</a> </dd></dl>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:53 2007 for MiniGUI V1.6.10 API Reference by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="http://www.minigui.com/api_ref/1.6.10/doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.2 </small></address>
</body>
</html>