文字列関数の構文 - Simple Log Service - Alibaba Cloud ドキュメントセンター

このトピックでは、文字列関数の構文とパラメーターについて説明します。このトピックでは、関数の使用方法の例も示します。

関数

カテゴリ	関数	説明
マルチストリング操作	str_形式	指定した形式で文字列をフォーマットします。
	str_join	指定したコネクタを使用して入力文字列を連結し、新しい文字列を生成します。
	str_zip	式によって返される2つの値または文字列を分割し、結果を1つの文字列に結合します。
エンコードとデコード	str_encode	指定されたエンコード形式を使用して文字列をエンコードします。
	str_decode	指定されたエンコード形式を使用して入力値をデコードします。
	str_hex_escape_encode	特殊文字をエスケープします。この関数は、16進文字を漢字にエスケープできます。
	str_uuid	ランダムなUUIDを生成します。
ソート、反転、および交換	str_sort	指定したオブジェクトをソートします。
	str_reverse	文字列を反転します。
	str_replace	指定されたルールに基づいて、既存の文字列を新しい文字列に置き換えます。
	str_logstash_config_normalize	Logstash設定言語のデータをJSON形式に変換します。
	str_translate	マッピング関係に基づいて、文字列内の指定された文字を新しい文字に置き換えます。
定期的なmunging	str_ストリップ	指定した文字を文字列から削除します。
	str_lstrip	文字列の先頭から指定した文字を削除します。
	str_rstrip	文字列の末尾から指定した文字を削除します。
	str_lower	文字列内のすべての大文字を小文字に変換します。
	str_upper	文字列内のすべての小文字を大文字に変換します。
	str_title	文字列内の各単語の最初の文字を大文字にし、文字列内の他の文字を小文字に変換します。
	str_capitalize	文字列の最初の文字を大文字にし、文字列内の他の文字を小文字に変換します。
	str_swapcase	文字列の大文字を小文字に、小文字を大文字に変換します。
検索とチェック	str_count	文字列内の文字の発生回数をカウントします。
	str_find	文字列に指定された部分文字列が含まれているかどうかをチェックします。
	str_rfind	入力文字列内の指定された文字列または文字の最後の出現位置を照会します。
	str_endswith	文字列が指定されたサフィックスで終わるかどうかをチェックします。
	str_startswith	文字列が指定されたプレフィックスで始まるかどうかをチェックします。
分割	str_split	指定された区切り文字を使用して文字列を分割します。
	str_splitlines	ラインフィードを使用して文字列を分割します。
	str_パーティション	指定された区切り文字を使用して、文字列を左から右に3つの部分に分割します。
	str_rpartition	指定された区切り文字を使用して、文字列を右から左に3つの部分に分割します。
フォーマット	str_センター	指定した文字を使用して、指定した長さに文字列をパディングします。
	str_ljust	右は、指定された文字を使用して、文字列を指定された長さにパディングします。
	str_rjust	左は、指定した文字を使用して、文字列を指定した長さにパディングします。
	str_zfill	左は、0を使用して文字列を指定された長さにパディングします。
	str_expandtabs	文字列の `\t`をスペースに変換します。
文字セットチェック	str_isalnum	文字列に文字と数字のみが含まれているかどうかを確認します。
	str_isalpha	文字列に文字のみが含まれるかどうかをチェックします。
	str_isascii	文字列がASCIIテーブルにあるかどうかをチェックします。
	str_isdecimal	文字列に小数文字のみが含まれているかどうかを確認します。
	str_isdigit	文字列に数字のみが含まれるかどうかをチェックします。
	str_isidentifier	文字列が有効なPython識別子であるかどうか、または変数名が有効かどうかを確認します。
	str_islower	文字列に小文字のみが含まれているかどうかをチェックします。
	str_isnumeric	文字列内のすべての文字が数値であるかどうかをチェックします。
	str_isprintable	文字列内のすべての文字が印刷可能な文字かどうかをチェックします。
	str_isspace	文字列にスペースのみが含まれるかどうかをチェックします。
	str_istitle	文字列の各単語の最初の文字が大文字で、文字列の他の文字が小文字であるかどうかを確認します。
	str_isapper	文字列内のすべての文字が大文字かどうかをチェックします。

次の表に、文字列関数と一緒に使用できる関数を示します。

カテゴリ	関数	説明
マルチストリング操作	op_add	複数の数値または文字列の合計値を返します。
	op_max	複数の数値または文字列の最大値を返します。
	op_min	複数の数値または文字列の最小値を返します。
文字列の切り捨て	op_slice	文字列を切り捨てます。
長さの計算	op_len	文字列の長さを返します。

str_format

str_format関数は、指定された形式で文字列をフォーマットします。

構文

str_format(format_string, value1, value2, ...)

パラメーター

パラメーター	データ型	必須	説明
format_string	任意 (文字列型に自動的に変換)	課金されます	出力文字列の形式。例: `{}={}`
value1	任意	課金されます	フォーマットする値。The value that you want to format.
value2	任意	課金されます	フォーマットする値。The value that you want to format.

レスポンス
フォーマットされた文字列が返されます。

例

生ログ
```
class: Format
escape_name: Traditional
```

変換ルール

e_set("str_format", str_format("{}={}", v("class"), v("escape_name")))

結果

class: Format
escape_name: Traditional
str_format: Format=Traditional

str_join

str_join関数は、指定されたコネクタを使用して入力文字列を連結し、新しい文字列を生成します。

構文

str_join(connector, value1,  value2, ....)

パラメーター

パラメーター	データ型	必須	説明
コネクター	任意 (文字列型に自動的に変換)	課金されます	コネクタ。サポートされているコネクタには、感嘆符 (!) 、記号 (@) 、数値記号 (#) 、ドル記号 ($) 、およびパーセント記号 (%) が含まれます。
value1	任意 (文字列型に自動的に変換)	課金されます	連結する値。The value that you want to concatenate.
value2	任意 (文字列型に自動的に変換)	課金されます	連結する値。The value that you want to concatenate.

レスポンス
連結された文字列が返されます。

例

生ログ
```
name: ETL
company: aliyun.com
```

変換ルール

e_set("email", str_join("@", v("name"), v("company")))

結果

name: ETL
company: aliyun.com
email:ETL@aliyun.com

str_encode

str_encode関数は、指定されたエンコード形式を使用して文字列をエンコードします。

構文

str_encode(value, "utf8", errors="ignore")

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	エンコードする値。The value that you want to encode.
encoding	String	課金されません	エンコード形式。デフォルト値は UTF-8 です。 ASCIIがサポートされています。
エラー	String	課金されません	エンコード形式に基づいて文字を認識できない場合に文字を処理するために使用されるメソッド。有効な値： ignore (デフォルト): 文字はエンコードされていません。 strict: エラーが報告され、ログが破棄されます。 replace: 認識できない文字は疑問符 (?) に置き換えられます。 xmlcharrefreplace: 認識できない文字はXML文字に置き換えられます。

レスポンス
エンコードされた文字列が返されます。

例

例 1

生ログ
```
test: asewds
```

変換ルール

e_set("f1", str_decode(str_encode("Hello", "utf8"), "utf8"))

結果
```
test: asewds
f1: Hello
```

例 2

生ログ
```
f2: test Test data
```

変換ルール

e_set("f1", str_encode(v("f2"), "ascii", errors="ignore"))

結果
```
f1:test 
f2:test Test data
```

例 3
- 生ログ
```
f2: test Test data
```
- 変換ルール
```
e_set("f1", str_encode(v("f2"), "ascii", errors="strict"))
```
- 結果
  実行中にエラーが報告されます。

例 4

生ログ
```
f2: test Test data
```

変換ルール

e_set("f1", str_encode(v("f2"), "ascii", errors="replace"))

結果
```
f1:test ????
f2:test Test data
```

例 5

生ログ
```
f2: test Test data
```

変換ルール

e_set("f1", str_encode(v("f2"), "ascii", errors="xmlcharrefreplace"))

結果

f1:test &#27979;&#35797;&#25968;&#25454;
f2:test Test data

str_decode

str_decode関数は、指定されたエンコード形式を使用して入力値をデコードします。

構文
```
str_decode(value, "utf8", errors="ignore")
```
説明
str_decode関数は、バイトデータ型のデータのみを処理できます。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	デコードする値。The value that you want to decode.
encoding	任意 (文字列型に自動的に変換)	課金されません	エンコード形式。デフォルト値は UTF-8 です。 ASCIIがサポートされています。
エラー	任意 (文字列型に自動的に変換)	課金されません	エンコード形式に基づいて文字を認識できない場合に文字を処理するために使用されるメソッド。有効な値： ignore (デフォルト): 文字はデコードされません。 strict: エラーが報告され、ログが破棄されます。 replace: 認識できない文字は疑問符 (?) に置き換えられます。 xmlcharrefreplace: 認識できない文字はXML文字に置き換えられます。

レスポンス
デコードされた値が返されます。

例

生ログ
```
test: asewds
```

変換ルール

e_set("encoding", str_decode(b'\xe4\xbd\xa0\xe5\xa5\xbd', "utf8", 'strict'))

結果
```
test: asewds
encoding: Hello
```

str_replace

str_replace関数は、指定されたルールに基づいて、既存の文字列を新しい文字列に置き換えます。

構文
```
str_replace(value, old, new, count)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	文字列を置き换える値。
old	任意 (文字列型に自動的に変換)	課金されます	置き換える文字列。The string that you want to replace.
new	任意 (文字列型に自動的に変換)	課金されます	置き換え後の文字列。
集計	回	課金されません	交換の数。このパラメーターを設定しない場合、値のすべてのオカレンスで指定された文字列が置き換えられます。

レスポンス
新しい文字列が返されます。

例

辞書をJSON形式に変換します。

生ログ

content:  {'referer': '-', 'request': 'GET /phpMyAdmin', 'status': 404, 'data-1': {'aaa': 'Mozilla', 'bbb': 'asde'}, 'data-2': {'up_adde': '-', 'up_host': '-'}}

変換ルール

e_set("content_json", str_replace(ct_str(v("content")),"'",'"'))

結果

content:  {'referer': '-', 'request': 'GET /phpMyAdmin', 'status': 404, 'data-1': {'aaa': 'Mozilla', 'bbb': 'asde'}, 'data-2': {'up_adde': '-', 'up_host': '-'}}
content_json:  {"referer": "-", "request": "GET /phpMyAdmin", "status": 404, "data-1": {"aaa": "Mozilla", "bbb": "asde"}, "data-2": {"up_adde": "-", "up_host": "-"}}

str_sort

str_sort関数は、指定されたオブジェクトをソートします。

構文
```
str_sort(value, reverse=False)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	ソートする元の文字列。
reverse	ブール値	課金されません	デフォルト値: False。これは、文字列が昇順でソートされていることを示します。

レスポンス
ソートされた文字列が返されます。
例
- 例1: strフィールドの値をアルファベット順に並べ替えます。
  - 生ログ
```
str: twish
```
  - 変換ルール
```
e_set("str_sort", str_sort(v("str")))
```
  - 結果
```
str: twish
str_sort: histw 
```
- 例2: strフィールドの値を2文字ペアの粒度でアルファベット順に並べ替えます。
  - 生ログ
```
str: twish
```
  - 変換ルール
```
e_set("str_sort", str_sort(v("str"), reverse=True))
```
  - 結果
```
str: twish
str_sort: wtsih
```

str_reverse

str_reverse関数は文字列を反転します。

構文
```
str_reverse(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
反転する値。The value that you want to reverse.
レスポンス
逆の文字列が返されます。

例

dataフィールドの値を反転します。

生ログ
```
data:twish
```

変換ルール

e_set("reverse_data", str_reverse(v("data")))

結果
```
data:twish
reverse_data:hsiwt
```

str_logstash_config_normalize

str_logstash_config_normalize関数は、Logstash設定言語のデータをJSON形式に変換します。

構文
```
str_logstash_config_normalize(value)
```
説明
Logstash設定言語の詳細については、「Logstash」をご参照ください。
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する値。The value that you want to convert.
レスポンス
変換された文字列が返されます。

例

Logstashのフィールドの値を変換します。

生ログ
```
logstash: {"name"=>"tw5"}
```

変換ルール

e_set("normalize_data", str_logstash_config_normalize(v("logstash")))

結果

logstash: {"name"=>"tw5"}
normalize_data:{"name":"tw5"}

str_hex_escape_encode

str_hex_escape_encode関数は特殊文字をエスケープします。この関数は、16進文字を漢字にエスケープできます。

構文
```
str_hex_escape_encode(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
エスケープしたい値。
レスポンス
エスケープされた文字列が返されます。

例

myfriendフィールドの値を漢字にエスケープします。

生ログ
```
myfriend: \xE6\x9F\xB3\xE4\xBA\x91
```

変換ルール

e_set("hex_myfriend", str_hex_escape_encode("myfriend"))

結果

hex_myfriend:myfriend
myfriend:\xE6\x9F\xB3\xE4\xBA\x91

str_strip

str_strip関数は、指定した文字を文字列から削除します。

構文
```
str_strip(value, chars)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
chars	任意 (文字列型に自動的に変換)	課金されません	指定した文字列の先頭と末尾から削除する文字セット。デフォルト値: `\t\r\n`

レスポンス
新しい文字列が返されます。
例
- 例1: ストリップフィールド値の先頭からアスタリスク (*) を削除します。
  - 生ログ
```
strip: ***I love Etl
```
  - 変換ルール
```
e_set("str_strip", str_strip(v("strip"), "*"))
```
  - 結果
```
strip: ***I love Etl
str_strip:I love Etl
```
- 例2: ストリップフィールド値の先頭からスペースを削除します。
  - 生ログ
```
strip:    I love Etl
```
  - 変換ルール
```
e_set("str_strip", str_strip(v("strip")))
```
  - 結果
```
strip:    I love Etl
str_strip: I love Etl
```
- 例3: xy文字セットを削除します。
  - 生ログ
```
strip:xy123yx
```
  - 変換ルール
```
e_set("str_strip", str_strip(v("strip"), "xy"))
```
  - 結果
```
strip:xy123yx
str_strip:123
```

str_lower

str_lower関数は、文字列内のすべての大文字を小文字に変換します。

構文
```
str_lower(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する文字列。
レスポンス
変換された文字列が返されます。
例
nameフィールドの値を小文字に変換します。
- 生ログ
```
name: Etl
```
- 変換ルール
```
e_set("str_lower", str_lower(v("name")))
```
- 結果
```
name: Etl
str_lower: etl
```

str_upper

str_upper関数は、文字列内のすべての小文字を大文字に変換します。

構文
```
str_upper(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する文字列。
レスポンス
変換された文字列が返されます。
例
nameフィールドの値を大文字に変換します。
- 生ログ
```
name: etl
```
- 変換ルール
```
e_set("str_upper", str_upper(v("name")))
```
- 結果
```
name: etl
str_upper: ETL
```

str_title

str_title関数は、文字列内の各単語の最初の文字を大文字にし、文字列内の他の文字を小文字に変換します。

構文
```
str_title(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する文字列。
レスポンス
変換された文字列が返されます。
例
wordフィールドの値の各単語の最初の文字を大文字にします。
- 生ログ
```
word: this is etl
```
- 変換ルール
```
e_set("str_title", str_title(v("word")))
```
- 結果
```
word: this is etl
str_title: This Is Etl
```

str_capitalize

str_capitalize関数は、文字列の最初の文字を大文字にし、文字列内の他の文字を小文字に変換します。

構文
```
str_capitalize(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する文字列。
レスポンス
変換された文字列が返されます。
例
単語フィールドの値の最初の文字を大文字にし、値の他の文字を小文字に変換します。
- 生ログ
```
word: this Is MY EAL
```
- 変換ルール
```
e_set("str_capitalize", str_capitalize(v("word")))
```
- 結果
```
word: this Is MY EAL
str_capitalize: This is my eal
```

str_lstrip

str_lstrip関数は、文字列の先頭から指定された文字を削除します。

構文
```
str_lstrip(value, chars)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
chars	任意 (文字列型に自動的に変換)	課金されません	文字列の先頭から削除する文字セット。デフォルト値: space。

レスポンス
新しい文字列が返されます。

例

例1: 単語フィールド値の先頭からアスタリスク (*) を削除します。
- 生ログ
```
word: ***this is string
```
- 変換ルール
```
e_set("str_lstrip", str_lstrip(v("word"), "*"))
```
- 結果
```
word: ***this is string
str_lstrip: this is string
```
  です

例2: 単語フィールド値の先頭からスペースを削除します。

生ログ
```
word:     this is string
```

変換ルール

e_set("str_lstrip", str_lstrip(v("word")))

結果

word:     this is string
str_lstrip: this is string

です

例3: xy文字セットを削除します。

生ログ
```
lstrip:xy123yx
```

変換ルール

e_set("str_lstrip", str_lstrip(v("lstrip"),"xy"))

結果
```
lstrip:xy123yx
str_lstrip:123yx 
```

str_rstrip

str_rstrip関数は、文字列の末尾から指定された文字を削除します。

構文
```
str_rstrip(value, chars)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
chars	任意 (文字列型に自動的に変換)	課金されません	文字列の末尾から削除する文字セット。デフォルト値: space。

レスポンス
新しい文字列が返されます。

例

例1: 単語フィールド値の末尾からアスタリスク (*) を削除します。
- 生ログ
```
word: this is string*****
```
- 変換ルール
```
e_set("str_rstrip", str_rstrip(v("word"), "*"))
```
- 結果
```
word: this is string*****
str_rstrip: this is string
```
  です

例2: xy文字セットを削除します。

生ログ
```
word:xy123yx
```

変換ルール

e_set("str_rstrip", str_rstrip(v("word"), "xy"))

結果
```
word:xy123yx
str_rstrip:xy123
```

str_swapcase

str_swapcase関数は、文字列の大文字を小文字に、小文字を大文字に変換します。

構文
```
str_swapcase(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変換する文字列。
レスポンス
変換された文字列が返されます。

例

生ログ
```
name: this is string
```

変換ルール

e_set("str_swapcase", str_swapcase(v("name")))

結果

name: this is string
str_swapcase: THIS IS STRING

str_translate

str_translate関数は、マッピング関係に基づいて、文字列内の指定された文字を新しい文字に置き換えます。

構文

str_translate(value, replace_string, mapping_string)

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	文字を置き換える元の文字列。
replace_string	任意 (文字列型に自動的に変換)	課金されます	置き換える文字セット。The character set that you want to replace.
mapping_string	任意 (文字列型に自動的に変換)	課金されます	置き換え後の文字セット。

レスポンス
新しい文字列が返されます。

例

生ログ
```
name: I love ETL!!!
```

変換ルール

e_set("str_translate", str_translate(v("name"), "aeiou", "12345"))

結果

name: I love ETL!!!
str_translate: I l4v2 ETL!!!

str_endswith

str_endswith関数は、文字列が指定されたサフィックスで終わるかどうかをチェックします。

構文
```
str_endswith(value, suffix, start, end)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	チェックする元の文字列。
suffix	任意 (文字列型に自動的に変換)	課金されます	サフィックス。このパラメーターの値は、文字列または要素です。
start	回	課金されません	チェックが開始される位置。値0は最初の文字を指定します。値-1は最後の文字を指定します。
end	回	課金されません	チェックが終了する位置。値0は最初の文字を指定します。値-1は最後の文字を指定します。

レスポンス
文字列が指定されたサフィックスで終わる場合、値Trueが返されます。それ以外の場合、値Falseが返されます。

例

生ログ
```
name: this is endswith!!!
```

変換ルール

e_set("str_endswith",str_endswith(v("name"), "!"))

結果

name: this is endswith!!!
str_endswith: True

str_startswith

str_startswith関数は、文字列が指定されたプレフィックスで始まるかどうかをチェックします。

構文
```
str_startswith(value, prefix, start, end)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	チェックする元の文字列。
prefix	任意 (文字列型に自動的に変換)	課金されます	プレフィックス。このパラメーターの値は、文字列または要素です。
start	回	課金されません	チェックが開始される位置。値0は最初の文字を指定します。値-1は最後の文字を指定します。
end	回	課金されません	チェックが終了する位置。値0は最初の文字を指定します。値-1は最後の文字を指定します。

レスポンス
文字列が指定されたプレフィックスで始まる場合、値Trueが返されます。それ以外の場合、値Falseが返されます。

例

生ログ
```
name: !! this is startwith
```

変換ルール

e_set("str_startswith",str_startswith(v("name"), "!!"))

結果

name: !! this is startwith
str_startswith: True

str_find

str_find関数は、文字列に指定された部分文字列が含まれるかどうかをチェックします。

構文
```
str_find(value, str, begin, end)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	部分文字列を検索する元の文字列。
str	任意 (文字列型に自動的に変換)	課金されます	検索する部分文字列。
begin	回	課金されません	検索が開始される位置。デフォルト値0は最初の文字を指定します。値-1は最後の文字を指定します。
end	回	課金されません	検索が終了する位置。デフォルト値は文字列の長さです。値0は最初の文字を指定します。値-1は最後の文字を指定します。

レスポンス
元の文字列内の指定された部分文字列の位置が返されます。指定された部分文字列が元の文字列に複数回表示される場合、部分文字列の最初の出現位置のみが返されます。

例

生ログ
```
name: hello world
```

変換ルール

e_set("str_find",str_find(v("name"), "h"))

結果
```
name: hello world
str_find: 0
```

str_count

str_count関数は、文字列内の文字の発生数をカウントします。

構文
```
str_count(value, sub, start, end)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	文字の出現回数をカウントする元の文字列。
sub	任意 (文字列型に自動的に変換)	課金されます	発生回数をカウントする文字。
start	回	課金されません	指定された文字の検索が始まる文字列の位置。有効な値： 0 (デフォルト): 最初の文字 -1: 最後の文字
end	回	課金されません	指定された文字の検索が文字列内で終了する位置。有効な値： 0: 最初の文字 -1 (デフォルト): 最後の文字

レスポンス
指定された文字の発生回数が返されます。

例

生ログ
```
name: this is really a string
```
です

変換ルール

e_set("str_count", str_count(v("name"), "i"))

結果

name: this is really a string
str_count: 3

str_rfind

str_rfind関数は、入力文字列内の指定された文字列または文字の最後の出現位置を照会します。

構文
```
str_rfind(value, substr, beg, end)
```
説明
この関数を呼び出すには、基本変数パラメーターを渡します。詳細については、「関数呼び出し」をご参照ください。

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	指定した文字を検索する元の文字列。
substr	任意 (文字列型に自動的に変換)	課金されます	検索したいキャラクター。
頼む	回	課金されません	検索が開始される位置。デフォルト値：0
end	回	課金されません	検索が終了する位置。デフォルト値は文字列の長さです。

レスポンス
指定された文字または文字列の最後の出現位置が返されます。

例

生ログ
```
name: this is really a string
```
です

変換ルール

e_set("str_rfind", str_rfind(v("name"), "i"))

結果

name: this is really a string
str_rfind: 20

str_split

str_split関数は、指定された区切り文字を使用して文字列を分割します。

構文
```
str_split(value, sep=None, maxsplit=-1)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	分割する元の文字列。
sep	回	課金されません	区切り文字。値Noneはスペースを指定します。
maxsplit	回	課金されません	文字列を分割できる部分文字列の最大数。値-1は制限なしを指定します。

レスポンス
処理された文字列が返されます。
例
スペース区切り文字を使用して、コンテンツフィールドの値を分割します。
- 生ログ
```
content: hello world
```
- 変換ルール
```
e_set("str_split", str_split(v("content"), ""))
```
- 結果
```
content: hello world
str_split: ["hello", "world"]
```

str_splitlines

str_splitlines関数は、改行を使用して文字列を分割します。

構文
```
str_splitlines(value, keepends)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	分割する元の文字列。
keepends	ブール値	課金されません	結果に改行を保持するかどうかを指定します。ラインフィードには、`\r`、`\r\n`、および `\n`が含まれます。デフォルト値: False。改行の削除を指定します。値Trueは、ラインフィードが保持されることを指定します。

レスポンス
処理された文字列が返されます。

例

例 1

生ログ
```
content: ab c\n\nde fg\rkl\r\n
```

変換ルール

e_set("str_splitlines", str_splitlines(v("content"), False))

結果

content: ab c\n\nde fg\rkl\r\n
str_splitlines: ['ab c', '', 'de fg', 'kl']

例 2

生ログ
```
content: ab c\n\nde fg\rkl\r\n
```

変換ルール

e_set("str_splitlines", str_splitlines(v("content"), True))

結果

content: ab c\n\nde fg\rkl\r\n  
str_splitlines: ['ab c\n', '\n', 'de fg\r', 'kl\r\n']

str_partition

str_partition関数は、指定された区切り文字を使用して文字列を左から右に3つの部分に分割します。

構文
```
str_partition(value, substr)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	分割する文字列。
substr	任意 (文字列型に自動的に変換)	課金されません	区切り文字。

レスポンス
処理された文字列が返されます。
例
を使用して、Webサイトのフィールド値を左から右に3つの部分に分割します。 デリミター。
- 生ログ
```
website: www.aliyun.com
```
- 変換ルール
```
e_set("str_partition", str_partition(v("website"), "."))
```
- 結果
```
website: www.aliyun.com
str_partition:  ["www", ".", "aliyun.com"]
```

str_rpartition

str_rpartition関数は、指定された区切り文字を使用して、文字列を右から左に3つの部分に分割します。

構文
```
str_rpartition(value, substr)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	分割する元の文字列。
substr	任意 (文字列型に自動的に変換)	課金されません	区切り文字。

レスポンス
処理された文字列が返されます
例
を使用して、Webサイトのフィールド値を右から左に3つの部分に分割します。 デリミター。
- 生ログ
```
website: www.aliyun.com
```
- 変換ルール
```
e_set("str_partition", str_rpartition(v("website"), "."))
```
- 結果
```
  website: www.aliyun.com
  str_partition: ["www.aliyun", ".", "com"]
```

str_center

str_center関数は、指定された文字を使用して文字列を指定された長さにパディングします。

構文
```
str_center(value, width, fillchar)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
width	回	課金されます	パディング後の文字列の長さ。
fillchar	任意 (文字列型に自動的に変換)	課金されません	パディングに使用される文字。デフォルト値: space。

レスポンス
新しい文字列が返されます。
説明
パディング後の新しい文字列の長さが元の文字列の長さよりも短い場合、元の文字列が返されます。

例

例1: アスタリスク (*) を使用して文字列を埋めます。

生ログ
```
center: this is center
```

変換ルール

e_set("str_center", str_center(v("center"), 40, "*"))

結果

center: this is center
str_center: *************this is center*************

例2: スペースを使用して文字列をパディングします。

生ログ
```
center: this is center
```

変換ルール

e_set("str_center", str_center(v("center"), 40))

結果

center: this is center
str_center:              this is center

str_zfill

str_zfill関数は、0を使用して文字列を指定された長さに左パッドします。

構文
```
str_zfill(value, width)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
width	回	課金されます	パディング後の文字列の長さ。

レスポンス
新しい文字列が返されます。

例

生ログ
```
center: this is zfill
```

変換ルール

e_set("str_zfill", str_zfill(v("center"), 40))

結果

center:this is zfill
str_zfill:000000000000000000000000000this is zfill

str_expandtabs

str_expandtabs関数は、文字列の \tをスペースに変換します。

構文
```
str_expandtabs(value, tabsize)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
変更する元の文字列。
tabsize
回
課金されます
変換後のスペースの数。
レスポンス
新しい文字列が返されます。

例

例1: logstashフィールドの値の \tをスペースに変換します。

生ログ
```
logstash: this is\tstring
```

変換ルール

e_set("str_expandtabs", str_expandtabs(v("logstash")))

結果

logstash: this is\tstring
str_expandtabs: this is string

です

例2: 中央のフィールド値の \tをスペースに変換します。

生ログ
```
{"center": "this is\tstring"}
```

変換ルール

e_set("str_expandtabs", str_expandtabs(v("center"), 16))

結果

center: this is\tstring
str_expandtabs: this is         string

str_ljust

str_ljust関数は、指定された文字を使用して文字列を指定された長さに正しくパディングします。

構文
```
str_ljust(value, width, fillchar)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
width	回	課金されます	パディング後の文字列の長さ。
fillchar	任意 (文字列型に自動的に変換)	課金されません	パディングに使用される文字。デフォルト値: space。

レスポンス
新しい文字列が返されます。
説明
パディング後の新しい文字列の長さが元の文字列の長さよりも短い場合、元の文字列が返されます。

例

例 1

生ログ
```
content: this is ljust
```

変換ルール

e_set("str_ljust", str_ljust(v("content"), 20, "*"))

結果

content: this is ljust
str_ljust: this is ljust*******

例 2

生ログ
```
center: this is ljust
```

変換ルール

e_set("str_ljust", str_ljust(v("center"), 20,))

結果

center: this is ljust
str_ljust: this is ljust

例3: パディング後の新しい文字列の長さが元の文字列の長さよりも短いため、元の文字列を返します。
- 生ログ
```
center: this is ljust
```
- 変換ルール
```
e_set("str_ljust", str_ljust(v("center"),10,  "*"))
```
- 結果
```
center: this is ljust
str_ljust: this is ljust
```

str_rjust

str_rjust関数は、指定された文字を使用して文字列を指定された長さにパディングします。

構文
```
str_rjust(value, width, fillchar)
```

パラメーター

パラメーター	データ型	必須	説明
value	任意 (文字列型に自動的に変換)	課金されます	変更する元の文字列。
width	回	課金されます	パディング後の文字列の長さ。
fillchar	任意 (文字列型に自動的に変換)	課金されません	パディングに使用される文字。デフォルト値: space。

レスポンス
新しい文字列が返されます。
説明
パディング後の新しい文字列の長さが元の文字列の長さよりも短い場合、元の文字列が返されます。

例

生ログ
```
center: this is rjust
```

変換ルール

e_set("str_rjust", str_rjust(v("center"), 20, "*"))

結果

center: this is rjust
str_rjust: *******this is rjust

str_zip

str_zip関数は、式によって返される2つの値または文字列を分割し、結果を1つの文字列に結合します。

構文

str_zip(value1, value2, combine_sep=None, sep=None, quote=None, lparse=None, rparse=None)

パラメーター

パラメーター	データ型	必須	説明
value1	任意 (文字列型に自動的に変換)	課金されます	結合する値。The value that you want to combine.
value2	任意 (文字列型に自動的に変換)	課金されます	結合する値。The value that you want to combine.
combine_sep	任意 (文字列型に自動的に変換)	課金されません	要素を結合するために使用される識別子。デフォルト値:`#` 。
sep	任意 (文字列型に自動的に変換)	課金されません	結合後に要素間で使用される区切り文字。値は1文字でなければなりません。デフォルト値:`,`
quote	任意 (文字列型に自動的に変換)	課金されません	結合後に要素を囲むために使用される文字。このパラメーターは、値に区切り文字が含まれる場合に必要です。デフォルト値:`"`
lparse	任意 (文字列型に自動的に変換)	課金されません	`value1`の要素間で使用される区切り文字と引用符。デフォルトの区切り文字:`,` デフォルトの見積もり: `"`。形式: `lparse=(',', '"')` 説明クォートは、デリミタよりも高い優先度を有する。
rparse	任意 (文字列型に自動的に変換)	課金されません	`value2`の要素間で使用される区切り文字と引用符。デフォルトの区切り文字`、`。デフォルトの見積もり: `"`。形式: `rparse=(',', '"')` 説明クォートは、デリミタよりも高い優先度を有する。

レスポンス
結合された文字列が返されます。

例

例 1

生ログ
```
website: wwww.aliyun.com
escape_name: o
```

変換ルール

e_set("combine", str_zip(v("website"), v("escape_name"), combine_sep="@"))

結果

website: wwww.aliyun.com
escape_name: o
combine: wwww.aliyun.com@o

例 2

生ログ
```
website: wwww.aliyun.com
escape_name: o
```

変換ルール

e_set("combine", str_zip(v("website"), v("escape_name")))

結果

combine:wwww.aliyun.com#o  
escape_name:o
website:wwww.aliyun.com

例3: sepパラメーターを使用します。

生ログ
```
f1: a,b,c
f2: x,y,z
```

変換ルール

e_set("combine", str_zip(v("f1"), v("f2"), sep="|"))

結果

f1: a,b,c
f2: x,y,z
combine: a#x|b#y|c#z

例4: quoteパラメーターを使用します。

生ログ
```
f1: "a,a", b, "c,c"
f2: x, "y,y", z
```

変換ルール

e_set("combine", str_zip(v("f1"), v("f2"), quote='|'))

結果

f1: "a,a", b, "c,c"
f2: x, "y,y", z
combine: |a,a#x|,|b#y,y|,|c,c#z|

例5: 長さが異なるフィールド値を使用する。

生ログ
```
f1: a,b
f2: x,y,z 
```

変換ルール

e_set("combine", str_zip(v("f1"), v("f2")))

結果
```
f1: a,b
f2: x,y,z
combine: a#x,b#y
```

例6: lparseおよびrparseパラメーターを使用します。

生ログ
```
f1: a#b#c
f2: x|y|z
```

変換ルール

e_set("combine", str_zip(v("f1"), v("f2"), lparse=("#", '"'), rparse=("|", '"')))

結果

f1: a#b#c
f2: x|y|z
combine: a#x,b#y,c#z

例7: lparseおよびrparseパラメーターを使用します。

生ログ
```
f1: |a,a|, b, |c,c|
f2: x, #y,y#, z
```

変換ルール

e_set("combine", str_zip(v("f1"), v("f2"), lparse=(",", '|'), rparse=(",", '#')))

結果

f1: |a,a|, b, |c,c|
f2: x, #y,y#, z
combine: "a,a#x","b#y,y","c,c#z"

str_isalnum

str_isalnum関数は、文字列に英数字のみが含まれているかどうかをチェックします。

構文
```
str_isalnum(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: 13
```

変換ルール

e_set("str_isalnum", str_isalnum(v("content")))

結果
```
content: 13
str_isalnum: True
```

str_isalpha

str_isalpha関数は、文字列に文字のみが含まれるかどうかをチェックします。

構文
```
str_isalpha(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: 13
```

変換ルール

e_set("str_isalpha", str_isalpha(v("content")))

結果
```
content: 13
str_isalpha: False
```

str_isascii

str_isascii関数は、文字列がASCIIテーブルにあるかどうかをチェックします。

構文
```
str_isascii(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: asw123
```

変換ルール

e_set("str_isascii", str_isascii(v("content")))

結果
```
content: asw123
str_isascii: True
```

str_isdecimal

str_isdecimal関数は、文字列に10進文字のみが含まれるかどうかをチェックします。

構文
```
str_isdecimal(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

例 1

生ログ
```
welcome: Hello
```

変換ルール

e_set("str_isdecimal", str_isdecimal(v("welcome")))

結果
```
welcome: Hello
str_isdecimal: False
```

例 2

生ログ
```
num: 123
```

変換ルール

e_set("str_isdecimal", str_isdecimal(v("num")))

結果
```
num: 123
str_isdecimal: True 
```

str_isdigit

str_isdigit関数は、文字列に数字のみが含まれるかどうかをチェックします。

構文
```
str_isdigit(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: 13
```

変換ルール

e_set("str_isdigit", str_isdigit(v("content")))

結果
```
content: 13
str_isdigit: True
```

str_isidentifier

str_isidentifier関数は、文字列が有効なPython識別子であるかどうか、または変数名が有効であるかどうかをチェックします。

構文
```
str_isidentifier(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
class: class
```

変換ルール

e_set("str_isidentifier", str_isidentifier(v("class")))

結果
```
class: class
str_isidentifier: True
```

str_islower

str_islower関数は、文字列に小文字のみが含まれるかどうかをチェックします。

構文
```
str_islower(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
lower: asds
```

変換ルール

e_set("str_islower", str_islower(v("lower")))

結果
```
lower: asds
str_islower: True
```

str_isnumeric

str_isnumeric関数は、文字列内のすべての文字が数値であるかどうかをチェックします。

構文
```
str_isnumeric(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
num: 123
```

変換ルール

e_set("str_isnumeric", str_isnumeric(v("num")))

結果
```
num: 123
str_isnumeric: True
```

str_isprintable

str_isprintable関数は、文字列内のすべての文字が印刷可能な文字かどうかをチェックします。

構文
```
str_isprintable(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: vs;,.as
```

変換ルール

e_set("str_isprintable", str_isprintable(v("content")))

結果
```
content: vs;,.as
str_isprintable: True
```

str_isspace

str_isspace関数は、文字列にスペースのみが含まれるかどうかをチェックします。

構文
```
str_isspace(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
space:  as afsd
```

変換ルール

e_set("str_isspace", str_isspace(v("space")))

結果
```
space:  as afsd
str_isspace: False
```

str_istitle

str_istitle関数は、文字列の各単語の最初の文字が大文字で、文字列の他の文字が小文字であるかどうかを確認します。

構文
```
str_istitle(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
title: Alex Is A Boy
```

変換ルール

e_set("str_istitle", str_istitle(v("title")))

結果
```
str_istitle:true
title:Alex Is A Boy
```

str_isapper

str_isupper関数は、文字列内のすべての文字が大文字であるかどうかをチェックします。

構文
```
str_isupper(value)
```
パラメーター
パラメーター
データ型
必須
説明
value
任意 (文字列型に自動的に変換)
課金されます
チェックする文字列。The string that you want to check.
レスポンス
値TrueまたはFalseが返されます。

例

生ログ
```
content: ASSD
```

変換ルール

e_set("str_isupper", str_isupper(v("content")))

結果
```
content: ASSD
str_isupper: True
```

str_uuid

str_uuid関数はランダムなUUIDを生成します。

構文
```
str_uuid(lower=True)
```

パラメーター

パラメーター	データ型	必須	説明
lower	ブール値	課金されません	出力UUIDの文字を小文字にするかどうかを指定します。デフォルト値: True。文字が小文字であることを指定します。

レスポンス
UUIDが返されます。

例

例 1

生ログ
```
content: I am Iron man
```
変換ルール
```
e_set("UUID", str_uuid())
```

結果

content: I am Iron man
UUID: e9fcd6b0-b970-11ec-979d-0f7041e65ab8

例 2

生ログ
```
content: I am Iron man
```
変換ルール
```
e_set("UUID", str_uuid(lower=False))
```

結果

content: I am Iron man
UUID: 0649211E-B971-11EC-A258-E71F0A2930C5

関数

str_format

構文

パラメーター

レスポンス

例

str_join

構文

パラメーター

レスポンス

例

str_encode

構文

パラメーター

レスポンス

例

str_decode

構文

パラメーター

レスポンス

例

str_replace

構文

パラメーター

レスポンス

例

str_sort

構文

パラメーター

レスポンス

例

str_reverse

構文

パラメーター

レスポンス

例

str_logstash_config_normalize

構文

パラメーター

レスポンス

例

str_hex_escape_encode

構文

パラメーター

レスポンス

例

str_strip

構文

パラメーター

レスポンス

例

str_lower

構文

パラメーター

レスポンス

例

str_upper

構文

パラメーター

レスポンス

例

str_title

構文

パラメーター

レスポンス

例

str_capitalize

構文

パラメーター

レスポンス

例

str_lstrip

構文

パラメーター

レスポンス

例

str_rstrip

構文

パラメーター

レスポンス