<doc>

<legacy_id>1833</legacy_id>

<name>hostAddressToName</name>

<type>function</type>

<syntax>

<example>the hostAddressToName of <i>IPAddress</i></example>

<example>hostAddressToName(<i>IPAddress</i>)</example>

</syntax>

<synonyms>

</synonyms>

<summary><glossary tag="return">Returns</glossary> the <glossary tag="domain name">domain name</glossary> corresponding to an <glossary tag="IP address">IP address</glossary>.</summary>

<examples>

<example>hostAddressToName(&quot;127.0.0.1&quot;)</example>

<example>answer &quot;Connecting to&quot; &amp;&amp; hostAddressToName(newAddress) &amp; &quot;...&quot;</example>

</examples>

<history>

<introduced version="1.0">Added.</introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Networks &amp; Communication</category>

</classification>

<references>

<function tag="peerAddress">peerAddress Function</function>

<function tag="hostAddress">hostAddress Function</function>

<command tag="accept">accept Command</command>

</references>

<description>

<overview>Use the <b>hostAddressToName</b> function to find the <glossary tag="domain name">domain name</glossary> of the computer at a <glossary tag="IP address">IP address</glossary>.</overview>

<parameters>

<parameter>

<name>IPAddress</name>

<description>Is a numeric IP address.</description>

</parameter> </parameters>

<value>The <b>hostAddressToName</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> the <glossary tag="domain name">domain name</glossary> corresponding to the <i>IPAddress</i>.</value>

<comments>The <b>hostAddressToName</b> <control_st tag="function">function</control_st> does a reverse <glossary tag="DNS">DNS</glossary> lookup on the <glossary tag="IP address">IP address</glossary> in order to find the <glossary tag="domain name">domain name</glossary>. This means that the computer must be connected to the Internet in order to use this <control_st tag="function">function</control_st>. If a connection to the Internet is not available, the <b>hostAddressToName</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> an error message.</comments>

</description>

</doc>