<!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>GNU CommonC++: ost::IPV6Address Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.6 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li id="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul></div>
<div class="nav">
<a class="el" href="namespaceost.html">ost</a>::<a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a></div>
<h1>ost::IPV6Address Class Reference</h1><!-- doxytag: class="ost::IPV6Address" -->The network name and address objects are all derived from a common <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> base class.Internet Address binary data type.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="address_8h-source.html">address.h</a>></code>
<p>
<p>Inheritance diagram for ost::IPV6Address:
<p><center><img src="classost_1_1_i_p_v6_address.png" usemap="#ost::IPV6Address_map" border="0" alt=""></center>
<map name="ost::IPV6Address_map">
<area href="classost_1_1_i_p_v6_broadcast.html" alt="ost::IPV6Broadcast" shape="rect" coords="0,56,118,80">
<area href="classost_1_1_i_p_v6_host.html" alt="ost::IPV6Host" shape="rect" coords="128,56,246,80">
<area href="classost_1_1_i_p_v6_mask.html" alt="ost::IPV6Mask" shape="rect" coords="256,56,374,80">
<area href="classost_1_1_i_p_v6_multicast.html" alt="ost::IPV6Multicast" shape="rect" coords="384,56,502,80">
</map>
<a href="classost_1_1_i_p_v6_address-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#5f880064ca1d1d13843417121fe99e15">IPV6Address</a> (const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> *validator=NULL)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an Internet Address object with an empty (0.0.0.0) address. <a href="#5f880064ca1d1d13843417121fe99e15"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#a0a87107cdce787527aaacdddcccbdb5">IPV6Address</a> (struct in6_addr addr, const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> *validator=NULL)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convert the system internet address data type (struct in_addr) into a Common C++ <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object. <a href="#a0a87107cdce787527aaacdddcccbdb5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#ca65f468b68ada986289b12892374352">IPV6Address</a> (const char *address, const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> *validator=NULL)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convert a null terminated ASCII host address string (example: "127.0.0.1") or host address name (example: "www.voxilla.org") directly into a Common C++ <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object. <a href="#ca65f468b68ada986289b12892374352"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#c2d016fc0c7abb0314c6e0356f5dbcfc">IPV6Address</a> (const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> &rhs)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#c2d016fc0c7abb0314c6e0356f5dbcfc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#a0dee78a53cf231c5f8c779533e805eb">~IPV6Address</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a0dee78a53cf231c5f8c779533e805eb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#c61e0dd245f86e919d64789f03c82014">getHostname</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provide a string representation of the value (Internet Address) held in the <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object. <a href="#c61e0dd245f86e919d64789f03c82014"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#df669112216210aa2466113c0e7512ef">isInetAddress</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">May be used to verify if a given <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> returned by another function contains a "valid" address, or "0.0.0.0" which is often used to mark "invalid" <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> values. <a href="#df669112216210aa2466113c0e7512ef"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">in6_addr </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#38c659f6641c61df147e1c76690dc6c2">getAddress</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provide a low level system usable struct in_addr object from the contents of <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a>. <a href="#38c659f6641c61df147e1c76690dc6c2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">in6_addr </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#3007ac14ed8310e1375f5e88c6b6a9b1">getAddress</a> (size_t i) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provide a low level system usable struct in_addr object from the contents of <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a>. <a href="#3007ac14ed8310e1375f5e88c6b6a9b1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#c8cda66da211bec64ea6de14c3ad65c8">getAddressCount</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of internet addresses that an <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object contains. <a href="#c8cda66da211bec64ea6de14c3ad65c8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#898a78e723cff2c4f64e25d409f9282c">operator=</a> (const char *str)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#647b97bcfd9d5a3bef541e4464f819e0">operator=</a> (struct in6_addr addr)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#efb439692abe5bd063eb48518288f203">operator=</a> (const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> &rhs)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#80df5c80fa1675223d74161278b18649">operator!</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#478d3f112a248a8aa0b860bc3666cd7f">operator==</a> (const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> &a) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Compare two internet addresses to see if they are equal (if they specify the physical address of the same internet host). <a href="#478d3f112a248a8aa0b860bc3666cd7f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#9adbe9a3d82154c70adf729c5bc637b2">operator!=</a> (const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> &a) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Compare two internet addresses to see if they are not equal (if they each refer to unique and different physical ip addresses). <a href="#9adbe9a3d82154c70adf729c5bc637b2"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#f72eacadf7c2540ffea3a22f1ec0f1d9">setIPAddress</a> (const char *host)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the IP address from a string representation of the numeric address, ie "127.0.0.1". <a href="#f72eacadf7c2540ffea3a22f1ec0f1d9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#7b30b1236380fa16556799edbd6bc496">setAddress</a> (const char *host)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Used to specify a host name or numeric internet address. <a href="#7b30b1236380fa16556799edbd6bc496"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">in6_addr * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#8d8a4ce0d30251e42ddfc793369fc37d">ipaddr</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#b34b66044b90b5b045ae924858f2bf2a">addr_count</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#469e52373818fea081b0f1df6f57e14c">hostname</a></td></tr>
<tr><td colspan="2"><br><h2>Static Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classost_1_1_mutex.html">Mutex</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_i_p_v6_address.html#f43882cd7c34125d097c90ed9e50490b">mutex</a></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
The network name and address objects are all derived from a common <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> base class.Internet Address binary data type.
<p>
Specific classes, such as <a class="el" href="classost_1_1_i_p_v4_host.html">IPV4Host</a>, <a class="el" href="classost_1_1_i_p_v6_mask.html">IPV6Mask</a>, etc, are defined from <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> entirely so that the manner a network address is being used can easily be documented and understood from the code and to avoid common errors and accidental misuse of the wrong address object. For example, a "connection" to something that is declared as a "IPV6Host" can be kept type-safe from a "connection" accidently being made to something that was declared a "IPV6Broadcast".<p>
<dl compact><dt><b>Author:</b></dt><dd>David Sugar <<a href="mailto:dyfet@ostel.com">dyfet@ostel.com</a>> </dd></dl>
<p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="5f880064ca1d1d13843417121fe99e15"></a><!-- doxytag: member="ost::IPV6Address::IPV6Address" ref="5f880064ca1d1d13843417121fe99e15" args="(const IPV6Validator *validator=NULL)" --><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">ost::IPV6Address::IPV6Address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>validator</em> = <code>NULL</code> </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>
Create an Internet Address object with an empty (0.0.0.0) address.
<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>validator</em> </td><td>optional validator function object, intended for derived classes. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a0a87107cdce787527aaacdddcccbdb5"></a><!-- doxytag: member="ost::IPV6Address::IPV6Address" ref="a0a87107cdce787527aaacdddcccbdb5" args="(struct in6_addr addr, const IPV6Validator *validator=NULL)" --><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">ost::IPV6Address::IPV6Address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">struct in6_addr </td>
<td class="mdname" nowrap> <em>addr</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> * </td>
<td class="mdname" nowrap> <em>validator</em> = <code>NULL</code></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Convert the system internet address data type (struct in_addr) into a Common C++ <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> 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>addr</em> </td><td>struct of system used binary internet address. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>validator</em> </td><td>optional validator function object, intended for derived classes. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="ca65f468b68ada986289b12892374352"></a><!-- doxytag: member="ost::IPV6Address::IPV6Address" ref="ca65f468b68ada986289b12892374352" args="(const char *address, const IPV6Validator *validator=NULL)" --><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">ost::IPV6Address::IPV6Address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>address</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="classost_1_1_i_p_v6_validator.html">IPV6Validator</a> * </td>
<td class="mdname" nowrap> <em>validator</em> = <code>NULL</code></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Convert a null terminated ASCII host address string (example: "127.0.0.1") or host address name (example: "www.voxilla.org") directly into a Common C++ <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> 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>address</em> </td><td>null terminated C string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>validator</em> </td><td>optional validator function object, intended for derived classes. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="c2d016fc0c7abb0314c6e0356f5dbcfc"></a><!-- doxytag: member="ost::IPV6Address::IPV6Address" ref="c2d016fc0c7abb0314c6e0356f5dbcfc" args="(const IPV6Address &rhs)" --><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">ost::IPV6Address::IPV6Address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>rhs</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>
Copy constructor.
<p>
</td>
</tr>
</table>
<a class="anchor" name="a0dee78a53cf231c5f8c779533e805eb"></a><!-- doxytag: member="ost::IPV6Address::~IPV6Address" ref="a0dee78a53cf231c5f8c779533e805eb" args="()" --><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">virtual ost::IPV6Address::~IPV6Address </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Destructor.
<p>
</td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="3007ac14ed8310e1375f5e88c6b6a9b1"></a><!-- doxytag: member="ost::IPV6Address::getAddress" ref="3007ac14ed8310e1375f5e88c6b6a9b1" args="(size_t i) const " --><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">struct in6_addr ost::IPV6Address::getAddress </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">size_t </td>
<td class="mdname1" valign="top" nowrap> <em>i</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Provide a low level system usable struct in_addr object from the contents of <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a>.
<p>
This is needed for services such as bind() and connect().<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>i</em> </td><td>for IPV6Addresses with multiple addresses, returns the address at this index. User should call <a class="el" href="classost_1_1_i_p_v6_address.html#c8cda66da211bec64ea6de14c3ad65c8">getAddressCount()</a> to determine the number of address the object contains. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>system binary coded internet address. If parameter i is out of range, the first address is returned. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="38c659f6641c61df147e1c76690dc6c2"></a><!-- doxytag: member="ost::IPV6Address::getAddress" ref="38c659f6641c61df147e1c76690dc6c2" args="(void) const " --><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">struct in6_addr ost::IPV6Address::getAddress </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Provide a low level system usable struct in_addr object from the contents of <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a>.
<p>
This is needed for services such as bind() and connect().<p>
<dl compact><dt><b>Returns:</b></dt><dd>system binary coded internet address. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="c8cda66da211bec64ea6de14c3ad65c8"></a><!-- doxytag: member="ost::IPV6Address::getAddressCount" ref="c8cda66da211bec64ea6de14c3ad65c8" args="() const " --><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">size_t ost::IPV6Address::getAddressCount </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const<code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns the number of internet addresses that an <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object contains.
<p>
This usually only happens with <a class="el" href="classost_1_1_i_p_v6_host.html">IPV6Host</a> objects where multiple IP addresses are returned for a DNS lookup </td>
</tr>
</table>
<a class="anchor" name="c61e0dd245f86e919d64789f03c82014"></a><!-- doxytag: member="ost::IPV6Address::getHostname" ref="c61e0dd245f86e919d64789f03c82014" args="(void) const " --><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">const char* ost::IPV6Address::getHostname </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Provide a string representation of the value (Internet Address) held in the <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>string representation of <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a>. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="df669112216210aa2466113c0e7512ef"></a><!-- doxytag: member="ost::IPV6Address::isInetAddress" ref="df669112216210aa2466113c0e7512ef" args="(void) const " --><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">bool ost::IPV6Address::isInetAddress </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
May be used to verify if a given <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> returned by another function contains a "valid" address, or "0.0.0.0" which is often used to mark "invalid" <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> values.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>true if address != 0.0.0.0. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="80df5c80fa1675223d74161278b18649"></a><!-- doxytag: member="ost::IPV6Address::operator!" ref="80df5c80fa1675223d74161278b18649" args="() const " --><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">bool ost::IPV6Address::operator! </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const<code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="9adbe9a3d82154c70adf729c5bc637b2"></a><!-- doxytag: member="ost::IPV6Address::operator!=" ref="9adbe9a3d82154c70adf729c5bc637b2" args="(const IPV6Address &a) const " --><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">bool ost::IPV6Address::operator!= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>a</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Compare two internet addresses to see if they are not equal (if they each refer to unique and different physical ip addresses).
<p>
This is implimented in terms of operator== </td>
</tr>
</table>
<a class="anchor" name="efb439692abe5bd063eb48518288f203"></a><!-- doxytag: member="ost::IPV6Address::operator=" ref="efb439692abe5bd063eb48518288f203" args="(const IPV6Address &rhs)" --><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="classost_1_1_i_p_v6_address.html">IPV6Address</a>& ost::IPV6Address::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>rhs</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>
</td>
</tr>
</table>
<a class="anchor" name="647b97bcfd9d5a3bef541e4464f819e0"></a><!-- doxytag: member="ost::IPV6Address::operator=" ref="647b97bcfd9d5a3bef541e4464f819e0" args="(struct in6_addr addr)" --><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="classost_1_1_i_p_v6_address.html">IPV6Address</a>& ost::IPV6Address::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">struct in6_addr </td>
<td class="mdname1" valign="top" nowrap> <em>addr</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>
</td>
</tr>
</table>
<a class="anchor" name="898a78e723cff2c4f64e25d409f9282c"></a><!-- doxytag: member="ost::IPV6Address::operator=" ref="898a78e723cff2c4f64e25d409f9282c" args="(const char *str)" --><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="classost_1_1_i_p_v6_address.html">IPV6Address</a>& ost::IPV6Address::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>str</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>
</td>
</tr>
</table>
<a class="anchor" name="478d3f112a248a8aa0b860bc3666cd7f"></a><!-- doxytag: member="ost::IPV6Address::operator==" ref="478d3f112a248a8aa0b860bc3666cd7f" args="(const IPV6Address &a) const " --><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">bool ost::IPV6Address::operator== </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>a</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Compare two internet addresses to see if they are equal (if they specify the physical address of the same internet host).
<p>
If there is more than one IP address in either <a class="el" href="classost_1_1_i_p_v6_address.html">IPV6Address</a> object, this will return true if all of the IP addresses in the smaller are in the larger in any order. </td>
</tr>
</table>
<a class="anchor" name="7b30b1236380fa16556799edbd6bc496"></a><!-- doxytag: member="ost::IPV6Address::setAddress" ref="7b30b1236380fa16556799edbd6bc496" args="(const char *host)" --><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 ost::IPV6Address::setAddress </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>host</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [protected]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Used to specify a host name or numeric internet address.
<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>host</em> </td><td>The string representation of the IP address or a hostname, , if NULL, it will default to INADDR_ANY </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="f72eacadf7c2540ffea3a22f1ec0f1d9"></a><!-- doxytag: member="ost::IPV6Address::setIPAddress" ref="f72eacadf7c2540ffea3a22f1ec0f1d9" args="(const char *host)" --><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">bool ost::IPV6Address::setIPAddress </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>host</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [protected]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Sets the IP address from a string representation of the numeric address, ie "127.0.0.1".
<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>host</em> </td><td>The string representation of the IP address </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>true if successful </dd></dl>
</td>
</tr>
</table>
<hr><h2>Member Data Documentation</h2>
<a class="anchor" name="b34b66044b90b5b045ae924858f2bf2a"></a><!-- doxytag: member="ost::IPV6Address::addr_count" ref="b34b66044b90b5b045ae924858f2bf2a" args="" --><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">size_t <a class="el" href="classost_1_1_i_p_v6_address.html#b34b66044b90b5b045ae924858f2bf2a">ost::IPV6Address::addr_count</a><code> [protected]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="469e52373818fea081b0f1df6f57e14c"></a><!-- doxytag: member="ost::IPV6Address::hostname" ref="469e52373818fea081b0f1df6f57e14c" args="" --><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">char* <a class="el" href="classost_1_1_i_p_v6_address.html#469e52373818fea081b0f1df6f57e14c">ost::IPV6Address::hostname</a><code> [mutable, protected]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="8d8a4ce0d30251e42ddfc793369fc37d"></a><!-- doxytag: member="ost::IPV6Address::ipaddr" ref="8d8a4ce0d30251e42ddfc793369fc37d" args="" --><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">struct in6_addr* <a class="el" href="classost_1_1_i_p_v6_address.html#8d8a4ce0d30251e42ddfc793369fc37d">ost::IPV6Address::ipaddr</a><code> [protected]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="f43882cd7c34125d097c90ed9e50490b"></a><!-- doxytag: member="ost::IPV6Address::mutex" ref="f43882cd7c34125d097c90ed9e50490b" args="" --><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="classost_1_1_mutex.html">Mutex</a> <a class="el" href="classost_1_1_i_p_v6_address.html#f43882cd7c34125d097c90ed9e50490b">ost::IPV6Address::mutex</a><code> [static, protected]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="address_8h-source.html">address.h</a></ul>
<hr size="1"><address style="align: right;"><small>Generated on Mon Jun 19 10:50:55 2006 for GNU CommonC++ by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
</body>
</html>
