<html> <head><title>ClanLib Reference: CL_IPAddress</title></head> <body text=black link=blue vlink=#800080 bgcolor=white topmargin=0 leftmargin=0> <table border=0 cellspacing=0 cellpadding=0 width=100%><tr><td><img border=0 src="../images/eyeheader-main-purple-a.gif" alt="ClanSoft logo" width=525 height=96></td></tr> <tr bgcolor=#dadada><td align=left valign=top><img border=0 src="../images/eyeheader-main-purple-b.gif" alt="ClanSoft logo" width=190 height=14></td><td align=right valign=top><img border=0 src="../images/clanlib_light.gif" width=42 height=14></td></tr></table> <table align=center border=0 cellspacing=10> <tr> <td><a href="entire_class_index.html">Entire Class Index</a></td> <td><a href="class_index.html">Main Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="global_index.html">Global Index</a></td> </table><h1 align=center>Class CL_IPAddress</h1><p> <b> Socket name; container class for an IP address and port.</b><br> Contained in: <a href="global_index.html">global</a><br> Derived from: <i>none</i> <br> Derived by: <i>none</i> <br>Group: Network (Sockets) <p> #include <ClanLib/network.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=left><h3>Construction:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2194"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2195"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2196"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt><font color=purple>void</font></tt>* <tt><font color=blue>address</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2197"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt> <tt><font color=blue>address</font></tt>, <tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2198"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>hostname</font></tt>, <tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>copy</font></tt>)</tt>;</td> <tr valign=top><td align=left><h3>Attributes:</h3></td> <tr valign=top><td align=right><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2200"><tt><font color=blue><b>get_address</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt>*</tt> </td><td align=right><a href="CL_IPAddress.html#2201"><tt><font color=blue><b>get_address6</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=navy>short</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2202"><tt><font color=blue><b>get_port</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>char</font></tt>&</tt> </td><td align=right><a href="CL_IPAddress.html#2203"><tt><font color=black><b>operator</b></font></tt><tt> []</tt></a></td><td><tt>(<tt><font color=purple>int</font></tt> <tt><font color=blue>i</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>unsigned</font></tt> <tt><font color=purple>char</font></tt>&</tt> </td><td align=right><a href="CL_IPAddress.html#2204"><tt><font color=black><b>operator</b></font></tt><tt> []</tt></a></td><td><tt>(<tt><font color=purple>int</font></tt> <tt><font color=blue>i</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2205"><tt><font color=black><b>operator</b></font></tt><tt> == </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2206"><tt><font color=black><b>operator</b></font></tt><tt> < </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2207"><tt><font color=black><b>operator</b></font></tt><tt> > </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=left><h3>Operations:</h3></td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2208"><tt><font color=blue><b>set_address</b></font></tt></a></td><td><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt> <tt><font color=blue>new_ip</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2209"><tt><font color=blue><b>set_address</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>hostname</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2210"><tt><font color=blue><b>set_port</b></font></tt></a></td><td><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>new_port</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>std::string</font></tt></tt> </td><td align=right><a href="CL_IPAddress.html#2211"><tt><font color=blue><b>dns_lookup</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2194"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Constructs an IP address using INADDR_ANY and port 0.<br><tt></tt> <a href="CL_IPAddress.html#2194"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>()</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2195"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Constructs an IP address using INADDR_ANY and the specified port.<br><tt></tt> <a href="CL_IPAddress.html#2195"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2196"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Constructor for IPv6 address<br><tt></tt> <a href="CL_IPAddress.html#2196"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt><font color=purple>void</font></tt>* <tt><font color=blue>address</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2197"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Constructs an IP address using the passed address and port.<br><tt></tt> <a href="CL_IPAddress.html#2197"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt> <tt><font color=blue>address</font></tt>, <tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2198"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Construct an IP address using a hostname.<br><tt></tt> <a href="CL_IPAddress.html#2198"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>hostname</font></tt>, <tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>port</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2199"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Copy constructor.<br><tt></tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>copy</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2211"><font size=+1><b>CL_IPAddress::dns_lookup</b></font></a> - Do a DNS lookup on the IP address.<br><tt><tt><font color=navy>std::string</font></tt></tt> <a href="CL_IPAddress.html#2211"><tt><font color=blue><b>dns_lookup</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2200"><font size=+1><b>CL_IPAddress::get_address</b></font></a> - Returns the IP address in network byte order.<br><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt></tt> <a href="CL_IPAddress.html#2200"><tt><font color=blue><b>get_address</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2202"><font size=+1><b>CL_IPAddress::get_port</b></font></a> - Returns the IP port in host byte order.<br><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=navy>short</font></tt></tt> <a href="CL_IPAddress.html#2202"><tt><font color=blue><b>get_port</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2206"><font size=+1><b>CL_IPAddress::operator < </b></font></a> - Returns true if the other address is less. This is used for sorting purposes (eg. if you use a std::map<CL_IPAddress, CL_Socket>), and sorts the address based on lowest IP number address.<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_IPAddress.html#2206"><tt><font color=black><b>operator</b></font></tt><tt> < </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2205"><font size=+1><b>CL_IPAddress::operator == </b></font></a> - Returns true if objects are the same.<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_IPAddress.html#2205"><tt><font color=black><b>operator</b></font></tt><tt> == </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2207"><font size=+1><b>CL_IPAddress::operator > </b></font></a> - Returns true if the other address is greater. This is used for sorting purposes (eg. if you use a std::map<CL_IPAddress, CL_Socket>), and sorts the address based on lowest IP number address.<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_IPAddress.html#2207"><tt><font color=black><b>operator</b></font></tt><tt> > </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2199"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a>& <tt><font color=blue>other_instance</font></tt>) <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2203"><font size=+1><b>CL_IPAddress::operator []</b></font></a> - Returns the specified address field.<br><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>char</font></tt>&</tt> <a href="CL_IPAddress.html#2203"><tt><font color=black><b>operator</b></font></tt><tt> []</tt></a><tt>(<tt><font color=purple>int</font></tt> <tt><font color=blue>i</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2204"><font size=+1><b>CL_IPAddress::operator []</b></font></a> - Returns the specified address field.<br><tt><tt>const</tt> <tt><font color=navy>unsigned</font></tt> <tt><font color=purple>char</font></tt>&</tt> <a href="CL_IPAddress.html#2204"><tt><font color=black><b>operator</b></font></tt><tt> []</tt></a><tt>(<tt><font color=purple>int</font></tt> <tt><font color=blue>i</font></tt>) <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2208"><font size=+1><b>CL_IPAddress::set_address</b></font></a> - Set the IP address, in network byte order.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_IPAddress.html#2208"><tt><font color=blue><b>set_address</b></font></tt></a><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt> <tt><font color=blue>new_ip</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2209"><font size=+1><b>CL_IPAddress::set_address</b></font></a> - Set the IP address using a hostname.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_IPAddress.html#2209"><tt><font color=blue><b>set_address</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>hostname</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2210"><font size=+1><b>CL_IPAddress::set_port</b></font></a> - Set the IP port.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_IPAddress.html#2210"><tt><font color=blue><b>set_port</b></font></tt></a><tt>(<tt><font color=navy>unsigned</font></tt> <tt><font color=blue>short</font></tt> <tt><font color=blue>new_port</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <hr noshade> <h2>Variable Member Descriptions:</h2> <hr noshade> </body> </html>