inet_ntop()
Convert a numeric network address to a string
Synopsis:
#include <sys/socket.h>
#include <arpa/inet.h>
const char * inet_ntop( int af,
const void * src,
char * dst,
socklen_t size );
Since:
BlackBerry 10.0.0
Arguments:
- af
- The src address's network family; one of:
- AF_INET
- IPv4 addresses
- AF_INET6
- IPv6 addresses
- src
- The numeric network address that you want to convert to a string.
- dst
- The text string that represents the translated network address.
You can use the following constants to allocate buffers of the correct
size (they're defined in <netinet/in.h>):
- INET_ADDRSTRLEN — storage for an IPv4 address
- INET6_ADDRSTRLEN — storage for an IPv6 address
- size
- The size of the buffer pointed to by dst.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The inet_ntop() function converts a numeric network address pointed to by src into a text string in the buffer pointed to by dst.
Returns:
A pointer to the buffer containing the text version of the address, or NULL if an error occurs ( errno is set).
Errors:
- EAFNOSUPPORT
- The value of the af argument isn't a supported network family.
- ENOSPC
- The dst buffer isn't large enough (according to size) to store the translated address.
Examples:
#include <stdio.h>
#include <stdlib.h>
#include <sys/socket.h>
#include <arpa/inet.h>
#include <errno.h>
#define INADDR "10.1.0.29"
#define IN6ADDR "DEAD:BEEF:7654:3210:FEDC:3210:7654:BA98"
int
main()
{
struct in_addr inaddr;
struct in6_addr in6addr;
char buf[INET_ADDRSTRLEN], buf6[INET6_ADDRSTRLEN];
int rval;
if ( (rval = inet_pton(AF_INET, INADDR, &inaddr)) == 0) {
printf("Invalid address: %s\n", INADDR);
exit(EXIT_FAILURE);
} else if (rval == -1) {
perror("inet_pton");
exit(EXIT_FAILURE);
}
if (inet_ntop(AF_INET, &inaddr, buf, sizeof(buf)) != NULL)
printf("inet addr: %s\n", buf);
else {
perror("inet_ntop");
exit(EXIT_FAILURE);
}
if ( (rval = inet_pton(AF_INET6, IN6ADDR, &in6addr)) == 0) {
printf("Invalid address: %s\n", IN6ADDR);
exit(EXIT_FAILURE);
} else if (rval == -1) {
perror("inet_pton");
exit(EXIT_FAILURE);
}
if (inet_ntop(AF_INET6, &in6addr, buf6, sizeof(buf6)) != NULL)
printf("inet6 addr: %s\n", buf6);
else {
perror("inet_ntop");
exit(EXIT_FAILURE);
}
return(EXIT_SUCCESS);
}
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |
Last modified: 2014-06-24