inet_pton, Subroutine

Zweck

Diese Funktion wird für AF_INET6 zugunsten der Subroutineinet_pton6_zone nicht weiter unterstützt.

Bibliothek

Bibliothek (libc.a)

Syntax

int inet_pton (af, src, dst) 
int af;
const char *src;
void *dst;

Beschreibung

Diese Funktion konvertiert eine Adresse im Standardtextformat in ihr numerisches Binärformat. Der Parameter af gibt die Familie der Adresse an.

Hinweis: Nur die Adressfamilien AF_INET und AF_INET6 werden unterstützt.

Parameter

Element	Beschreibung
AF	Gibt die Familie der Adresse an Dies kann `AF_INET` oder `AF_INET6`sein.
src	Verweist auf die übergebene Zeichenfolge.
DST	Verweist auf einen Puffer, in dem die Funktion die numerische Adresse speichert. Die Adresse wird in Netzbyteanordnung zurückgegeben.

Rückgabewerte

Bei erfolgreicher Ausführung wird eine zurückgegeben. Wenn nicht erfolgreich, wird null zurückgegeben, wenn die Eingabe keine gültige IPv4 -Zeichenfolge in der Schreibweise mit Trennzeichen oder eine gültige IPv6 -Adresszeichenfolge ist, oder eine negative Zeichenfolge, bei der die globale Variable errno auf EAFNOSUPPORT gesetzt ist, wenn der Parameter af unbekannt ist. Die aufrufende Anwendung muss sicherstellen, dass der Puffer, auf den der Parameter dst verweist, groß genug ist, um die numerische Adresse aufzunehmen (4 Byte für AF_INET oder 16 Byte für AF_INET6).

Wenn der Parameter af den Wert AF_INET hat, akzeptiert die Funktion eine Zeichenfolge in der IPv4 -Standardschreibweise mit Trennzeichen.

ddd.ddd.ddd.ddd

Dabei ist ddd eine ein-bis dreistellige Dezimalzahl zwischen 0 und 255.

Hinweis: Viele Implementierungen der vorhandenen Funktionen inet_addr und inet_aton akzeptieren vom Standard abweichende Eingaben wie Oktalzahlen, Hexadezimalzahlen und weniger als vier Zahlen. inet_pton akzeptiert diese Formate nicht.

Wenn der Parameter af den Wert AF_INET6hat, akzeptiert die Funktion eine Zeichenfolge in einem der IPv6 -Standardtextformate, die in der Adressierungsarchitekturspezifikation definiert sind.