IPv4CIDRToRange
導入バージョン: v20.1.0 IPv4 アドレスとその Classless Inter-Domain Routing (CIDR) プレフィックス長を受け取り、そのサブネットのアドレス範囲を、2 つの IPv4 値からなるタプルとして返します。つまり、そのサブネットの先頭アドレスと末尾アドレスです。 IPv6 版についてはIPv6CIDRToRange を参照してください。
構文
Tuple(IPv4, IPv4)
例
使用例
Query
Response
IPv4NumToString
導入バージョン: v1.1.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレスの文字列表現に変換します。 入力はビッグエンディアンのバイト順で解釈されます。 構文INET_NTOA
引数
num— IPv4 アドレスを表す UInt32 型の数値。UInt32
0 を返します。String
例
使用例
Query
Response
IPv4NumToStringClassC
導入バージョン: v1.1.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレスの文字列表現に変換します。IPv4NumToString と似ていますが、最後のオクテットの代わりに xxx を使用します。
構文
num— UInt32 値として表された IPv4 アドレス。UInt32
String
例
集計を用いた基本例
Query
Response
IPv4StringToNum
導入バージョン: v1.1.0 ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレス文字列を、対応する 32 ビット整数表現に変換します (IPv4NumToString の逆です) 。
IPv4 アドレスの形式が無効な場合は、例外が発生します。
構文
INET_ATON
引数
string— IPv4 アドレス文字列。String
UInt32
例
使用例
Query
Response
IPv4StringToNumOrDefault
導入バージョン: v22.3.0 ドット区切りの10進表記 (A.B.C.D 形式) の IPv4 アドレス文字列を、対応する 32 ビット整数表現に変換します。IPv4 アドレスの形式が無効な場合は、0 を返します。
構文
string— IPv4 アドレス文字列。String
0 を返します。UInt32
例
無効なアドレスの例
Query
Response
IPv4StringToNumOrNull
導入バージョン: v22.3.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) による IPv4 アドレスの文字列表現に変換します。IPv4 アドレスの形式が無効な場合は、NULL を返します。
構文
string— IPv4 アドレス文字列。String
NULL を返します。Nullable(UInt32)
例
無効なアドレスの例
Query
Response
IPv4ToIPv6
導入バージョン: v1.1.0 (ビッグエンディアンの) 32ビット整数を IPv4 アドレスとして解釈し、さらにそれを対応する IPv6 アドレスとしてFixedString(16) フォーマットで表します。
構文
x— IPv4アドレス。UInt32
FixedString(16)
例
使用例
Query
Response
IPv6CIDRToRange
導入バージョン: v20.1.0 IPv6 アドレスとその Classless Inter-Domain Routing (CIDR) のプレフィックス長を受け取り、そのサブネットのアドレス範囲を、サブネット内の最小アドレスと最大アドレスからなる 2 つの IPv6 値のタプルとして返します。 IPv4 版についてはIPv4CIDRToRange を参照してください。
構文
Tuple(IPv6, IPv6)
例
使用例
Query
Response
IPv6NumToString
導入バージョン: v1.1.0 IPv6 アドレスをバイナリ形式 (FixedString(16)) から標準的なテキスト表現に変換します。 IPv4 マップド IPv6 アドレスは、::ffff:111.222.33.44 の形式で表示されます。
構文
INET6_NTOA
引数
x— バイナリ形式の IPv6 アドレス。FixedString(16)またはIPv6
String
例
使用例
Query
Response
Query
Response
Query
Response
IPv6StringToNum
導入バージョン: v1.1.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。
::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。
IPv6 アドレスの形式が無効な場合は、例外が発生します。
入力文字列に有効な IPv4 アドレスが含まれている場合は、対応する IPv6 アドレスを返します。
HEX には大文字と小文字の両方を使用できます。
構文
INET6_ATON
引数
string— IPv6 アドレスの文字列。String
FixedString(16)
例
基本例
Query
Response
IPv6StringToNumOrDefault
導入バージョン: v22.3.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。
::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。
IPv6 アドレスの形式が無効な場合は、デフォルト値 :: を返します。
構文
string— IPv6 アドレスの文字列。String
FixedString(16)
例
無効なアドレスの基本例
Query
Response
IPv6StringToNumOrNull
導入バージョン: v22.3.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。
::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。
IPv6 アドレスの形式が無効な場合は、NULL を返します。
構文
string— IPv6 アドレスの文字列。String
NULL を返します。Nullable(FixedString(16))
例
無効なアドレスを使った基本例
Query
Response
cutIPv6
導入バージョン: v1.1.0 IPv6 アドレスをバイナリ形式で格納したFixedString(16) 型の値を受け取ります。
指定したバイト数を取り除いたアドレスを、テキスト形式の文字列で返します。
構文
x— バイナリ形式の IPv6 アドレス。FixedString(16)またはIPv6bytesToCutForIPv6— IPv6 で切り取るバイト数。UInt8bytesToCutForIPv4— IPv4 で切り取るバイト数。UInt8
String
例
使用例
Query
Response
ipcryptDecrypt
導入バージョン: v26.10.0ipcryptEncrypt で暗号化された IP アドレスを、暗号化時と同じ鍵を使用して復号します。
入力が IPv4/IPv6 の場合は IPv6 を返し、String型の入力の場合は String を返します (リファレンス実装と同様に、IPv4 マップドアドレスとなる結果は IPv4 形式のテキストとして出力されます) 。
構文
encrypted_ip— 復号する暗号化済みIPアドレス。IPv4、IPv6、またはStringkey— 16バイトの暗号鍵 (raw bytes または32文字の16進数) 。定数である必要があります。StringまたはFixedString
IPv6 または String
例
暗号化して復号する往復変換
Query
Response
ipcryptEncrypt
導入バージョン: v26.10.0 16バイトの鍵を使用し、決定論的なフォーマット保持暗号化によって IP アドレスを暗号化します。 IPv4/IPv6 の入力に対しては IPv6 を返し、String型の入力に対しては String を返します (参照実装と同様に、IPv4 マップドの結果は IPv4 のテキスト形式で書き込まれます) 。 構文ip— 暗号化するIPアドレス。IPv4、IPv6、またはStringkey— 16バイトの暗号鍵 (raw bytes または16進数32文字) 。定数である必要があります。StringまたはFixedString
IPv6 または String
例
IPv4アドレスを暗号化する
Query
Response
ipcryptPrefixDecrypt
導入バージョン: v26.10.0ipcryptPrefixEncrypt で暗号化された IP アドレスを、同じ鍵を使用して復号します。
戻り値の型は入力と同じ種類になります。IPv4 の場合は IPv4、IPv6 の場合は IPv6 が返されます。
構文
encrypted_ip— 復号対象の暗号化されたIPアドレス。IPv4、IPv6、またはStringkey— 32バイトの暗号鍵 (raw bytes または 64文字の16進数) 。定数である必要があります。StringまたはFixedString
IPv4、IPv6、または String
例
プレフィックス保持暗号化から復号までの往復変換
Query
Response
ipcryptPrefixEncrypt
導入バージョン: v26.10.0 32 バイトの鍵を用いたプレフィックス保持暗号化により、IP アドレスを暗号化します。 ネットワークプレフィックスが共通するアドレスは、暗号化後のアドレスも同じくプレフィックスが共通します。 戻り値の型は入力のクラスを保持します。IPv4 は IPv4 のまま、IPv6 は IPv6 のままとなります。 構文ip— 暗号化するIPアドレス。IPv4、IPv6、またはStringkey— 32バイトの暗号鍵 (raw bytes または64文字の16進数) 。定数である必要があります。StringまたはFixedString
IPv4、IPv6、または String
例
IPv4のプレフィックス保持暗号化
Query
Response
isIPAddressInRange
導入バージョン: v21.4.0 IP アドレスが、Classless Inter-Domain Routing (CIDR) 表記のネットワークに含まれているかどうかを判定します。 この関数は、文字列として表された IPv4 と IPv6 の両方のアドレス (およびネットワーク) を受け取ります。アドレスの IP バージョンと CIDR が一致しない場合は、0 を返します。
構文
1、それ以外の場合は 0 を返します。UInt8
例
範囲内の IPv4 アドレス
Query
Response
Query
Response
Query
Response
isIPv4String
導入バージョン: v21.1.0 入力文字列が IPv4 アドレスかどうかを判定します。 IPv6 版については、isIPv6Stringを参照してください。
構文
string— 判定対象の IP アドレス文字列。String
string が IPv4 アドレスの場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
isIPv6String
導入バージョン: v21.1.0 入力文字列が IPv6 アドレスかどうかを判定します。 IPv4 版についてはisIPv4String を参照してください。
構文
string— 確認対象の IP アドレス文字列。String
string が IPv6 アドレスの場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
toIPv4
導入バージョン: v20.1.0 IPv4 アドレスを表す文字列、または IPv4 アドレスの UInt32 形式を IPv4 型に変換します。IPv4StringToNum 関数および IPv4NumToString 関数に似ていますが、入力引数として文字列型と符号なし整数型の両方をサポートしています。
構文
x— IPv4 アドレスを表すStringまたはUInt8/16/32
IPv4
例
使用例
Query
Response
Query
Response
Query
Response
toIPv4OrDefault
導入バージョン: v22.3.0 IPv4 アドレスの文字列、または IPv4 アドレスを表す UInt32 形式の値をIPv4 型に変換します。
IPv4 アドレスのフォーマットが無効な場合は、0.0.0.0 (IPv4 の 0) または指定されたデフォルトの IPv4 アドレスを返します。
構文
IPv4
例
有効な IPv4 文字列と無効な IPv4 文字列
Query
Response
toIPv4OrNull
導入バージョン: v22.3.0 入力値をIPv4 型の値に変換します。エラーが発生した場合は NULL を返します。
toIPv4 と同様ですが、変換エラー時に例外を発生させる代わりに NULL を返します。
サポートされる引数:
- ドット区切りの 10 進表記による IPv4 アドレスの文字列表現。
- IPv4 アドレスの整数表現。
NULL を返します) :
- 無効な IP アドレス形式。
- IPv6 アドレス。
- 範囲外の値。
- 形式が不正なアドレス。
NULL を返します。IPv4 または NULL
例
使用例
Query
Response
toIPv4OrZero
導入バージョン: v23.1.0 入力値を IPv4 型の値に変換しますが、エラー時にはゼロの IPv4 アドレスを返します。toIPv4 と同様ですが、変換エラー時に例外を発生させる代わりに、ゼロの IPv4 アドレス (0.0.0.0) を返します。
サポートされる引数:
- ドット区切りの 10 進表記による IPv4 アドレスの文字列表現。
- IPv4 アドレスの整数表現。
- 無効な IP アドレスのフォーマット。
- IPv6 アドレス。
- 範囲外の値。
0.0.0.0) を返します。IPv4
例
使用例
Query
Response
toIPv6
導入バージョン: v20.1.0 文字列、または IPv6 アドレスを表すUInt128 形式の値を IPv6 型に変換します。
文字列の場合、IPv6 アドレスの形式が無効であれば、空の値を返します。
IPv6 アドレスをバイナリ形式 (つまり FixedString(16)) との間で相互変換する IPv6StringToNum 関数および IPv6NumToString 関数と似ています。
入力文字列に有効な IPv4 アドレスが含まれている場合は、その IPv4 アドレスに対応する IPv6 表現が返されます。
構文
IPv6
例
使用例
Query
Response
Query
Response
toIPv6OrDefault
導入バージョン: v22.3.0 文字列または IPv6 アドレスの UInt128 形式をIPv6 型に変換します。
IPv6 アドレスの形式が無効な場合は、:: (0 IPv6) または指定したデフォルトの IPv6 を返します。
構文
string— 変換する IP アドレス文字列。 -default— 任意。stringのフォーマットが無効な場合に返す値です。
string のフォーマットが無効な場合は、:: または指定された任意のデフォルト値を返します。IPv6
Examples
有効な IPv6 文字列と無効な IPv6 文字列
Query
Response
toIPv6OrNull
導入バージョン: v22.3.0 入力値をIPv6 型の値に変換します。エラーが発生した場合は NULL を返します。
toIPv6 と同様ですが、変換エラー時に例外を発生させる代わりに NULL を返します。
サポートされる引数:
- 標準表記の IPv6 アドレスの文字列表現。
- IPv4 アドレスの文字列表現 (IPv4 マップド IPv6 に変換されます) 。
- IPv6 アドレスのバイナリ表現。
NULL を返します) :
- 無効な IP アドレス形式。
- 不正な形式の IPv6 アドレス。
- 範囲外の値。
- 無効な表記。
x— IPv6 または IPv4 アドレスの文字列表現。String
NULL を返します。IPv6 または NULL
例
使用例
Query
Response
toIPv6OrZero
導入バージョン: v23.1.0 入力値を IPv6 型の値に変換します。エラーが発生した場合は、ゼロ IPv6 アドレスを返します。toIPv6 と似ていますが、変換エラー時に例外を発生させる代わりに、ゼロ IPv6 アドレス (::) を返します。
サポートされる引数:
- 標準表記の IPv6 アドレスの文字列表現。
- IPv4 アドレスの文字列表現 (IPv4 マップド IPv6 に変換されます) 。
- IPv6 アドレスのバイナリ表現。
- 無効な IP アドレス形式。
- 不正な形式の IPv6 アドレス。
- 範囲外の値。
x— IPv6 または IPv4 アドレスの文字列表現。String
::) を返します。IPv6
例
使用例
Query
Response