> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > 文字列置換関数のドキュメント # 文字列置換関数 [一般的な文字列関数](/ja/reference/functions/regular-functions/string-functions) と [文字列検索関数](/ja/reference/functions/regular-functions/string-search-functions) については、別途説明しています。 以下のドキュメントは、`system.functions` システムテーブルから生成されています。 {/*AUTOGENERATED_START*/}
## format
導入バージョン: v20.1.0 Python のフォーマットと同様に、引数で指定した値 (文字列、整数など) を使って `pattern` 文字列をフォーマットします。 パターン文字列には、中かっこ `{}` で囲まれた置換フィールドを含めることができます。 中かっこで囲まれていない部分はすべてリテラルテキストと見なされ、そのまま出力にコピーされます。 中かっこそのものを文字として扱うには、`{{` および `}}` のように 2 つ重ねてエスケープします。 フィールド名には数値 (0 から始まる) か空欄を指定できます (空欄の場合は、暗黙的に連番が割り当てられます) 。 **構文** ```sql theme={null} format(pattern, s0[, s1, ...]) ``` **引数** * `pattern` — プレースホルダーを含むフォーマット文字列。[`String`](/ja/reference/data-types/string) * `s0[, s1, ...]` — `pattern` に埋め込む 1 つ以上の値。[`Any`](/ja/reference/data-types/index) **戻り値** フォーマットされた文字列を返します。[`String`](/ja/reference/data-types/string) **例** **番号付きプレースホルダー** ```sql title=Query theme={null} SELECT format('{1} {0} {1}', 'World', 'Hello') ``` ```response title=Response theme={null} ┌─format('{1} {0} {1}', 'World', 'Hello')─┐ │ Hello World Hello │ └─────────────────────────────────────────┘ ``` **暗黙的な番号付け** ```sql title=Query theme={null} SELECT format('{} {}', 'Hello', 'World') ``` ```response title=Response theme={null} ┌─format('{} {}', 'Hello', 'World')─┐ │ Hello World │ └───────────────────────────────────┘ ```
## overlay
導入バージョン: v24.9.0 文字列 `input` の一部を、1 から始まる位置 `offset` から別の文字列 `replace` に置き換えます。 **構文** ```sql theme={null} overlay(s, replace, offset[, length]) ``` **引数** * `s` — 入力文字列。[`String`](/ja/reference/data-types/string) * `replace` — 置換文字列。[`const String`](/ja/reference/data-types/string) * `offset` — 整数型 `Int` (1始まり) 。`offset` が負の場合は、文字列 `s` の末尾から数えます。[`Int`](/ja/reference/data-types/int-uint) * `length` — 任意。整数型 `Int`。`length` は、入力文字列 `s` 内で置換する部分文字列の長さを指定します。`length` を指定しない場合、`s` から削除されるバイト数は `replace` の長さと同じになります。指定した場合は、`length` バイトが削除されます。[`Int`](/ja/reference/data-types/int-uint) **戻り値** 置換後の文字列を返します。[`String`](/ja/reference/data-types/string) **例** **基本的な置換** ```sql title=Query theme={null} SELECT overlay('My father is from Mexico.', 'mother', 4) AS res; ``` ```response title=Response theme={null} ┌─res──────────────────────┐ │ My mother is from Mexico.│ └──────────────────────────┘ ``` **長さを指定する置換** ```sql title=Query theme={null} SELECT overlay('My father is from Mexico.', 'dad', 4, 6) AS res; ``` ```response title=Response theme={null} ┌─res───────────────────┐ │ My dad is from Mexico.│ └───────────────────────┘ ```
## overlayUTF8
導入バージョン: v24.9.0 1 始まりの位置 `offset` から、文字列 `s` の一部を別の文字列 `replace` に置き換えます。 文字列には、有効な UTF-8 でエンコードされたテキストが含まれていることを前提としています。 この前提が満たされない場合でも、例外は送出されず、結果は未定義です。 **構文** ```sql theme={null} overlayUTF8(s, replace, offset[, length]) ``` **引数** * `s` — 入力文字列。 [`String`](/ja/reference/data-types/string) * `replace` — 置換文字列。 [`const String`](/ja/reference/data-types/string) * `offset` — 整数型 `Int` (1始まり) 。`offset` が負の場合は、入力文字列 `s` の末尾から数えます。 [`(U)Int*`](/ja/reference/data-types/int-uint) * `length` — 任意。置換する入力文字列 `s` 内の部分文字列の長さを指定します。`length` を指定しない場合、`s` から削除される文字数は `replace` の長さと同じです。指定した場合は、`length` 文字を削除します。 [`(U)Int*`](/ja/reference/data-types/int-uint) **戻り値** 置換後の文字列を返します。 [`String`](/ja/reference/data-types/string) **例** **UTF-8 の置換** ```sql title=Query theme={null} SELECT overlayUTF8('Mein Vater ist aus Österreich.', 'der Türkei', 20) AS res; ``` ```response title=Response theme={null} ┌─res───────────────────────────┐ │ Mein Vater ist aus der Türkei.│ └───────────────────────────────┘ ```
## printf
導入バージョン: v24.8.0 `printf` 関数は、引数で指定した値 (文字列、整数、浮動小数点数など) を使って、C++ の `printf` 関数と同様に文字列をフォーマットします。 フォーマット文字列には、`%` 文字で始まるフォーマット指定子を含めることができます。 `%` と、それに続くフォーマット指定子に含まれないものは、すべてリテラルテキストと見なされ、そのまま出力にコピーされます。 リテラルの `%` 文字は `%%` でエスケープできます。 フォーマット文字列には、定数またはカラム式を指定できるため、行ごとに異なるフォーマットパターンを使用できます。 **構文** ```sql theme={null} printf(format[, sub1, sub2, ...]) ``` **引数** * `format` — `%` 指定子を含むフォーマット文字列。[`String`](/ja/reference/data-types/string) * `sub1, sub2, ...` — 任意。フォーマット文字列に埋め込む 0 個以上の値。[`Any`](/ja/reference/data-types/index) **戻り値** フォーマットされた文字列を返します。[`String`](/ja/reference/data-types/string) **例** **C++スタイルのフォーマット** ```sql title=Query theme={null} SELECT printf('%%%s %s %d', 'Hello', 'World', 2024); ``` ```response title=Response theme={null} ┌─printf('%%%s %s %d', 'Hello', 'World', 2024)─┐ │ %Hello World 2024 │ └──────────────────────────────────────────────┘ ```
## regexpQuoteMeta
導入バージョン: v20.1.0 正規表現で特別な意味を持つ次の文字の前に、バックスラッシュを追加します: `\0`, `\\`, `|`, `(`, `)`, `^`, `$`, `.`, `[`, `]`, `?`, `*`, `+`, `{`, `:`, `-`。 この実装は、re2::RE2::QuoteMeta とは若干異なります。 ゼロバイトは `\x00` ではなく `\0` としてエスケープされ、必要な文字のみがエスケープされます。 **構文** ```sql theme={null} regexpQuoteMeta(s) ``` **引数** * `s` — 正規表現用にエスケープする文字を含む入力文字列。[`String`](/ja/reference/data-types/string) **戻り値** 正規表現の特殊文字がエスケープされた文字列を返します。[`String`](/ja/reference/data-types/string) **例** **正規表現の特殊文字をエスケープする** ```sql title=Query theme={null} SELECT regexpQuoteMeta('Hello. [World]? (Yes)*') AS res ``` ```response title=Response theme={null} ┌─res───────────────────────────┐ │ Hello\. \[World\]\? \(Yes\)\* │ └───────────────────────────────┘ ```
## replaceAll
導入バージョン: v1.1.0 `haystack` 内にある部分文字列 `pattern` を、`replacement` 文字列にすべて置き換えます。 **構文** ```sql theme={null} replaceAll(haystack, pattern, replacement) ``` **別名**: `replace` **引数** * `haystack` — 検索対象の文字列です。[`String`](/ja/reference/data-types/string) * `pattern` — 検索して置換する部分文字列です。[`const String`](/ja/reference/data-types/string) * `replacement` — `pattern` を置き換える文字列です。[`const String`](/ja/reference/data-types/string) **戻り値** `pattern` のすべての出現箇所を置換した文字列を返します。[`String`](/ja/reference/data-types/string) **例** **すべての出現箇所を置換** ```sql title=Query theme={null} SELECT replaceAll('Hello, Hello world', 'Hello', 'Hi') AS res; ``` ```response title=Response theme={null} ┌─res──────────┐ │ Hi, Hi world │ └──────────────┘ ```
## replaceOne
導入バージョン: v1.1.0 `haystack` 内で最初に出現する部分文字列 `pattern` を、文字列 `replacement` に置き換えます。 **構文** ```sql theme={null} replaceOne(haystack, pattern, replacement) ``` **引数** * `haystack` — 検索対象の入力文字列です。[`String`](/ja/reference/data-types/string) * `pattern` — 検索して置換する部分文字列です。[`const String`](/ja/reference/data-types/string) * `replacement` — `pattern` を置換する文字列です。[`const String`](/ja/reference/data-types/string) **戻り値** `pattern` の最初の出現箇所を置換した文字列を返します。[`String`](/ja/reference/data-types/string) **例** **最初の出現箇所を置換** ```sql title=Query theme={null} SELECT replaceOne('Hello, Hello world', 'Hello', 'Hi') AS res; ``` ```response title=Response theme={null} ┌─res─────────────┐ │ Hi, Hello world │ └─────────────────┘ ```
## replaceRegexpAll
導入バージョン: v1.1.0 `replaceRegexpOne` と似ていますが、パターンに一致するすべての箇所を置き換えます。 ただし、正規表現が空の部分文字列にマッチする場合、置換は1回しか行われません。 **構文** ```sql theme={null} replaceRegexpAll(haystack, pattern, replacement) ``` **別名**: `REGEXP_REPLACE` **引数** * `haystack` — 検索対象の入力文字列です。[`String`](/ja/reference/data-types/string) * `pattern` — 検索する正規表現パターンです。[`const String`](/ja/reference/data-types/string) * `replacement` — パターンの置換に使用する文字列です。置換指定を含めることができます。[`const String`](/ja/reference/data-types/string) **戻り値** すべての正規表現一致が置換された文字列を返します。[`String`](/ja/reference/data-types/string) **例** **すべての文字を2倍にして置換する** ```sql title=Query theme={null} SELECT replaceRegexpAll('Hello123', '.', '\\\\0\\\\0') AS res ``` ```response title=Response theme={null} ┌─res──────────────────┐ │ HHeelllloo112233 │ └──────────────────────┘ ``` **空文字列の置換例** ```sql title=Query theme={null} SELECT replaceRegexpAll('Hello, World!', '^', 'here: ') AS res ``` ```response title=Response theme={null} ┌─res─────────────────┐ │ here: Hello, World! │ └─────────────────────┘ ```
## replaceRegexpOne
導入バージョン: v1.1.0 `haystack` 内で、正規表現 `pattern` (re2 構文) に一致する部分文字列の最初の出現箇所を `replacement` 文字列に置き換えます。 `replacement` には置換 `\0-\9` を含めることができます。 置換 `\1-\9` は第1〜第9のキャプチャグループ (部分一致) に対応し、置換 `\0` は一致全体に対応します。 `pattern` または `replacement` 文字列内で `\` 文字そのものを使用するには、`\` でエスケープします。 また、文字列リテラルでは追加のエスケープが必要になる点にも注意してください。 **構文** ```sql theme={null} replaceRegexpOne(haystack, pattern, replacement) ``` **引数** * `haystack` — 検索対象の入力文字列です。[`String`](/ja/reference/data-types/string) * `pattern` — 検索する正規表現パターンです。[`const String`](/ja/reference/data-types/string) * `replacement` — `pattern` に一致した部分を置き換える文字列です。置換指定 を含めることができます。[`const String`](/ja/reference/data-types/string) **戻り値** 最初に一致した正規表現パターンを置き換えた文字列を返します。[`String`](/ja/reference/data-types/string) **例** **ISO日付をアメリカ形式に変換する** ```sql title=Query theme={null} SELECT DISTINCT EventDate, replaceRegexpOne(toString(EventDate), '(\\d{4})-(\\d{2})-(\\d{2})', '\\2/\\3/\\1') AS res FROM test.hits LIMIT 7 FORMAT TabSeparated ``` ```response title=Response theme={null} 2014-03-17 03/17/2014 2014-03-18 03/18/2014 2014-03-19 03/19/2014 2014-03-20 03/20/2014 2014-03-21 03/21/2014 2014-03-22 03/22/2014 2014-03-23 03/23/2014 ``` **文字列を10回繰り返す** ```sql title=Query theme={null} SELECT replaceRegexpOne('Hello, World!', '.*', '\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0') AS res ``` ```response title=Response theme={null} ┌─res────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World! │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ```
## translate
導入バージョン: v22.7.0 `from` および `to` 文字列で定義された 1 対 1 の文字対応に従って、文字列 `s` 内の文字を置換します。 `from` と `to` は定数の ASCII 文字列である必要があります。 `from` と `to` の長さが同じ場合、`s` 内の `from` の 1 文字目は `to` の 1 文字目に、`from` の 2 文字目は `to` の 2 文字目に、というように置換されます。 `from` に `to` より多くの文字が含まれている場合、`to` に対応する文字がない `from` 末尾の文字は、`s` からすべて削除されます。 `s` 内の非 ASCII 文字は、この関数では変更されません。 **構文** ```sql theme={null} translate(s, from, to) ``` **引数** * `s` — 変換対象の入力文字列。[`String`](/ja/reference/data-types/string) * `from` — 置換する文字を含む定数 ASCII 文字列。[`const String`](/ja/reference/data-types/string) * `to` — 置換後の文字を含む定数 ASCII 文字列。[`const String`](/ja/reference/data-types/string) **戻り値** 文字変換が適用された文字列を返します。[`String`](/ja/reference/data-types/string) **例** **文字マッピング** ```sql title=Query theme={null} SELECT translate('Hello, World!', 'delor', 'DELOR') AS res ``` ```response title=Response theme={null} ┌─res───────────┐ │ HELLO, WORLD! │ └───────────────┘ ``` **長さが異なる場合** ```sql title=Query theme={null} SELECT translate('clickhouse', 'clickhouse', 'CLICK') AS res ``` ```response title=Response theme={null} ┌─res───┐ │ CLICK │ └───────┘ ```
## translateUTF8
導入バージョン: v22.7.0 [`translate`](#translate) と同様ですが、`s`、`from`、`to` は UTF-8 でエンコードされた文字列であることを前提としています。 **構文** ```sql theme={null} translateUTF8(s, from, to) ``` **引数** * `s` — 変換対象の UTF-8 入力文字列。[`String`](/ja/reference/data-types/string) * `from` — 置換対象の文字を含む定数 UTF-8 文字列。[`const String`](/ja/reference/data-types/string) * `to` — 置換後の文字を含む定数 UTF-8 文字列。[`const String`](/ja/reference/data-types/string) **戻り値** `String` データ型の値を返します。[`String`](/ja/reference/data-types/string) **例** **UTF-8 文字の変換** ```sql title=Query theme={null} SELECT translateUTF8('Münchener Straße', 'üß', 'us') AS res; ``` ```response title=Response theme={null} ┌─res──────────────┐ │ Munchener Strase │ └──────────────────┘ ```