<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>