String functions - Data Transformation| Alibaba Cloud Documentation Center

Functions


Type	Function	Description
Multi-string operation	str_format	Formats a string.
	str_join	Concatenates the elements in a sequence with a specified string to generate a new string.
	str_zip	Splits two value strings or expression strings concurrently and then merges them into a single string.
Sorting, reversing, and replacement	str_sort	Sorts specified objects.
	str_reverse	Reverses a string.
	str_replace	Replaces an old string with a new string based on an applicable rule.
	str_logstash_config_normalize	Converts the data format of the Logstash configuration language into the JSON format.
	str_translate	Replaces the specified characters of a string with the corresponding characters.
Regular munging	str_strip	Deletes specified characters from a string.
	str_lstrip	Deletes specified characters from the start of a string.
	str_rstrip	Deletes specified characters from the end of a string.
	str_lower	Converts all uppercase characters in a string to lowercase characters.
	str_upper	Converts all lowercase characters in a string to uppercase characters.
	str_title	Capitalizes only the first letter of all words.
	str_capitalize	Capitalizes only the first letter of a string.
	str_swapcase	Interchanges uppercase letters and lowercase letters in a string.
Search and check	str_count	Counts the number of occurrences of a character in a string.
	str_find	Checks whether an original string contains a specified substring.
	str_rfind	Locates the position of the last occurrence of a character or a substring in a string.
	str_endswith	Checks whether a string ends with a specified suffix.
	str_startswith	Checks whether a string starts with a specified string.
Splitting	str_split	Splits a string with a specified delimiter.
	str_splitlines	Splits a string with a line feed.
	str_partition	Splits a string with a specified delimiter into three parts from left to right.
	str_rpartition	Splits a string with a specified delimiter into three parts from right to left.
Formatting	str_center	Pads a string to a specified length with a specified character.
	str_ljust	Pads a string to a specified length from the end with a specified character.
	str_rjust	Pads a string to a specified length from the start with a specified character.
	str_zfill	Pads a string to a specified length from the start with 0.
	str_expandtabs	Converts `\t` in a string into a space character.
Character set check	str_isalnum	Checks whether a string consists of only letters and digits.
	str_isalpha	Checks whether a string consists of only letters.
	str_isascii	Checks whether a string is in the ASCII table.
	str_isdecimal	Checks whether a string contains only decimal characters.
	str_isdigit	Checks whether a string consists of only digits.
	str_isidentifier	Checks whether a string is a valid Python identifier. This function can also check whether a variable name is valid.
	str_islower	Checks whether a string consists of lowercase letters.
	str_isnumeric	Checks whether a string consists of digits.
	str_isprintable	Checks whether all characters in a string are printable characters.
	str_isspace	Checks whether a string consists of only space characters.
	str_istitle	Checks whether the first letter of all words in a string are uppercase and whether other letters in the string are lowercase.
	str_isupper	Checks whether all letters in a string are uppercase letters.

The following table describes the functions that can be used together with string functions.


Type	Function	Description
Multi-string operation	op_add	Performs a logic AND operation of multiple numeric values. This function can be used for numeric values and strings.
	op_max	Calculates the maximum value among multiple values. This function can be used for numeric values and strings.
	op_min	Calculates the minimum value among multiple values. This function can be used for numeric values and strings.
String truncation	op_slice	Truncates a string.
Length calculation	op_len	Calculates the length of a string.

str_format

Syntax

str_format(formatted string, value 1, value 2, ...)

Parameters


Parameter	Type	Required	Description
formatted string	Arbitrary (automatically converted to a string)	Yes	The format of the converted string, for example, `{}={}`.
value 1	Arbitrary	Yes	Value 1 to be formatted.
value 2	Arbitrary	Yes	Value 2 to be formatted.

Response
A formatted string is returned.

Example

Raw log entry:

class: Format
escape_name: Traditional

Transformation rule:

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

Result:

class: Format
escape_name: Traditional
str_format: Format=Traditional

str_join

Syntax

Str_join(string delimiter, value 1, value 2, ...)

Parameters


Parameter	Type	Required	Description
string delimiter	Arbitrary (automatically converted to a string)	Yes	The identifier of a string delimiter, for example, `!`, `@`, `#`, `$`, and `%`.
value 1	Arbitrary (automatically converted to a string)	Yes	The value to be concatenated.
value 2	Arbitrary (automatically converted to a string)	Yes	The value to be concatenated.

Response
A concatenated string is returned.

Example

Raw log entry:

name: ETL
company: aliyun.com

Transformation rule:

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

Result:

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

str_replace

Syntax
```
str_replace(value, old [,new [,count] ])
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The value to be replaced.
old	Arbitrary (automatically converted to a string)	Yes	The string to be replaced.
new	Arbitrary (automatically converted to a string)	Yes	The new string after the replacement.
count	Number	No	The number of replacements. If you do not specify this parameter, all old strings are replaced.

Response
A new string is returned.

Example: The following example converts a dictionary to a JSON string.

Raw log entry:

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

Transformation rule:

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

Result:

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

Syntax
```
str_sort(value, [reverse])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be sorted.
reverse	Bool	No	Default value: False. This value indicates that the string is sorted in ascending order.

Response
A sorted string is returned.
Examples
- Example 1: This example sorts the str string in alphabetical order.
  Raw log entry:
```
str: twish
```
  Transformation rule:
```
e_set("str_sort", str_sort(v("str")))
```
  Result:
```
str: twish
str_sort: histw
```
- Example 2: This example sorts the str string in two-letter pairs in reverse alphabetical order.
  Raw log entry:
```
str: twish
```
  Transformation rule:
```
e_set("str_sort", str_sort(v("str"),True))
```
  Result:
```
str: twish
str_sort: wtsih
```

str_reverse

Syntax
```
str_reverse(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The value to be reversed.

Response
A converted string is returned.
Example: The following function reverses the data string.
Raw log entry:
```
data:twish
```
Transformation rule:
```
e_set("reverse_data", str_reverse(v("data")))
```
Result:
```
data:twish
reverse_data:hsiwt
```

str_logstash_config_normalize

Syntax
```
str_logstash_config_normalize (value)
```
Note For more information about the Logstash configuration language, see Logstash.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The value to be converted.

Response
A converted string is returned.

Example: The following example converts the logstash string.

Raw log entry:

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

Transformation rule:

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

Result:

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

str_strip

Syntax
```
str_strip(value, [chars] )
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
chars	Arbitrary (automatically converted to a string)	No	The character set to be deleted from the start and end of a string. Default value: `\t\r\n`.

Response
A modified string is returned.
Examples
- Example 1: This example deletes the "*" character from the start of the strip string.
  Raw log entry:
```
strip: ***I love Etl
```
  Transformation rule:
```
e_set("str_strip", str_strip(v("strip"),"*"))
```
  Result:
```
strip: ***I love Etl
str_strip:I love Etl
```
- Example 2: This example deletes the space character from the start of the strip string.
  Raw log entry:
```
strip:    I love Etl
```
  Transformation rule:
```
e_set("str_strip", str_strip(v("strip")))
```
  Result:
```
strip:    I love Etl
str_strip: I love Etl
```
- Example 3: This example deletes the xy character set.
  Raw log entry:
```
strip:xy123yx
```
  Transformation rule:
```
e_set("str_strip", str_strip(v("strip"),"xy"))
```
  Result:
```
strip:xy123yx
str_strip:123
```

str_lower

Syntax
```
str_lower(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be converted.

Response
A converted string is returned.
Example: The following example converts the name string into lowercase letters.
Raw log entry:
```
name: Etl
```
Transformation rule:
```
e_set("str_lower", str_lower(v("name")))
```
Result:
```
name: Etl
str_lower: etl
```

str_upper

Syntax
```
str_lower(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be converted.

Response
A converted string is returned.
Example: The following example converts the name string into uppercase letters.
Raw log entry:
```
name: etl
```
Transformation rule:
```
e_set("str_upper", str_upper(v("name")))
```
Result:
```
name: etl
str_upper: ETL
```

str_title

Syntax
```
str_title(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be converted.

Response
A converted string is returned.
Example: The following example converts the first letters of all words in the word string into uppercase letters.
Raw log entry:
```
word: this is etl
```
Transformation rule:
```
e_set("str_title", str_title(v("word")))
```
Result:
```
word: this is etl
str_title: This Is Etl
```

str_capitalize

Syntax
```
str_capitalize(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be converted.

Response
A converted string is returned.
Example: The following example converts the letters of all words in the word string into lowercase letters.
Raw log entry:
```
word: this Is MY EAL
```
Transformation rule:
```
e_set("str_capitalize", str_capitalize(v("word")))
```
Result:
```
word: this Is MY EAL
str_capitalize: This is my eal
```

str_lstrip

Syntax
```
str_lstrip(value,[chars])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified
chars	Arbitrary (automatically converted to a string)	No	The character set to be deleted from the start of a string. The default value is the space character.

Response
A modified string is returned.
Examples
- Example 1: This example deletes the "*" character from the start of the word string.
  Raw log entry:
```
word: ***this is string
```
  Transformation rule:
```
e_set("str_lstrip", str_lstrip(v("word"),"*"))
```
  Result:
```
word: ***this is string
str_lstrip: this is string
```
- Example 2: This example deletes the space character from the start of the word string.
  Raw log entry:
```
word:     this is string
```
  Transformation rule:
```
e_set("str_lstrip", str_lstrip(v("word")))
```
  Result:
```
word:     this is string
str_lstrip: this is string
```
- Example 3: This example deletes the xy character set.
  Raw log entry:
```
lstrip:xy123yx
```
  Transformation rule:
```
e_set("str_lstrip", str_lstrip(v("lstrip"),"xy"))
```
  Result:
```
lstrip:xy123yx
str_lstrip:123yx
```

str_rstrip

Syntax
```
str_rstrip(value,[chars])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
chars	Arbitrary (automatically converted to a string)	No	The character set to be deleted from the end of a string. The default value is the space character.

Response
A modified string is returned.
Examples
- Example 1: This example deletes the "*" character from the end of the word string.
  Raw log entry:
```
word: this is string*****
```
  Transformation rule:
```
e_set("str_rstrip", str_rstrip(v("word"),"*"))
```
  Result:
```
word: this is string*****
str_rstrip: this is string
```
- Example 2: This example deletes the xy character set.
  Raw log entry:
```
word:xy123yx
```
  Transformation rule:
```
e_set("str_rstrip", str_rstrip(v("word"),"xy"))
```
  Result:
```
word:xy123yx
str_rstrip:xy123
```

str_swapcase

Syntax
```
str_swapcase(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be converted.

Response
A converted string is returned.

Example

Raw log entry:

name: this is string

Transformation rule:

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

Result:

name: this is string
str_swapcase: THIS IS STRING

str_translate

Syntax

str_translate(value, original character set, mapping character set)

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be replaced.
original character set	Arbitrary (automatically converted to a string)	Yes	The original character set.
mapping character set	Arbitrary (automatically converted to a string)	Yes	The new character set after the replacement.

Response
A replaced string is returned.

Example

Raw log entry:

name: I love ETL!!!

Transformation rule:

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

Result:

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

str_endswith

Syntax
```
tr_endwith(value, suffix [, start [, end ] ] )
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be checked.
suffix	Arbitrary (automatically converted to a string)	Yes	The suffix rule. This parameter can be a string or an element.
start	Number	No	The position where the string suffix check starts. The value 0 indicates the first character and the value -1 indicates the last character.
end	Number	No	The position where the string suffix check ends. The value 0 indicates the first character and the value -1 indicates the last character.

Response
The value True is returned if the string ends with the specified suffix. Otherwise, the value False is returned.

Example

Raw log entry:

name: this is endswith!!!

Transformation rule:

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

Result:

name: this is endswith!!!
str_endswith: True

str_startswith

Syntax
```
str_startswith(value, prefix [, start [, end ] ])
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be checked.
prefix	Arbitrary(automatically converted to a string)	Yes	The prefix rule. This parameter can be a string or an element.
start	Number	No	The position where the string prefix check starts. The value 0 indicates the first character and the value -1 indicates the last character.
end	Number	No	The position where the string prefix check ends. The value 0 indicates the first character and the value -1 indicates the last character.

Response
The value True is returned if the string starts with the specified prefix. Otherwise, the value False is returned.

Example

Raw log entry:

name: !! this is startwith

Transformation rule:

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

Result:

name: !! this is startwith
str_startswith: True

str_find

Syntax
```
str_find(value,str [, begin [,end]])
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string in which you search for a substring.
str	Arbitrary (automatically converted to a string)	Yes	The substring you enter for search.
begin	Number	No	The position where the substring search starts. The value 0 indicates the first character and the value -1 indicates the last character.
end	Number	No	The position where the substring search ends. The default value is the length of the string. The value 0 indicates the first character and the value -1 indicates the last character.

Response
The position of the specified substring in the original string is returned.

Example

Raw log entry:

name: hello world

Transformation rule:

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

Result:

name: hello world
str_find: 0

str_count

Syntax
```
str_count(value,sub[,start [,end]])
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string in which the number of occurrences of a specified character is counted.
sub	Arbitrary (automatically converted to a string)	Yes	The character whose number of occurrences is counted.
start	Number	No	The position where the search for the specified character starts in the string. The value 0 indicates the first character and the value -1 indicates the last character.
end	Number	No	The position where the search for the specified character ends in the string. The default value is the last character of the string. The value 0 indicates the first character and the value -1 indicates the last character.

Response
The number of occurrences of the specified character is returned.

Example

Raw log entry:

name: this is really a string

Transformation rule:

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

Result:

name: this is really a string
str_count: 3

str_rfind

Syntax
```
str_rfind(value,substr[,beg [,end]])
```
Note This function is a basic method to call variable parameters. For more information, see Function invoking.

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string in which you search for a specified character.
substr	Arbitrary (automatically converted to a string)	Yes	The character you enter for search.
beg	Number	No	The position where the search starts. Default value: 0.
end	Number	No	The position where the search ends. The default value is the length of the string.

Response
The position of the last occurrence of the specified character is returned.

Example

Raw log entry:

name: this is really a string

Transformation rule:

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

Result:

name: this is really a string
str_rfind: 20

str_split

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

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be split.
sep	Number	No	The delimiter. The value None indicates the space character.
maxsplit	Number	No	The maximum number of splits. The value -1 indicates that no limit is set.

Response
A split string is returned.
Example: The following example splits the content string with a space character.
Raw log entry:
```
content: hello world
```
Transformation rule:
```
e_set("str_split",str_split(v("content")," "))
```
Result:
```
content: hello world
str_split: ["hello", "world"]
```

str_splitlines

Syntax
```
str_splitlines(value,[keepends])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be split.
keepends	Bool	No	Indicates whether to delete line feeds (`\r`, `\r\n`, and `\n`) from the result. The default value is False, which indicates that line feeds are deleted. The value True indicates that line feeds are retained.

Response
A list of split string is returned.

Examples

Example 1:

Raw log entry:

content: ab c\n\nde fg\rkl\r\n

Transformation rule:

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

Result:

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

Example 2:

Raw log entry:

content: ab c\n\nde fg\rkl\r\n

Transformation rule:

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

Result:

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

str_partition

Syntax
```
str_partition(value,substr)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be split.
substr	Arbitrary (automatically converted to a string)	No	The specified delimiter.

Response
A split string is returned.
Example: The following example splits the website string with periods (.) into three parts from left to right.
Raw log entry:
```
website: www.aliyun.com
```
Transformation rule:
```
e_set("str_partition",str_partition(v("website"),"."))
```
Result:
```
website: www.aliyun.com
str_partition:  ["www", ".", "aliyun.com"]
```

str_rpartition

Syntax
```
str_rpartition(value,substr)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be split.
substr	Arbitrary (automatically converted to a string)	No	The specified delimiter.

Response
A list of split string is returned.
Example: The following example splits the website string with periods (.) into three parts from right to left.
Raw log entry:
```
website: www.aliyun.com
```
Transformation rule:
```
e_set("str_partition",str_rpartition(v("website"),"."))
```
Result:
```
  website: www.aliyun.com
  str_partition: ["www.aliyun", ".", "com"]
```

str_center

Syntax
```
str_center(value,width,[fillchar])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
width	Number	Yes	The length of the padded string.
fillchar	Arbitrary (automatically converted to a string)	No	The pad character. The default pad character is the space character.

Response
A padded string is returned.

Note If the length of the padded string is shorter than that of the original string, the original string is returned.

Examples

Example 1: This example pads a string with asterisks (*).

Raw log entry:

center: this is center

Transformation rule:

e_set("str_center",str_center(v("center"),width=40,fillchar="*"))

Result:

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

Example 2: This example pads a string with space characters.

Raw log entry:

center: this is center

Transformation rule:

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

Result:

center: this is center
str_center:              this is center

str_zfill

Syntax
```
str_zfill(value,width)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
width	Number	Yes	The length of the padded string.

Response
A padded string is returned.

Example

Raw log entry:

center: this is zfill

Transformation rule:

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

Result:

center: this is zfill
str_zfill: 00this is zfill

str_expandtabs

Syntax
```
str_expandtabs(value,[tabsize])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
tabsize	Number	Required	Specifies the number of space characters after the conversion.

Response
A converted string is returned.
Examples
- Example 1: This example converts the \t character in the logstash string into a space character.
  Raw log entry:
```
logstash: this is\tstring
```
  Transformation rule:
```
e_set("str_expandtabs",str_expandtabs(v("center")))
```
  Result:
```
logstash: this is\tstring
str_expandtabs: this is string
```
- Example 2: This example converts the \t character in the center string into a space character.
  Raw log entry:
```
center: this is\tstring
```
  Transformation rule:
```
e_set("str_expandtabs",str_expandtabs(v("center"),16))
```
  Result:
```
center: this is\tstring
str_expandtabs: this is         string
```

str_ljust

Syntax
```
str_ljust(value,width,[fillchar])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
width	Number	Yes	The length of the padded string.
fillchar	Arbitrary (automatically converted to a string)	No	The pad character. The default pad character is the space character.

Response
A padded string is returned.

Note If the length of the padded string is shorter than that of the original string, the original string is returned.

Examples

Example 1:

Raw log entry:

content: this is ljust

Transformation rule:

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

Result:

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

Example 2:

Raw log entry:

center: this is ljust

Transformation rule:

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

Result:

center: this is ljust
str_ljust: this is ljust

Example 3: In this example, the original string is returned because the length of the padded string is shorter than the length of the original string.
Raw log entry:
```
center: this is ljust
```
Transformation rule:
```
e_set("str_ljust",str_ljust(v("center"),10,"*"))
```
Result:
```
center: this is ljust
str_ljust: this is ljust
```

str_rjust

Syntax
```
str_ljust(value,width,[fillchar])
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The original string to be modified.
width	Number	Yes	The length of the padded string.
fillchar	Arbitrary (automatically converted to a string)	No	The pad character. The default pad character is the space character.

Response
A padded string is returned.

Note If the length of the padded string is shorter than that of the original string, the original string is returned.

Example

Raw log entry:

center: this is rjust

Transformation rule:

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

Result:

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

str_zip

Syntax

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

Parameters


Parameter	Type	Required	Description
value 1	Arbitrary (automatically converted to a string)	Yes	A value to be merged.
value 2	Arbitrary (automatically converted to a string)	Yes	A value to be merged.
combine_sep	Arbitrary (automatically converted to a string)	No	The identifier used to merge the elements. Default value: `#`.
sep	Arbitrary (automatically converted to a string)	No	The delimiter between merged elements. The value must be a single character. Default value: `,`.
quote	Arbitrary (automatically converted to a string)	No	The character that encloses the merged elements. This parameter is required when the merged elements contain a delimiter. Default value: `"`.
lparse	Arbitrary (automatically converted to a string)	No	The delimiter and quote used among the elements of `value 1`. The default delimiter is `,` and the default quote is `"`. The format is `lparse=(',', '"')`. Note The quote takes precedence over the delimiter.
rparse	Arbitrary (automatically converted to a string)	No	The delimiter and quote used among the elements of `value 2`. The default delimiter is `,` and the default quote is `"`. The format is `rparse=(',', '"')`. Note The quote takes precedence over the delimiter.

Response
A merged string is returned.

Examples

Example 1:

Raw log entry:

website: wwww.aliyun.com
escape_name: o

Transformation rule:

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

Result:

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

Example 2:

Raw log entry:

website: wwww.aliyun.com
escape_name: o

Transformation rule:

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

Result:

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

Example 3: In this example, the sep parameter is specified.

Raw log entry:

f1: a,b,c
f2: x,y,z

Transformation rule:

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

Result:

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

Example 4: In this example, the quote parameter is specified.

Raw log entry:

f1: "a,a", b, "c,c"
f2: x, "y,y", z

Transformation rule:

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

Result:

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

Example 5: In this example, elements of different lengths are used.
Raw log entry:
```
f1: a,b
f2: x,y,z
```
Transformation rule:
```
e_set("combine",str_zip(v("f1"), v("f2")))
```
Result:
```
f1: a,b
f2: x,y,z
combine: a#x,b#y
```

Example 6: In this example, the lparse and rparse parameters are specified.

Raw log entry:

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

Transformation rule:

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

Result:

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

Example 7: In this example, the lparse and rparse parameter are specified.

Raw log entry:

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

Transformation rule:

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

Result:

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

str_isalnum

Syntax
```
str_isalnum(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: 13

Transformation rule:

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

Result:

content: 13
str_isalnum: True

str_isalpha

Syntax
```
str_isalpha(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: 13

Transformation rule:

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

Result:

content: 13
str_isalpha: False

str_isascii

Syntax
```
str_isascii(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: asw123

Transformation rule:

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

Result:

content: asw123
str_isascii: True

str_isdecimal

Syntax
```
str_isdecimal(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Examples

Example 1:

Raw log entry:

welcome: hello

Transformation rule:

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

Result:

welcome: hello
str_isdecimal: False

Example 2:

Raw log entry:

num: 123

Transformation rule:

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

Result:

num: 123
str_isdecimal: True

str_isdigit

Syntax
```
str_isdigit(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: 13

Transformation rule:

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

Result:

content: 13
str_isdigit: True

str_isidentifier

Syntax
```
str_isidentifier(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

class: class

Transformation rule:

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

Result:

class: class
str_isidentifier: True

str_islower

Syntax
```
str_islower(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

lower: asds

Transformation rule:

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

Result:

lower: asds
str_islower: True

str_isnumeric

Syntax
```
str_isnumeric(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

num: 123

Transformation rule:

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

Result:

num: 123
str_isnumeric: True

str_isprintable

Syntax
```
str_isprintable(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: vs;,.as

Transformation rule:

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

Result:

content: vs;,.as
str_isprintable: True

str_isspace

Syntax
```
str_isspace(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

space:  as afsd

Transformation rule:

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

Result:

space:  as afsd
str_isspace: False

str_istitle

Syntax
```
str_istitle(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

title: Alex

Transformation rule:

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

Result:

title: Alex
str_istitle: True

str_isupper

Syntax
```
str_istitle(value)
```

Parameters


Parameter	Type	Required	Description
value	Arbitrary (automatically converted to a string)	Yes	The string to be checked.

Response
The value True or False is returned.

Example

Raw log entry:

content: ASSD

Transformation rule:

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

Result:

content: ASSD
str_isupper: True

str_uuid

Syntax
```
str_uuid(lower=True)
```

Parameters


Parameter	Type	Required	Description
lower	Bool	No	Indicates whether the letters in the generated UUID are in lowercase. Default value: True. This value indicates that the letters are lowercase.

Response
A UUID is returned.

Example

Example 1:

Raw log entry:

content: I am Iran man

Transformation rule:

e_set("UUID",str_uuid())

Result:

content: I am Iran man
UUID: dcc54d7e-c95f-11e9-9791-ffd6754a4f32

Example 2

Raw log entry:

content: I am Iran man

Transformation rule:

e_set("UUID",str_uuid(lower=False))

Result:

content: I am Iran man
UUID: DCC72D74-C95F-11E9-9921-F395B8647FFA