NET_SAFE_IP_FROM_STRING函數用於將IPv4或IPv6地址從字串STRING格式轉換為二進位BINARY格式。
說明
類似於NET_IP_FROM_STRING函數,但如果輸入參數被視為無效,則返回NULL而不是拋出錯誤。
命令格式
BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)參數說明
str:必填,STRING類型。待轉換的表示IPv4或IPv6地址的字串,支援的格式如下:
IPv4:以點分四組格式。例如
10.1.x.x。IPv6:以冒號分隔格式。例如
1234:5678:90ab:cdef:1234:5678:90ab:cdef。更多樣本,請參見IP Version 6 Addressing Architecture。
說明
該函數不支援CIDR標記法,例如10.1.x.x/xx。
傳回值說明
返回BINARY類型的IP地址。返回規則如下:
若輸入參數為NULL,返回NULL。
若輸入參數無效或者不合法,則返回NULL。
使用樣本
--返回 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');相關函數
NET_SAFE_IP_FROM_STRING函數屬於網路函數,更多網路相關函數請參見網路函數。