La fonction NET_SAFE_IP_FROM_STRING convertit une adresse IPv4 ou IPv6 du format chaîne (STRING) au format binaire (BINARY).
Semblable à la fonction NET_IP_FROM_STRING, cette fonction renvoie NULL au lieu de générer une erreur si le paramètre d'entrée est invalide.
Syntaxe
BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)Paramètres
str : obligatoire, type STRING. Chaîne représentant l'adresse IPv4 ou IPv6 à convertir. Les formats pris en charge sont les suivants :
IPv4 : notation décimale pointée. Exemple :
10.1.x.x.IPv6 : notation hexadécimale séparée par des deux-points. Exemple :
1234:5678:90ab:cdef:1234:5678:90ab:cdef. Pour plus d'exemples, consultez IP Version 6 Addressing Architecture.
Cette fonction ne prend pas en charge la notation CIDR, par exemple 10.1.x.x/xx.
Valeur de retour
Renvoie l'adresse IP au format BINARY. Règles de retour :
Si le paramètre d'entrée est NULL, renvoie NULL.
Si le paramètre d'entrée est invalide ou incorrect, renvoie NULL.
Exemples
--返回 0123
SELECT NET_SAFE_IP_FROM_STRING('48.49.50.51');
--返回 =00=00=00=00=00=00=00=00=00=00=00=00=00=00=00=01
SELECT NET_SAFE_IP_FROM_STRING('::1');
--返回 0123456789@ABCDE
SELECT NET_SAFE_IP_FROM_STRING('3031:3233:3435:3637:3839:4041:4243:4445');
--返回 =00=00=00=00=00=00=00=00=00=00=FF=FF=C0=00=02=80
SELECT NET_SAFE_IP_FROM_STRING('::ffff:192.0.2.128');
--返回 NULL
SELECT NET_SAFE_IP_FROM_STRING(NULL);
--返回 NULL
SELECT NET_SAFE_IP_FROM_STRING('123.456');
--返回 NULL
SELECT NET_SAFE_IP_FROM_STRING('::wxyz');Fonctions associées
La fonction NET_SAFE_IP_FROM_STRING fait partie des fonctions réseau. Pour plus d'informations sur les autres fonctions liées au réseau, consultez la page Network Functions Overview.