首頁 探索 說明
註冊 登入
Apq
/
winscp
镜像来自 https://github.com/winscp/winscp.git
1
0
複刻 0
Files 問題管理 0 Wiki
分支: thirdparty_dev
分支列表 標籤列表
winscp
/
libs
/
neon
/
doc
/
html
/
refiaddr.html

refiaddr.html 8.9 KB
永久連結 文件歷史 原始文件

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253 
  1. <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_iaddr_make</title><link rel="stylesheet" type="text/css" href="manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refi18n.html" title="ne_i18n_init"><link rel="next" href="refalloc.html" title="ne_malloc"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_iaddr_make</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refi18n.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refalloc.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refiaddr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_iaddr_make, ne_iaddr_cmp, ne_iaddr_print, ne_iaddr_typeof, ne_iaddr_parse, ne_iaddr_raw, ne_iaddr_reverse, ne_iaddr_free — functions to manipulate network addresses</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_socket.h&gt;
    2. 

  2. 

  3. typedef enum {
    4. 

  4.     ne_iaddr_ipv4 = 0,
    5. 

  5.     ne_iaddr_ipv6
    6. 

  6. } <em class="type">ne_iaddr_type</em>;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">ne_inet_addr *<b class="fsfunc">ne_iaddr_make</b>(</code></td><td>ne_iaddr_type <var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const unsigned char *<var class="pdparam">raw</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_iaddr_cmp</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia1</var>, </td></tr><tr><td> </td><td>const ne_inet_addr *<var class="pdparam">ia2</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">char *<b class="fsfunc">ne_iaddr_print</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia</var>, </td></tr><tr><td> </td><td>char *<var class="pdparam">buffer</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">bufsiz</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">ne_iaddr_type <b class="fsfunc">ne_iaddr_typeof</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">ne_inet_addr *<b class="fsfunc">ne_iaddr_parse</b>(</code></td><td>const char *<var class="pdparam">address</var>, </td></tr><tr><td> </td><td>ne_iaddr_type <var class="pdparam">type</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">unsigned char *<b class="fsfunc">ne_iaddr_raw</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia</var>, </td></tr><tr><td> </td><td>unsigned char *<var class="pdparam">buffer</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_iaddr_reverse</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia</var>, </td></tr><tr><td> </td><td>char *<var class="pdparam">buffer</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">buflen</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">ne_iaddr_free</b>(</code></td><td>const ne_inet_addr *<var class="pdparam">ia</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="id2677"></a><h2>Description</h2><p><code class="function">ne_iaddr_make</code> creates an
    7. 

  7.     <em class="type">ne_inet_addr</em> object from a raw binary network
    8. 

  8.     address; for instance the four bytes <code class="literal">0x7f 0x00 0x00
    9. 

  9.     0x01</code> represent the IPv4 address
    10. 

  10.     <code class="literal">127.0.0.1</code>.  The object returned is suitable for
    11. 

  11.     passing to <code class="function">ne_sock_connect</code>.  A binary IPv4
    12. 

  12.     address contains four bytes; a binary IPv6 address contains
    13. 

  13.     sixteen bytes; addresses passed must be in network byte
    14. 

  14.     order.</p><p><code class="function">ne_iaddr_cmp</code> compares two network
    15. 

  15.     address objects; returning zero only if they are identical.  The
    16. 

  16.     objects need not have the same address type; if the addresses are
    17. 

  17.     not of the same type, the return value is guaranteed to be
    18. 

  18.     non-zero.</p><p><code class="function">ne_iaddr_print</code> prints a human-readable
    19. 

  19.     string representation of a network address into a buffer, for
    20. 

  20.     instance the string <code class="literal">"127.0.0.1"</code>.</p><p><code class="function">ne_iaddr_typeof</code> returns the type of the
    21. 

  21.     given network address object.</p><p><code class="function">ne_iaddr_parse</code> parses a string
    22. 

  22.     representation of a network address (such as
    23. 

  23.     <code class="literal">"127.0.0.1"</code> and creates a network address
    24. 

  24.     object to represent the parsed address.</p><p><code class="function">ne_iaddr_raw</code> writes the raw byte
    25. 

  25.     representation of a network address to the provided buffer.  The
    26. 

  26.     bytes are written in network byte order; the buffer must be of
    27. 

  27.     suitable length for the type of address (4 bytes for an IPv4
    28. 

  28.     address, 16 bytes for an IPv6 address).</p><p><code class="function">ne_iaddr_reverse</code> performs a reverse
    29. 

  29.     name lookup on the address object, writing the (first) hostname
    30. 

  30.     associated with the IP address to the provided buffer.  If the
    31. 

  31.     hostname is longer than the buffer it will be silently truncated;
    32. 

  32.     on success the string written to the buffer is always
    33. 

  33.     <code class="literal">NUL</code>-terminated.</p><p><code class="function">ne_iaddr_free</code> releases the memory
    34. 

  34.     associated with a network address object.</p></div><div class="refsect1"><a name="id2702"></a><h2>Return value</h2><p><code class="function">ne_iaddr_make</code> returns <code class="literal">NULL</code> if the
    35. 

  35.     address type passed is not supported (for instance on a platform
    36. 

  36.     which does not support IPv6).</p><p><code class="function">ne_iaddr_print</code> returns the
    37. 

  37.     <code class="parameter">buffer</code> pointer, and never <code class="literal">NULL</code>.</p><p><code class="function">ne_iaddr_parse</code> returns a network
    38. 

  38.     address object on success, or <code class="literal">NULL</code> on failure to parse the
    39. 

  39.     <code class="parameter">address</code> parameter.</p><p><code class="function">ne_iaddr_reverse</code> returns zero on
    40. 

  40.     success or non-zero if no hostname is associated with the
    41. 

  41.     address.</p><p><code class="function">ne_iaddr_raw</code> returns the
    42. 

  42.     <code class="parameter">buffer</code> parameter, and never <code class="literal">NULL</code>.</p></div><div class="refsect1"><a name="id2721"></a><h2>Examples</h2><p>The following example connects a socket to port 80 at the
    43. 

  43.     address <code class="literal">127.0.0.1</code>.</p><pre class="programlisting">unsigned char addr[] = "\0x7f\0x00\0x00\0x01";
    44. 

  44. ne_inet_addr *ia;
    45. 

  45. 

  46. ia = ne_iaddr_make(ne_iaddr_ipv4, addr);
    47. 

  47. if (ia != NULL) {
    48. 

  48.     ne_socket *sock = ne_sock_connect(ia, 80);
    49. 

  49.     ne_iaddr_free(ia);
    50. 

  50.     /* ... */
    51. 

  51. } else {
    52. 

  52.     /* ... */
    53. 

  53. }</pre></div><div class="refsect1"><a name="id2726"></a><h2>See also</h2><p><a class="xref" href="refresolve.html#ne_addr_resolve">ne_addr_resolve</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refi18n.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refalloc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_i18n_init </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_malloc</td></tr></table></div></body></html>
    54.