IP2LONG(3)								 1								IP2LONG(3)

ip2long - Converts a string containing an (IPv4) Internet Protocol dotted address into a proper address

SYNOPSIS

       int ip2long (string  $ip_address)

DESCRIPTION

	The function ip2long(3) generates an IPv4 Internet network address from its Internet standard format (dotted string) representation.

       ip2long(3)	 will	     also	work	   with       non-complete	 IP	  addresses.	   Read       http://publibn.boul-
       der.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm for more info.

PARAMETERS

	      o $ip_address
		- A standard format address.

RETURN VALUES

	Returns the IPv4 address or FALSE if $ip_address is invalid.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       |5.2.10	|						    |
       |	|						    |
       |	|  Prior to this version,  ip2long(3)  would  some- |
       |	| times  return  a  valid  number even if passed an |
       |	| value which was not an (IPv4)  Internet  Protocol |
       |	| dotted address.				    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      ip2long(3) Example

	      <?php
	      $ip = gethostbyname('www.example.com');
	      $out = "The following URLs are equivalent:<br />
";
	      $out .= 'http://www.example.com/, http://' . $ip . '/, and http://' . sprintf("%u", ip2long($ip)) . "/<br />
";
	      echo $out;
	      ?>

       Example #2

	      Displaying an IP address

	       This second example shows how to print a converted address with the printf(3) function in both PHP 4 and PHP 5:

	      <?php
	      $ip   = gethostbyname('www.example.com');
	      $long = ip2long($ip);

	      if ($long == -1 || $long === FALSE) {
		  echo 'Invalid IP, please try again';
	      } else {
		  echo $ip   . "
";	       // 192.0.34.166
		  echo $long . "
";	       // -1073732954
		  printf("%u
", ip2long($ip)); // 3221234342
	      }
	      ?>

NOTES

       Note

	       Because	PHP's  integer type is signed, and many IP addresses will result in negative integers on 32-bit architectures, you need to
	      use the "%u" formatter of sprintf(3) or printf(3) to get the string representation of the unsigned IP address.

       Note

	      ip2long(3) will return FALSE for the IP 255.255.255.255 in PHP 5 <= 5.0.2. It was fixed in PHP 5.0.3 where it returns  -1  (same	as
	      PHP 4).

SEE ALSO

       long2ip(3), sprintf(3).

PHP Documentation Group 														IP2LONG(3)