manpagez: man pages & more
info guile
Home | html | info | man
[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7.2.11.1 Network Address Conversion

This section describes procedures which convert internet addresses between numeric and string formats.

IPv4 Address Conversion

An IPv4 Internet address is a 4-byte value, represented in Guile as an integer in host byte order, so that say “0.0.0.1” is 1, or “1.0.0.0” is 16777216.

Some underlying C functions use network byte order for addresses, Guile converts as necessary so that at the Scheme level its host byte order everywhere.

Variable: INADDR_ANY

For a server, this can be used with bind (see section Network Sockets and Communication) to allow connections from any interface on the machine.

Variable: INADDR_BROADCAST

The broadcast address on the local network.

Variable: INADDR_LOOPBACK

The address of the local host using the loopback device, ie. ‘127.0.0.1’.

Scheme Procedure: inet-aton address
C Function: scm_inet_aton (address)

This function is deprecated in favor of inet-pton.

Convert an IPv4 Internet address from printable string (dotted decimal notation) to an integer. E.g.,

(inet-aton "127.0.0.1") ⇒ 2130706433
Scheme Procedure: inet-ntoa inetid
C Function: scm_inet_ntoa (inetid)

This function is deprecated in favor of inet-ntop.

Convert an IPv4 Internet address to a printable (dotted decimal notation) string. E.g.,

(inet-ntoa 2130706433) ⇒ "127.0.0.1"
Scheme Procedure: inet-netof address
C Function: scm_inet_netof (address)

Return the network number part of the given IPv4 Internet address. E.g.,

(inet-netof 2130706433) ⇒ 127
Scheme Procedure: inet-lnaof address
C Function: scm_lnaof (address)

Return the local-address-with-network part of the given IPv4 Internet address, using the obsolete class A/B/C system. E.g.,

(inet-lnaof 2130706433) ⇒ 1
Scheme Procedure: inet-makeaddr net lna
C Function: scm_inet_makeaddr (net, lna)

Make an IPv4 Internet address by combining the network number net with the local-address-within-network number lna. E.g.,

(inet-makeaddr 127 1) ⇒ 2130706433

IPv6 Address Conversion

An IPv6 Internet address is a 16-byte value, represented in Guile as an integer in host byte order, so that say “::1” is 1.

Scheme Procedure: inet-ntop family address
C Function: scm_inet_ntop (family, address)

Convert a network address from an integer to a printable string. family can be AF_INET or AF_INET6. E.g.,

(inet-ntop AF_INET 2130706433) ⇒ "127.0.0.1"
(inet-ntop AF_INET6 (- (expt 2 128) 1))
  ⇒ "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff"
Scheme Procedure: inet-pton family address
C Function: scm_inet_pton (family, address)

Convert a string containing a printable network address to an integer address. family can be AF_INET or AF_INET6. E.g.,

(inet-pton AF_INET "127.0.0.1") ⇒ 2130706433
(inet-pton AF_INET6 "::1") ⇒ 1

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated on April 20, 2013 using texi2html 5.0.

© manpagez.com 2000-2019
Individual documents may contain additional copyright information.