以下のドキュメントは、
system.functions システムテーブルから生成されています。CRC32
0xffffffff (zlib 実装) を使用して、文字列の CRC32 チェックサムを計算します。
構文
s— CRC32 を計算する文字列。String
UInt32
例
使用例
Query
Response
CRC32IEEE
s— CRC32 を計算する対象の文字列です。String
UInt32
例
使用例
Query
Response
CRC64
s— CRC64 を計算する文字列。String
UInt64
例
使用例
Query
Response
appendTrailingCharIfAbsent
s が空でなく、末尾が文字 c でない場合は、文字列 s の末尾に文字 c を追加します。
構文
s が c で終わっていない場合、文字 c を末尾に追加した文字列 s を返します。String
例
使用例
Query
Response
ascii
s の最初の文字の ASCII コードポイントを Int32 として返します。
構文
s— String 型の入力。String
s が空の場合、結果は 0 です。最初の文字が ASCII 文字でない場合、または UTF-16 の Latin-1 Supplement 範囲に含まれない場合、結果は未定義です。Int32
例
使用例
Query
Response
base32Decode
encoded— String 型のカラムまたは定数。String
String
例
使用例
Query
Response
base32Encode
plaintext— エンコードする平文。String
String または FixedString
例
使用例
Query
Response
base58Decode
expected_size を指定できます。
現在サポートされている値は 32 と 64 です。それ以外の値では、汎用デコーダーが使用されます。
最適化デコーダーが選択されていても、入力をそのバイト数ちょうどにデコードできない場合、
関数は例外を発生させます (tryBase58Decode の場合は空文字列を返します) 。
構文
encoded— デコード対象のStringカラムまたは定数。Stringexpected_size— 省略可。デコード後の想定サイズ (バイト単位) 。32 または 64 の場合は最適化されたデコーダーが使用され、それ以外の値では汎用デコーダーが使用されます。UInt8, UInt16, UInt32, or UInt64
String
例
使用例
Query
Response
base58Encode
plaintext— エンコードする平文。String
String
例
使用例
Query
Response
base64Decode
FROM_BASE64
引数
encoded— デコードするString型のカラムまたは定数。文字列が有効な Base64 形式でエンコードされていない場合は、例外がスローされます。String
String
例
使用例
Query
Response
base64Encode
TO_BASE64
引数
plaintext— デコードする平文のカラムまたは定数。String
String
例
使用例
Query
Response
base64URLDecode
encoded— エンコード対象のString型のカラムまたは定数。文字列が有効な Base64 エンコード形式でない場合は、例外がスローされます。String
String
例
使用例
Query
Response
base64URLEncode
plaintext— エンコードする平文のカラムまたは定数。String
String
例
使用例
Query
Response
basename
expr— 文字列式です。バックスラッシュはエスケープする必要があります。String
String
例
Unix パスからファイル名を抽出
Query
Response
Query
Response
Query
Response
byteHammingDistance
mismatches
引数
戻り値
2 つの文字列のハミング距離を返します。UInt64
例
使用例
Query
Response
caseFoldUTF8
ffi のような一部の合字は、Unicode のケースフォールディング自体によって展開されるため、引き続き分解される点に注意してください。
構文
str— UTF-8 でエンコードされた入力文字列。String
String
例
基本的なケースフォールディング
Query
Response
compareSubstrings
s1— 比較対象の1つ目の文字列です。Strings2— 比較対象の2つ目の文字列です。Strings1_offset— 比較を開始するs1内の位置 (0から始まる) です。UInt*s2_offset— 比較を開始するs2内の位置 (0から始まるインデックス) です。UInt*num_bytes— 両方の文字列で比較する最大バイト数です。s1_offset(またはs2_offset) +num_bytesが入力文字列の末尾を超える場合、num_bytesはそれに応じて短くなります。UInt*
s1[s1_offset:s1_offset+num_bytes] <s2[s2_offset:s2_offset+num_bytes] の場合は-1。s1[s1_offset:s1_offset+num_bytes] =s2[s2_offset:s2_offset+num_bytes] の場合は0。s1[s1_offset:s1_offset+num_bytes] >s2[s2_offset:s2_offset+num_bytes] の場合は1。Int8
Query
Response
concat
String または FixedString 型以外の引数は、デフォルトのシリアライゼーションを使用して文字列に変換されます。
ただし、これによりパフォーマンスが低下するため、String/FixedString 以外の引数の使用は推奨されません。
構文
s1, s2, ...— 任意の型の値を任意の数だけ指定できます。Any
NULL の場合、この関数は NULL を返します。引数がない場合は、空文字列を返します。Nullable(String)
例
文字列の連結
Query
Response
Query
Response
concatAssumeInjective
concat と似ていますが、concat(s1, s2, ...) → sn が単射、
つまり引数が異なれば結果も異なると仮定します。
GROUP BY の最適化に利用できます。
構文
s1, s2, ...— 任意の型の値を、任意の数だけ指定できます。StringまたはFixedString
NULL の場合、この関数は NULL を返します。引数が渡されない場合は、空文字列を返します。String
例
GROUP BYの最適化
Query
Response
concatWithSeparator
concat_ws
引数
sep— 使用する区切り文字。const Stringまたはconst FixedStringexp1, exp2, ...— 連結する式。型がStringまたはFixedStringではない引数は、デフォルトのシリアライゼーションを使用して文字列に変換されます。パフォーマンスが低下するため、String/FixedString 以外の引数の使用は推奨されません。Any
NULL の場合、この関数は NULL を返します。String
例
使用例
Query
Response
concatWithSeparatorAssumeInjective
concatWithSeparator と同様ですが、concatWithSeparator(sep[,exp1, exp2, ... ]) → result が単射であるとみなします。
異なる引数に対して異なる結果を返す関数は、単射であると呼ばれます。
GROUP BY の最適化に使用できます。
構文
sep— 使用する区切り文字。const Stringまたはconst FixedStringexp1, exp2, ...— 連結する式。型がStringまたはFixedStringではない引数は、デフォルトのシリアライゼーションを使用して文字列に変換されます。これはパフォーマンス低下につながるため、String/FixedString以外の引数の使用は推奨されません。StringまたはFixedString
String を返します。いずれかの引数の値が NULL の場合、この関数は NULL を返します。String
例
使用例
Query
Response
conv
number— 変換する数値。文字列型または数値型を指定できます。 -from_base— 変換元の基数 (2~36) 。整数である必要があります。 -to_base— 変換先の基数 (2~36) 。整数である必要があります。
Query
Response
Query
Response
Query
Response
Query
Response
convertCharset
s を、エンコーディング from からエンコーディング to に変換して返します。
構文
from から to に変換された文字列 s を返します。String
例
使用例
Query
Response
damerauLevenshteinDistance
UInt64
例
使用例
Query
Response
decodeHTMLComponent
s— デコード対象の HTML エンティティを含む String。String
String
例
使用例
Query
Response
decodeXMLComponent
s— デコード対象の XML エンティティを含む文字列。String
String
例
使用例
Query
Response
editDistance
levenshteinDistance
引数
戻り値
2つの文字列間の編集距離を返します。UInt64
例
使用例
Query
Response
editDistanceUTF8
levenshteinDistanceUTF8
引数
戻り値
2 つの UTF-8 文字列間の編集距離を返します。UInt64
例
使用例
Query
Response
encodeXMLComponent
s— エスケープする文字列。String
String
例
使用例
Query
Response
endsWith
s が suffix で終わる場合は 1、それ以外の場合は 0 を返します。 UInt8
例
使用例
Query
Response
endsWithCaseInsensitive
s が大文字・小文字を区別しない suffix で終わる場合は 1、それ以外の場合は 0 を返します。 UInt8
例
使用例
Query
Response
endsWithCaseInsensitiveUTF8
s が、大文字・小文字を区別しない suffix で終わるかどうかを返します。
文字列には、有効な UTF-8 でエンコードされたテキストが含まれているものとします。
この前提が満たされない場合、例外はスローされず、結果は未定義です。
構文
s が大文字・小文字を区別しない suffix で終わる場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
endsWithUTF8
s が suffix で終わるかどうかを返します。
文字列には、有効な UTF-8 でエンコードされたテキストが含まれていることを前提としています。
この前提が満たされない場合でも、例外は発生せず、結果は未定義です。
構文
s が suffix で終わる場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
extractTextFromHTML
- すべての HTML/XML タグの削除
- コメント (
{/* */}) の削除 - script 要素および style 要素とその内容の削除
- CDATA セクションの処理 (そのままコピー)
- 空白の適切な処理と正規化
html— テキストの抽出元となる HTML コンテンツを含む文字列。String
String
例
使用例
Query
Response
firstLine
s— 入力文字列。String
String
例
使用例
Query
Response
idnaDecode
idnaEncode() と idnaDecode() を繰り返し適用しても、必ずしも元の文字列に戻るとは限りません。
構文
s— 入力文字列。String
String
例
使用例
Query
Response
idnaEncode
パーセントデコードや、タブ、スペース、制御文字のトリミングは行われません。
s— 入力文字列。String
String
例
使用例
Query
Response
initcap
initcap は各単語の先頭文字のみを大文字に変換するため、アポストロフィや大文字を含む単語では想定どおりにならない場合があります。
これは既知の動作であり、現時点で修正する予定はありません。s— 入力文字列。String
s を返します。String
例
使用例
Query
Response
Query
Response
initcapUTF8
initcap と同様に、initcapUTF8 は各単語の先頭文字を大文字に、それ以外の文字を小文字に変換します。
文字列には、有効な UTF-8 でエンコードされたテキストが含まれていることを前提としています。
この前提が満たされない場合でも例外は送出されず、結果は未定義です。
この関数は言語を判別しません。たとえば、トルコ語では結果が完全に正しくならない場合があります (i/İ と i/I) 。
UTF-8 バイト列の長さが、あるコードポイントの大文字と小文字で異なる場合、そのコードポイントでは結果が正しくならない可能性があります。
s— 入力文字列。String
s を返します。String
例
使用例
Query
Response
isValidASCII
isASCII
引数
- なし。
Query
Response
isValidUTF8
s— UTF-8 でエンコードされた文字列として有効かどうかを確認する対象の文字列。String
1、そうでない場合は 0 を返します。UInt8
例
使用例
Query
Response
jaroSimilarity
Float64
例
使用例
Query
Response
jaroWinklerSimilarity
Float64
例
使用例
Query
Response
left
s の左側から数えて、指定した offset 位置から始まる部分文字列を返します。
構文
s— 部分文字列を取得する元の文字列です。StringまたはFixedStringoffset— オフセットを表すバイト数です。(U)Int*
offsetが正の場合、文字列の左側からoffsetバイト分のsの部分文字列を返します。offsetが負の場合、文字列の左側からlength(s) - |offset|バイト分のsの部分文字列を返します。lengthが0の場合は空文字列を返します。String
Query
Response
Query
Response
leftPad
lengthに達するまで、文字列の左側に空白、または指定した文字列 (必要に応じて複数回) を埋め込みます。
構文
lpad
引数
string— パディングする入力文字列です。Stringlength— 結果の文字列の長さです。値が入力文字列の長さより小さい場合、入力文字列はlength文字に切り詰められます。(U)Int*pad_string— 任意。入力文字列のパディングに使用する文字列です。指定しない場合、入力文字列は空白でパディングされます。String
String
例
使用例
Query
Response
leftPadUTF8
leftPad とは異なり、こちらはコードポイント単位で文字列長を測定します。
構文
string— パディング対象の入力文字列です。Stringlength— 結果の文字列の長さです。値が入力文字列の長さより小さい場合、入力文字列はlength文字に切り詰められます。(U)Int*pad_string— 省略可能です。入力文字列のパディングに使用する文字列です。指定しない場合、入力文字列は空白でパディングされます。String
String
例
使用例
Query
Response
leftUTF8
s の左側から、指定した offset の位置から始まる部分文字列を返します。
構文
s— 部分文字列を取得する対象の UTF-8 でエンコードされた文字列。StringまたはFixedStringoffset— オフセットのバイト数。(U)Int*
offsetが正の場合、文字列の左側からoffsetバイト分のsの部分文字列を返します。\n”offsetが負の場合、文字列の左側からlength(s) - |offset|バイト分のsの部分文字列を返します。\n”lengthが 0 の場合は空文字列を返します。String
Query
Response
Query
Response
lengthUTF8
CHARACTER_LENGTH, CHAR_LENGTH
引数
s— 有効な UTF-8 でエンコードされたテキストを含む文字列。String
s の長さ (Unicode コードポイント単位) 。UInt64
例
使用例
Query
Response
lower
lcase
引数
s— 小文字に変換する対象の文字列。String
s を小文字に変換した文字列を返します。 String
例
使用例
Query
Response
lowerUTF8
input— 小文字に変換する入力文字列。String
String
例
1つ目
Query
Response
naturalSortKey
NATURAL_SORT_KEY
引数
s— ナチュラルソートキーに変換する文字列。String
s から生成されたナチュラルソートキー文字列を返します。String
例
使用例
Query
Response
normalizeUTF8NFC
str— UTF-8 でエンコードされた入力文字列。String
String
例
使用例
Query
Response
normalizeUTF8NFD
str— UTF-8 でエンコードされた入力文字列。String
String
例
使用例
Query
Response
normalizeUTF8NFKC
str— UTF-8 でエンコードされた入力文字列。String
String
例
使用例
Query
Response
normalizeUTF8NFKCCasefold
str— UTF-8 でエンコードされた入力文字列。String
String
例
使用例
Query
Response
normalizeUTF8NFKD
str— UTF-8 でエンコードされた入力文字列。String
String
例
使用例
Query
Response
punycodeDecode
s— Punycode でエンコードされた文字列。String
String
例
使用例
Query
Response
punycodeEncode
s— 入力値。String
String
使用例
使用例
Query
Response
regexpExtract
haystack 内の最初の文字列を抽出します。
構文
REGEXP_EXTRACT, REGEXP_SUBSTR
引数
haystack— 正規表現パターンの照合対象となる String。Stringpattern— String、パターン。patternには複数の正規表現グループを含めることができ、indexは抽出する正規表現グループを示します。インデックス 0 は、正規表現全体との一致を意味します。const Stringindex— 省略可能。抽出する正規表現グループを示す 0 以上の整数です。デフォルト値は、patternにキャプチャグループが少なくとも 1 つ含まれている場合は1、キャプチャグループがない場合は0(一致全体) です。(U)Int*
String
例
使用例
Query
Response
regexpPosition
haystack 内で pattern に一致する occurrence 番目の出現位置を、バイト位置 position から検索して返します (1始まりのバイト位置) 。
return_option が 0 (デフォルト) の場合は、一致の先頭バイト位置を返します。1 の場合は、一致の直後の先頭バイト位置を返します。
subexpression が 0 より大きい場合は、一致全体ではなく、対応するキャプチャグループの位置を返します。
一致が見つからない場合、または要求したキャプチャグループが一致に含まれていない場合は 0 を返します。
PostgreSQL の regexp_instr との互換性のために提供されています (このエイリアスでも公開されています) 。位置はバイト単位で、他の ClickHouse の正規表現関数と同様です。PostgreSQL の regexp_instr は文字単位です。
構文
regexpInstr, regexp_instr
引数
haystack— 検索対象の文字列。Stringpattern— 正規表現のパターン。const Stringposition— 任意。検索を開始する 1 始まりのバイト位置。デフォルト: 1。(U)Int*occurrence— 任意。何番目の一致を返すかを指定します。デフォルト: 1。(U)Int*return_option— 任意。0 は一致の開始位置を返し、1 は一致直後の位置を返します。デフォルト: 0。(U)Int*flags— 任意。正規表現フラグ。対応:i(大文字と小文字を区別しない) 、c(大文字と小文字を区別する) 、m/n(複数行アンカー) 、s(ドットが改行にも一致) 。デフォルト: 空文字列。const Stringsubexpression— 任意。位置を返すキャプチャグループのインデックス。0 は一致全体を意味します。デフォルト: 0。(U)Int*
UInt64
例
基本的な使い方
Query
Response
removeDiacriticsUTF8
removeAccentsUTF8
引数
str— UTF-8 でエンコードされた入力文字列。String
String
例
基本的なアクセントの削除
Query
Response
repeat
s を n 回繰り返した文字列です。n が負の場合、関数は空文字列を返します。String
例
使用例
Query
Response
reverseUTF8
s— 有効な UTF-8 でエンコードされたテキストを含む String。String
String
例
使用例
Query
Response
right
s の右側から指定した offset を開始位置として、部分文字列を返します。
構文
s— 部分文字列を取得する元の文字列。StringまたはFixedStringoffset— オフセットのバイト数。(U)Int*
offsetが正の場合、文字列の右側からoffsetバイト分のsの部分文字列。offsetが負の場合、文字列の右側からlength(s) - |offset|バイト分のsの部分文字列。lengthが0の場合は空文字列。String
Query
Response
Query
Response
rightPad
lengthに達するまで、文字列の右側を空白、または指定した文字列 (必要に応じて複数回) で埋めます。
構文
rpad
引数
string— パディングする入力文字列です。Stringlength— 結果の文字列の長さです。値が入力文字列の長さより小さい場合、入力文字列はlength文字に切り詰められます。(U)Int*pad_string— 省略可能です。入力文字列の右側を埋めるための文字列です。指定しない場合、入力文字列は空白で埋められます。String
String
例
使用例
Query
Response
rightPadUTF8
rightPad とは異なり、この関数では文字列の長さはコードポイント単位で測定されます。
構文
string— パディングする対象の入力文字列です。Stringlength— 生成される文字列の長さです。値が入力文字列の長さより小さい場合、入力文字列はlength文字に切り詰められます。(U)Int*pad_string— 任意。入力文字列を埋めるために使用する文字列です。指定しない場合、入力文字列は空白で埋められます。String
String
例
使用例
Query
Response
rightUTF8
s について、右側から指定した offset を開始位置とする部分文字列を返します。
構文
s— 部分文字列を取得する対象の UTF-8 でエンコードされた文字列。StringまたはFixedStringoffset— オフセットのバイト数。(U)Int*
offsetが正の場合、文字列の右側からoffsetバイト分のsの部分文字列を返します。offsetが負の場合、文字列の右側からlength(s) - |offset|バイト分のsの部分文字列を返します。lengthが0の場合は空文字列を返します。String
Query
Response
Query
Response
soundex
s— 入力文字列です。String
String
例
使用例
Query
Response
space
) を連結します。
構文
n— 空白を繰り返す回数。(U)Int*
n 回繰り返した文字列を返します。n <= 0 の場合、関数は空文字列を返します。String
例
使用例
Query
Response
sparseGrams
n のすべての部分文字列を見つけます。
このとき、部分文字列の両端にある (n-1)-gram のハッシュは、
その部分文字列内の任意の (n-1)-gram のハッシュよりも厳密に大きくなります。
ハッシュ関数として CRC32 を使用します。
構文
s— 入力文字列。Stringmin_ngram_length— 任意。抽出する N-gram の最小長です。デフォルト値および最小値は 3 です。UInt*max_ngram_length— 任意。抽出する N-gram の最大長です。デフォルト値は 100 です。min_ngram_length以上である必要があります。UInt*min_cutoff_length— 任意。指定した場合、長さがmin_cutoff_length以上の N-gram のみを返します。デフォルト値はmin_ngram_lengthと同じです。min_ngram_length以上かつmax_ngram_length以下である必要があります。UInt*
Array(String)
例
使用例
Query
Response
sparseGramsHashes
n 以上のすべての部分文字列のハッシュ値を求めます。
このとき、各部分文字列の両端にある (n-1)-gram のハッシュ値は、
その部分文字列内にある他のどの (n-1)-gram のハッシュ値よりも厳密に大きくなります。
ハッシュ関数には CRC32 を使用します。
構文
s— 入力文字列。Stringmin_ngram_length— 任意。抽出する N-gram の最小長です。デフォルト値および最小値は 3 です。UInt*max_ngram_length— 任意。抽出する N-gram の最大長です。デフォルト値は 100 です。min_ngram_length以上である必要があります。UInt*min_cutoff_length— 任意。指定した場合、長さがmin_cutoff_length以上の N-gram のみを返します。デフォルト値はmin_ngram_lengthと同じです。min_ngram_length以上かつmax_ngram_length以下である必要があります。UInt*
Array(UInt32)
例
使用例
Query
Response
sparseGramsHashesUTF8
n で、かつその部分文字列の両端にある (n-1)-gram のハッシュが、部分文字列内のどの (n-1)-gram のハッシュよりも厳密に大きい、すべての部分文字列のハッシュを返します。
UTF-8文字列を受け取り、UTF-8 シーケンスが無効な場合は例外をスローします。
ハッシュ関数として CRC32 を使用します。
構文
s— 入力文字列です。Stringmin_ngram_length— 任意。抽出される N-gram の最小長です。デフォルト値および最小値は 3 です。UInt*max_ngram_length— 任意。抽出される N-gram の最大長です。デフォルト値は 100 です。min_ngram_length以上である必要があります。UInt*min_cutoff_length— 任意。指定した場合、長さがmin_cutoff_length以上の N-gram のみが返されます。デフォルト値はmin_ngram_lengthと同じです。min_ngram_length以上、max_ngram_length以下である必要があります。UInt*
Array(UInt32)
例
使用例
Query
Response
sparseGramsUTF8
n であり、部分文字列の両端にある (n-1)-gram のハッシュが、その部分文字列内のどの (n-1)-gram のハッシュよりも厳密に大きい、すべての部分文字列を見つけます。
UTF-8 文字列を受け取り、UTF-8 シーケンスが無効な場合は例外をスローします。
ハッシュ関数として CRC32 を使用します。
構文
s— 入力文字列です。Stringmin_ngram_length— 省略可能。抽出するN-gramの最小長です。デフォルト値および最小値は 3 です。UInt*max_ngram_length— 省略可能。抽出するN-gramの最大長です。デフォルト値は 100 です。min_ngram_length以上である必要があります。UInt*min_cutoff_length— 省略可能。指定した場合、長さがmin_cutoff_length以上の N-gram のみを返します。デフォルト値はmin_ngram_lengthと同じです。min_ngram_length以上、max_ngram_length以下である必要があります。UInt*
Array(String)
例
使用例
Query
Response
startsWith
s が prefix で始まる場合は 1、そうでない場合は 0 を返します。UInt8
例
使用例
Query
Response
startsWithCaseInsensitive
s が大文字と小文字を区別しない prefix で始まる場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
startsWithCaseInsensitiveUTF8
s が大文字と小文字を区別しない prefix で始まる場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
Query
Response
startsWithUTF8
s が prefix で始まる場合は 1、そうでない場合は 0 を返します。 UInt8
例
使用例
Query
Response
stringBytesEntropy
s— 解析対象の文字列。String
Float64
例
使用例
Query
Response
stringBytesUniq
s— 解析する文字列。String
UInt16
例
使用例
Query
Response
stringJaccardIndex
Float64
例
使用例
Query
Response
stringJaccardIndexUTF8
stringJaccardIndex と同様の関数です。
構文
Float64
例
使用例
Query
Response
substring
offset から始まる、文字列 s の部分文字列を返します。
バイト位置は、以下のルールに従って 1 から数えます。
offsetが0の場合は、空文字列が返されます。offsetが負の場合、部分文字列は先頭からではなく、文字列の末尾からoffset文字分さかのぼった位置から始まります。
length では、返される部分文字列の最大バイト数を指定します。
構文
byteSlice, mid, substr
引数
s— 部分文字列を抽出する元の文字列。StringまたはFixedStringまたはEnumoffset—s内での部分文字列の開始位置。(U)Int*length— 省略可能。部分文字列の最大長。(U)Int*
offset から始まる、長さ length バイトの s の部分文字列を返します。String
例
基本的な使い方
Query
Response
substringIndex
delim が count 回現れる位置より前にある s の部分文字列を返します。
構文
SUBSTRING_INDEX
引数
s— 部分文字列を抽出する対象の文字列です。Stringdelim— 分割に使用する区切り文字です。Stringcount— 部分文字列を抽出する前に数える区切り文字の出現回数です。countが正の場合は、最後の区切り文字 (左から数えた場合) より左側のすべてが返されます。countが負の場合は、最後の区切り文字 (右から数えた場合) より右側のすべてが返されます。UIntまたはInt
s のうち、delim が count 回出現する位置より前の部分文字列を返します。 String
例
使用例
Query
Response
substringIndexUTF8
delim が count 回出現する位置より前にある s の部分文字列を返します。
文字列には有効な UTF-8 でエンコードされたテキストが含まれていることを前提とします。
この前提が満たされない場合でも、例外はスローされず、結果は未定義です。
構文
s— 部分文字列を抽出する対象の文字列です。Stringdelim— 分割に使用する文字です。Stringcount— 部分文字列を抽出する前に数える区切り文字の出現回数です。countが正の場合は、最後の区切り文字 (左から数える) より左側のすべてが返されます。countが負の場合は、最後の区切り文字 (右から数える) より右側のすべてが返されます。UIntまたはInt
delim が count 回出現する位置より前の s の部分文字列を返します。String
例
UTF8 の例
Query
Response
substringUTF8
offset から始まる文字列 s の部分文字列を返します。
コードポイントのカウントは、次のルールに従って 1 から始まります。
offsetが0の場合は、空文字列が返されます。offsetが負の値の場合、部分文字列は文字列の先頭ではなく、末尾からoffsetコードポイント分の位置から始まります。
length は、返される部分文字列に含められるコードポイント数の最大値を指定します。
この関数は、文字列に有効な UTF-8 でエンコードされたテキストが含まれていることを前提としています。
この前提が満たされない場合でも、例外はスローされず、結果は未定義です。
s— 部分文字列を取得する元の文字列です。StringまたはFixedStringまたはEnumoffset—s内での部分文字列の開始位置です。IntまたはUIntlength— 部分文字列の最大長です。省略可能です。IntまたはUInt
offset から始まる、length 個のコードポイントからなる s の部分文字列を返します。String
例
使用例
Query
Response
toValidUTF8
� (U+FFFD) に置き換え、文字列を有効な UTF-8 エンコーディングに変換します。
不正な文字が複数連続している場合は、1 つの置換文字にまとめられます。
構文
s—Stringデータ型のオブジェクトとして表される任意のバイト列。String
String
例
使用例
Query
Response
trimBoth
trim
引数
戻り値
指定した文字を両端からトリムした文字列を返します。String
例
使用例
Query
Response
trimLeft
ltrim
引数
戻り値
左側から指定した文字がトリムされた文字列を返します。 String
例
使用例
Query
Response
trimRight
rtrim
引数
戻り値
右側から指定した文字をトリムした文字列を返します。 String
例
使用例
Query
Response
tryBase32Decode
encoded— デコード対象のString型のカラムまたは定数。文字列が有効な Base32 エンコードでない場合は、エラー時に空文字列を返します。String
String
例
使用例
Query
Response
tryBase58Decode
base58Decode と同様ですが、エラーが発生した場合は空文字列を返します。
構文
encoded— String型のカラムまたは定数。文字列が有効なBase58エンコードでない場合、エラー時には空文字列を返します。Stringexpected_size— 任意。デコード後の想定サイズ (バイト単位) 。32 または 64 の場合は最適化されたデコーダーが使用され、それ以外の値では汎用デコーダーが使用されます。UInt8, UInt16, UInt32, or UInt64
String
例
使用例
Query
Response
tryBase64Decode
base64Decode と同様ですが、エラーが発生した場合は空文字列を返します。
構文
encoded— デコードするString型のカラムまたは定数。文字列が有効な Base64 エンコードでない場合、エラー時には空文字列を返します。String
String
例
使用例
Query
Response
tryBase64URLDecode
base64URLDecode と同様ですが、エラーが発生した場合は空文字列を返します。
構文
encoded— デコードするString型のカラムまたは定数。文字列が有効な Base64 エンコードでない場合、エラー時には空文字列を返します。String
String
例
使用例
Query
Response
tryIdnaEncode
s— 入力文字列。String
String
例
使用例
Query
Response
tryPunycodeDecode
punycodeDecode と同様ですが、有効な Punycode でエンコードされた文字列が指定されていない場合は空文字列を返します。
構文
s— Punycode でエンコードされた文字列。String
String
例
使用例
Query
Response
upper
ucase
引数
s— 大文字に変換する対象の文字列。String
s を大文字に変換した文字列を返します。 String
例
使用例
Query
Response
upperUTF8
この関数は言語を判別しないため、たとえばトルコ語では結果が完全に正確にならない場合があります (i/İ と i/I など) 。
UTF-8 のバイト列の長さが、あるコードポイントの大文字と小文字で異なる場合 (
ẞ と ß など) 、そのコードポイントについては結果が正しくない可能性があります。s— String型。String
String
例
使用例
Query
Response