<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#2816"><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#2817"><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#2818"><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#2819"><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#2820"><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#2821"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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#2822"><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#2823"><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#2824"><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#2825"><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#2826"><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#2827"><tt><font color=black><b>operator</b></font></tt><tt> == </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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#2828"><tt><font color=black><b>operator</b></font></tt><tt> < </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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#2829"><tt><font color=black><b>operator</b></font></tt><tt> > </tt></a></td><td><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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#2830"><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#2831"><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#2832"><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#2833"><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="2816"><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#2816"><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="2817"><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#2817"><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="2818"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Constructor for IPv6 address<br><tt></tt> <a href="CL_IPAddress.html#2818"><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="2819"><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#2819"><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="2820"><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#2820"><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="2821"><font size=+1><b>CL_IPAddress::CL_IPAddress</b></font></a> - Copy constructor.<br><tt></tt> <a href="CL_IPAddress.html#2821"><tt><font color=blue><b>CL_IPAddress</b></font></tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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="2833"><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#2833"><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="2822"><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#2822"><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="2824"><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#2824"><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="2828"><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#2828"><tt><font color=black><b>operator</b></font></tt><tt> < </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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="2827"><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#2827"><tt><font color=black><b>operator</b></font></tt><tt> == </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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="2829"><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#2829"><tt><font color=black><b>operator</b></font></tt><tt> > </tt></a><tt>(<tt>const</tt> <a href="CL_IPAddress.html#2821"><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="2825"><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#2825"><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="2826"><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#2826"><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="2830"><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#2830"><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="2831"><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#2831"><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="2832"><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#2832"><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>