NET_SAFE_IP_FROM_STRING 関数は、IPv4 または IPv6 アドレスの文字列リプリゼンテーションをバイナリ形式に変換します。
説明
この関数は NET_IP_FROM_STRING 関数に似ていますが、入力パラメーターが無効な場合にエラーをスローする代わりに NULL を返します。
構文
BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)パラメーター
str: 必須。変換する IPv4 または IPv6 アドレスを表す文字列。サポートされているフォーマットは次のとおりです。
IPv4: ドット区切りクワッド形式。例:
10.1.x.x。IPv6: コロン区切り形式。例:
1234:5678:90ab:cdef:1234:5678:90ab:cdef。詳細については、「IP バージョン 6 アドレッシングアーキテクチャ」をご参照ください。
説明
この関数は、10.1.x.x/xx などの CIDR 表記をサポートしていません。
戻り値
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 関数はネットワーク関数です。ネットワーク関数の詳細については、「ネットワーク関数」をご参照ください。