IPv4 および IPv6 アドレスを操作するための関数
IPv4NumToString
UInt32 の数を受け取ります。これをビッグエンディアンの IPv4 アドレスとして解釈します。対応する IPv4 アドレスを A.B.C.d 形式 (ドット区切りの10進数) の文字列として返します。
エイリアス: INET_NTOA.
IPv4StringToNum
IPv4NumToString の逆関数です。IPv4 アドレスが無効な形式の場合、例外をスローします。
エイリアス: INET_ATON.
IPv4StringToNumOrDefault(s)
IPv4StringToNum と同様ですが、IPv4 アドレスが無効な形式の場合、0 を返します。
IPv4StringToNumOrNull(s)
IPv4StringToNum と同様ですが、IPv4 アドレスが無効な形式の場合、null を返します。
IPv4NumToStringClassC(num)
IPv4NumToString に似ていますが、最後のオクテットの代わりに xxx を使用します。
例:
'xxx' を使用することは非常に珍しいため、将来的に変更される可能性があります。この部分の正確な形式に依存しないことをお勧めします。
IPv6NumToString(x)
IPv6 アドレスをバイナリ形式で含む FixedString(16) の値を受け取ります。このアドレスをテキスト形式で含む文字列を返します。IPv6 マップされた IPv4 アドレスは、次の形式で出力されます: ::ffff:111.222.33.44。
エイリアス: INET6_NTOA.
例:
IPv6StringToNum
IPv6NumToString の逆関数です。IPv6 アドレスが無効な形式の場合、例外をスローします。
入力文字列が有効な IPv4 アドレスを含む場合、その IPv6 相当を返します。HEX は大文字または小文字でも可能です。
エイリアス: INET6_ATON.
構文
引数
string— IP アドレス。String。
返される値
- バイナリ形式の IPv6 アドレス。FixedString(16)。
例
クエリ:
結果:
関連項目
IPv6StringToNumOrDefault(s)
IPv6StringToNum と同様ですが、IPv6 アドレスが無効な形式の場合、0 を返します。
IPv6StringToNumOrNull(s)
IPv6StringToNum と同様ですが、IPv6 アドレスが無効な形式の場合、null を返します。
IPv4ToIPv6(x)
UInt32 の数を受け取ります。これを ビッグエンディアン の IPv4 アドレスとして解釈します。IPv6 アドレスをバイナリ形式で含む FixedString(16) の値を返します。例:
cutIPv6(x, bytesToCutForIPv6, bytesToCutForIPv4)
IPv6 アドレスをバイナリ形式で含む FixedString(16) の値を受け取ります。指定されたバイト数を削除したアドレスをテキスト形式で含む文字列を返します。例えば:
IPv4CIDRToRange(ipv4, Cidr),
IPv4 と CIDR を含む UInt8 値を受け取ります。サブネットの下限範囲と上限範囲を含む 2 つの IPv4 がタプルで返されます。
IPv6CIDRToRange(ipv6, Cidr),
IPv6 と CIDR を含む UInt8 値を受け取ります。サブネットの下限範囲と上限範囲を含む 2 つの IPv6 がタプルで返されます。
toIPv4
IPv4StringToNum と同様ですが、IPv4 アドレスの文字列形式を受け取り、IPv4 型の値を返します。
構文
引数
string— IPv4 アドレス。String。
返される値
stringから変換された IPv4 アドレス。IPv4。
例
クエリ:
結果:
クエリ:
結果:
toIPv4OrDefault
toIPv4 と同様ですが、IPv4 アドレスが無効な形式の場合、0.0.0.0 (0 IPv4) または指定された IPv4 デフォルトを返します。
構文
引数
返される値
- 現在の IPv4 アドレスに変換された
string。String。
例
クエリ:
結果:
toIPv4OrNull
toIPv4 と同じですが、IPv4 アドレスが無効な形式の場合、null を返します。
構文
引数
string— IP アドレス。String。
返される値
- 現在の IPv4 アドレスに変換された
string、またはstringが無効なアドレスの場合は null。String。
例
クエリ:
結果:
toIPv4OrZero
toIPv4 と同様ですが、IPv4 アドレスが無効な形式の場合、0.0.0.0 を返します。
構文
引数
string— IP アドレス。String。
返される値
- 現在の IPv4 アドレスに変換された
string、またはstringが無効なアドレスの場合は0.0.0.0。String。
例
クエリ:
結果:
toIPv6
IPv6 アドレスの文字列形式を IPv6 型に変換します。IPv6 アドレスが無効な形式の場合、空の値を返します。 IPv6 アドレスをバイナリ形式に変換する IPv6StringToNum 関数に似ています。
入力文字列が有効な IPv4 アドレスを含む場合、その IPv4 アドレスの IPv6 相当が返されます。
構文
引数
string— IP アドレス。String。
返される値
- IP アドレス。IPv6。
例
クエリ:
結果:
クエリ:
結果:
toIPv6OrDefault
toIPv6 と同様ですが、IPv6 アドレスが無効な形式の場合、:: (0 IPv6) または指定された IPv6 デフォルトを返します。
構文
引数
返される値
- IPv6 アドレス IPv6、そうでない場合は
::またはstringが無効な形式の場合に提供されたオプションのデフォルト。
例
クエリ:
結果:
toIPv6OrNull
toIPv6 と同様ですが、IPv6 アドレスが無効な形式の場合、null を返します。
構文
引数
string— IP アドレス。String。
返される値
- IP アドレス。IPv6、または
stringが有効な形式でない場合は null。
例
クエリ:
結果:
toIPv6OrZero
toIPv6 と同様ですが、IPv6 アドレスが無効な形式の場合、:: を返します。
構文
引数
string— IP アドレス。String。
返される値
- IP アドレス。IPv6、または
stringが有効な形式でない場合は::。
例
クエリ:
結果:
IPv6StringToNumOrDefault(s)
toIPv6 と同様ですが、IPv6 アドレスが無効な形式の場合、0 を返します。
IPv6StringToNumOrNull(s)
toIPv6 と同様ですが、IPv6 アドレスが無効な形式の場合、null を返します。
isIPv4String
入力文字列が IPv4 アドレスであるかどうかを判定します。string が IPv6 アドレスである場合は 0 を返します。
構文
引数
string— IP アドレス。String。
返される値
stringが IPv4 アドレスであれば1、そうでなければ0。UInt8。
例
クエリ:
結果:
isIPv6String
入力文字列が IPv6 アドレスであるかどうかを判定します。string が IPv4 アドレスである場合は 0 を返します。
構文
引数
string— IP アドレス。String。
返される値
stringが IPv6 アドレスであれば1、そうでなければ0。UInt8。
例
クエリ:
結果:
isIPAddressInRange
IP アドレスが、CIDR 表記で示されたネットワークに含まれているかどうかを判断します。真の場合は 1、そうでない場合は 0 を返します。
構文
この関数は、文字列として表された IPv4 および IPv6 アドレス (およびネットワーク) の両方を受け取ります。アドレスの IP バージョンと CIDR が一致しない場合は 0 を返します。
引数
返される値
1または0。UInt8。
例
クエリ:
結果:
クエリ:
結果:
クエリ:
結果: