Sintaksis dan contoh fungsi string SLS - Simple Log Service

Dokumen ini menjelaskan sintaksis, parameter, dan contoh penggunaan fungsi string dalam transformasi data SLS.

Fungsi

Kategori	Fungsi	Deskripsi
Operasi multi-string	str_format	Memformat string dalam format tertentu.
	str_join	Menggabungkan string dengan konektor tertentu.
	str_zip	Memisahkan dua nilai ekspresi dan menggabungkan hasilnya menjadi satu string.
Encoding dan decoding	str_encode	Encode string menggunakan format encoding tertentu.
	str_decode	Decode nilai input menggunakan format encoding tertentu.
	str_hex_escape_encode	Meng-escape karakter khusus, termasuk urutan heksadesimal ke bentuk yang dapat dibaca.
	str_uuid	Menghasilkan UUID acak.
Pengurutan, pembalikan, dan penggantian	str_sort	Mengurutkan objek tertentu.
	str_reverse	Membalikkan string.
	str_replace	Mengganti substring berdasarkan aturan tertentu.
	str_logstash_config_normalize	Mengonversi data dalam bahasa konfigurasi Logstash ke format JSON.
	str_translate	Mengganti karakter dalam string berdasarkan tabel pemetaan.
Regular munging	str_strip	Menghapus karakter tertentu dari string.
	str_lstrip	Menghapus karakter tertentu dari awal string.
	str_rstrip	Menghapus karakter tertentu dari akhir string.
	str_lower	Mengonversi semua huruf kapital menjadi huruf kecil.
	str_upper	Mengonversi semua huruf kecil menjadi huruf kapital.
	str_title	Menjadikan huruf pertama setiap kata kapital dan sisanya huruf kecil.
	str_capitalize	Menjadikan huruf pertama kapital dan sisanya huruf kecil.
	str_swapcase	Menukar besar-kecil semua huruf dalam string.
Pencarian dan pemeriksaan	str_count	Menghitung jumlah kemunculan suatu karakter dalam string.
	str_find	Memeriksa apakah string berisi substring tertentu.
	str_rfind	Mengembalikan posisi kemunculan terakhir substring.
	str_endswith	Memeriksa apakah string diakhiri dengan sufiks tertentu.
	str_startswith	Memeriksa apakah string diawali dengan awalan tertentu.
Pemisahan	str_split	Memisahkan string menggunakan delimiter tertentu.
	str_splitlines	Memisahkan string menggunakan line feed.
	str_partition	Memisahkan string menjadi tiga bagian dari kiri ke kanan menggunakan delimiter tertentu.
	str_rpartition	Memisahkan string menjadi tiga bagian dari kanan ke kiri menggunakan delimiter tertentu.
Pemformatan	str_center	Menambahkan padding pada string hingga panjang tertentu menggunakan karakter tertentu.
	str_ljust	Menambahkan padding kanan pada string hingga panjang tertentu menggunakan karakter tertentu.
	str_rjust	Menambahkan padding kiri pada string hingga panjang tertentu menggunakan karakter tertentu.
	str_zfill	Menambahkan padding kiri pada string hingga panjang tertentu menggunakan angka 0.
	str_expandtabs	Mengonversi karakter `\t` dalam string menjadi spasi.
Pemeriksaan set karakter	str_isalnum	Memeriksa apakah string hanya berisi huruf dan angka.
	str_isalpha	Memeriksa apakah string hanya berisi huruf.
	str_isascii	Memeriksa apakah string berada dalam tabel ASCII.
	str_isdecimal	Memeriksa apakah string hanya berisi karakter desimal.
	str_isdigit	Memeriksa apakah string hanya berisi angka.
	str_isidentifier	Memeriksa apakah string merupakan identifier Python yang valid.
	str_islower	Memeriksa apakah string hanya berisi huruf kecil.
	str_isnumeric	Memeriksa apakah semua karakter dalam string bersifat numerik.
	str_isprintable	Memeriksa apakah semua karakter dalam string merupakan karakter yang dapat dicetak.
	str_isspace	Memeriksa apakah string hanya berisi spasi.
	str_istitle	Memeriksa apakah huruf pertama setiap kata dalam string berupa huruf kapital dan huruf lainnya berupa huruf kecil.
	str_isupper	Memeriksa apakah semua huruf dalam string berupa huruf kapital.

Anda dapat menggunakan fungsi string berikut:

Kategori	Fungsi	Deskripsi
Operasi multi-string	op_add	Mengembalikan nilai jumlah dari beberapa nilai numerik atau string.
	op_max	Mengembalikan nilai maksimum di antara beberapa nilai numerik atau string.
	op_min	Mengembalikan nilai minimum di antara beberapa nilai numerik atau string.
Pemotongan string	op_slice	Memotong string.
Perhitungan panjang	op_len	Mengembalikan panjang string.

str_format

Memformat string menggunakan format tertentu.

Sintaksis

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

Parameter

Parameter	Tipe Data	Wajib	Deskripsi
format_string	Arbitrary (auto-converted to string)	Ya	Format string output. Contoh: `{}={}`.
value1	Arbitrary	Ya	Nilai yang akan diformat.
value2	Arbitrary	Ya	Nilai yang akan diformat.

Respons

Mengembalikan string yang telah diformat.

Contoh

Log mentah
```
class: Format
escape_name: Traditional
```

Aturan transformasi

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

Hasil

class: Format
escape_name: Traditional
str_format: Format=Traditional

str_join

Menggabungkan string input menjadi satu string yang dipisahkan oleh delimiter.

Sintaksis

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

Parameter

Parameter	Tipe data	Wajib	Deskripsi
connector	Arbitrary (auto-converted to string)	Ya	Konektor. Konektor yang didukung meliputi tanda seru (!), tanda at (@), tanda pagar (#), tanda dolar ($), dan tanda persen (%).
value1	Arbitrary (auto-converted to string)	Ya	Nilai yang akan digabungkan.
value2	Arbitrary (auto-converted to string)	Ya	Nilai yang akan digabungkan.

Respons

Mengembalikan string yang telah digabungkan.

Contoh

Log mentah
```
name: ETL
company: aliyun.com
```

Aturan transformasi

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

Hasil

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

str_encode

Encode string menggunakan format encoding tertentu.

Sintaksis

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

Parameter

Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	Nilai yang akan diencode.
encoding	String	Tidak	Format encoding. Nilai default: UTF-8. ASCII didukung.
errors	String	Tidak	Metode yang digunakan untuk memproses karakter jika karakter tidak dapat dikenali berdasarkan format encoding. Nilai yang valid: ignore (default): Karakter tidak diencode. strict: Dilaporkan error, dan log dibuang. replace: Karakter yang tidak dikenali diganti dengan tanda tanya (?). xmlcharrefreplace: Karakter yang tidak dikenali diganti dengan karakter XML.

Respons

Mengembalikan string yang telah diencode.

Contoh

Contoh 1

Log mentah
```
test: asewds
```

Aturan transformasi

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

Hasil
```
test: asewds
f1: Hello
```

Contoh 2

Log mentah
```
f2: test Test data
```

Aturan transformasi

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

Hasil
```
f1:test 
f2:test Test data
```

Contoh 3
- Log mentah
```
f2: test data
```
- Aturan transformasi
```
e_set("f1", str_encode(v("f2"), "ascii", errors="strict"))
```
- Hasil
  
  Dilaporkan error selama eksekusi.

Contoh 4

Log mentah
```
f2: test Test data
```

Aturan transformasi

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

Hasil
```
f1:test ????
f2:test Test data
```

Contoh 5

Log mentah
```
f2: test Test data
```

Aturan transformasi

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

Hasil

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

str_decode

Decode nilai input menggunakan format encoding tertentu.

Sintaksis
```
str_decode(value, "utf8", errors="ignore")
```
Catatan
Fungsi str_decode hanya dapat memproses data bertipe byte.

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	Nilai yang akan didecode.
encoding	Arbitrary (auto-converted to string)	Tidak	Format encoding. Nilai default: UTF-8. ASCII didukung.
errors	Arbitrary (auto-converted to string)	Tidak	Metode yang digunakan untuk memproses karakter jika karakter tidak dapat dikenali berdasarkan format encoding. Nilai yang valid: ignore (default): Karakter tidak didecode. strict: Dilaporkan error, dan log dibuang. replace: Karakter yang tidak dikenali diganti dengan tanda tanya (?). xmlcharrefreplace: Karakter yang tidak dikenali diganti dengan karakter XML.

Respons

Mengembalikan nilai yang telah didecode.

Contoh

Log mentah
```
test: asewds
```

Aturan transformasi

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

Hasil
```
test: asewds
encoding: Hello
```

str_replace

Mengganti kemunculan substring lama dengan substring baru.

Sintaksis
```
str_replace(value, old, new, count)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	Nilai yang akan diganti.
old	Arbitrary (auto-converted to string)	Ya	String yang akan diganti.
new	Arbitrary (auto-converted to string)	Ya	String setelah penggantian.
count	Number	Tidak	Jumlah penggantian. Jika tidak ditentukan, semua kemunculan akan diganti.

Respons

Mengembalikan string baru.

Contoh

Mengonversi dictionary ke format JSON.

Log mentah

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

Aturan transformasi

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

Hasil

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

Mengurutkan objek yang ditentukan.

Sintaksis
```
str_sort(value, reverse=False)
```

Parameter

Nama parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan diurutkan.
reverse	Boolean	Tidak	Nilai default: False, yang menunjukkan bahwa string diurutkan secara ascending.

Respons

Mengembalikan string yang telah diurutkan.
Contoh
- Contoh 1: Mengurutkan nilai field str secara alfabetis.
  - Log mentah
```
str: twish
```
  - Aturan transformasi
```
e_set("str_sort", str_sort(v("str")))
```
  - Hasil
```
str: twish
str_sort: histw
```
- Contoh 2: Mengurutkan string str secara terbalik dalam kelompok dua.
  - Log mentah
```
str: twish
```
  - Aturan transformasi
```
e_set("str_sort", str_sort(v("str"), reverse=True))
```
  - Hasil
```
str: twish
str_sort: wtsih
```

str_reverse

Membalikkan string.

Sintaksis
```
str_reverse(value)
```
Parameter

Nama Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

Nilai yang akan dibalik.
Respons

Mengembalikan string yang telah dibalik.

Contoh

Membalikkan nilai field data.

Log mentah
```
data:twish
```

Aturan transformasi

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

Hasil
```
data:twish
reverse_data:hsiwt
```

str_logstash_config_normalize

Mengonversi konfigurasi Logstash ke format JSON.

Sintaksis
```
str_logstash_config_normalize(value)
```
Catatan
Untuk detail bahasa konfigurasi Logstash, lihat Logstash.
Parameter

Nama Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

Nilai yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.

Contoh

Transformasi data Logstash.

Log mentah
```
logstash: {"name"=>"tw5"}
```

Aturan transformasi

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

Hasil

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

str_hex_escape_encode

Meng-escape karakter khusus dan mengonversi karakter heksadesimal menjadi karakter Tionghoa.

Sintaksis
```
str_hex_escape_encode(value)
```
Parameter

Nama Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

Nilai yang akan di-escape.
Respons

Mengembalikan string yang telah di-escape.

Contoh

Meng-escape nilai field myfriend menjadi karakter Tionghoa.

Log mentah
```
myfriend: \xE6\x9F\xB3\xE4\xBA\x91
```

Aturan transformasi

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

Hasil

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

str_strip

Menghapus karakter tertentu dari string.

Sintaksis
```
str_strip(value, chars)
```

Parameter

Nama parameter	Tipe data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
chars	Arbitrary (auto-converted to string)	Tidak	Set karakter yang akan dihapus dari awal dan akhir string tertentu. Nilai default: `\t\r\n`.

Respons

Mengembalikan string baru.

Contoh

Contoh 1: Menghapus tanda bintang (*) dari awal nilai field strip.

Log mentah
```
strip: ***I love Etl
```

Aturan transformasi

e_set("str_strip", str_strip(v("strip"), "*"))

Hasil

strip: ***I love Etl
str_strip:I love Etl

Contoh 2: Menghapus spasi di awal.

Log mentah
```
strip:    I love Etl
```

Aturan transformasi

e_set("str_strip", str_strip(v("strip")))

Hasil

strip:    I love Etl
str_strip: I love Etl

Contoh 3: Menghapus set karakter xy.

Log mentah
```
strip:xy123yx
```

Aturan transformasi

e_set("str_strip", str_strip(v("strip"), "xy"))

Hasil
```
strip:xy123yx
str_strip:123
```

str_lower

Mengonversi semua karakter kapital dalam string menjadi huruf kecil.

Sintaksis
```
str_lower(value)
```
Parameter

Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.
Contoh

Mengonversi nilai field name menjadi huruf kecil.
- Log mentah
```
name: Etl
```
- Aturan transformasi
```
e_set("str_lower", str_lower(v("name")))
```
- Hasil
```
name: Etl
str_lower: etl
```

str_upper

Mengonversi semua karakter huruf kecil dalam string menjadi huruf kapital.

Sintaksis
```
str_upper(value)
```
Parameter

Parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.
Contoh

Mengonversi nilai field name menjadi huruf kapital.
- Log mentah
```
name: etl
```
- Aturan transformasi
```
e_set("str_upper", str_upper(v("name")))
```
- Hasil
```
name: etl
str_upper: ETL
```

str_title

Menjadikan huruf pertama setiap kata kapital dan mengubah sisanya menjadi huruf kecil.

Sintaksis
```
str_title(value)
```
Parameter

Nama parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.
Contoh

Menjadikan huruf pertama setiap kata dalam nilai field word menjadi kapital.
- Log mentah
```
word: this is etl
```
- Aturan transformasi
```
e_set("str_title", str_title(v("word")))
```
- Hasil
```
word: this is etl
str_title: This Is Etl
```

str_capitalize

Menjadikan huruf pertama kapital dan mengubah sisanya menjadi huruf kecil.

Sintaksis
```
str_capitalize(value)
```
Parameter

Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.
Contoh

Menjadikan huruf pertama dari nilai field word menjadi kapital dan mengonversi huruf lainnya menjadi huruf kecil.
- Log mentah
```
word: this Is MY EAL
```
- Aturan transformasi
```
e_set("str_capitalize", str_capitalize(v("word")))
```
- Hasil
```
word: this Is MY EAL
str_capitalize: This is my eal
```

str_lstrip

Fungsi str_lstrip menghapus karakter yang ditentukan dari awal string.

Sintaksis
```
str_lstrip(value, chars)
```

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
chars	Arbitrary (auto-converted to string)	Tidak	Set karakter yang akan dihapus dari awal string. Nilai default: spasi.

Respons

Mengembalikan string baru.

Contoh

Contoh 1: Menghapus tanda bintang (*) dari awal nilai field word.

Log mentah
```
word: ***this is string
```

Aturan transformasi

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

Hasil

word: ***this is string
str_lstrip: this is string

Contoh 2: Menghapus spasi dari awal nilai field word.

Log mentah
```
word:     this is string
```

Aturan transformasi

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

Hasil

word:     this is string
str_lstrip: this is string

Contoh 3: Menghapus set karakter xy.

Log mentah
```
lstrip:xy123yx
```

Aturan transformasi

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

Hasil
```
lstrip:xy123yx
str_lstrip:123yx
```

str_rstrip

Menghapus karakter trailing tertentu dari string.

Sintaksis
```
str_rstrip(value, chars)
```

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
chars	Arbitrary (auto-converted to string)	Tidak	Set karakter yang akan dihapus dari akhir string. Nilai default: spasi.

Respons

Mengembalikan string baru.

Contoh

Contoh 1: Menghapus tanda bintang (*) dari akhir nilai field word.

Log mentah
```
word: this is string*****
```

Aturan transformasi

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

Hasil

word: this is string*****
str_rstrip: this is string

Contoh 2: Menghapus set karakter xy.

Log mentah
```
word:xy123yx
```

Aturan transformasi

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

Hasil
```
word:xy123yx
str_rstrip:xy123
```

str_swapcase

Mengubah besar-kecil huruf dalam string.

Sintaksis
```
str_swapcase(value)
```
Parameter

Nama Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan dikonversi.
Respons

Mengembalikan string yang telah dikonversi.

Contoh

Log mentah
```
name: this is string
```

Aturan transformasi

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

Hasil

name: this is string
str_swapcase: THIS IS STRING

str_translate

Mengganti karakter berdasarkan tabel pemetaan.

Sintaksis

str_translate(value, replace_string, mapping_string)

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli tempat karakter akan diganti.
replace_string	Arbitrary (auto-converted to string)	Ya	Set karakter yang akan diganti.
mapping_string	Arbitrary (auto-converted to string)	Ya	Set karakter setelah penggantian.

Respons

Mengembalikan string baru.

Contoh

Log mentah
```
name: I love ETL!!!
```

Aturan transformasi

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

Hasil

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

str_endswith

Fungsi str_endswith memeriksa apakah suatu string diakhiri dengan sufiks tertentu.

Sintaksis
```
str_endswith(value, suffix, start, end)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan diperiksa.
suffix	Arbitrary (auto-converted to string)	Ya	Sufiks. Nilai parameter ini dapat berupa string atau elemen.
start	Number	Tidak	Posisi mulai pemeriksaan. Nilai 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.
end	Number	Tidak	Posisi akhir pemeriksaan. Nilai 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.

Respons

Jika string diakhiri dengan sufiks tertentu, mengembalikan True. Jika tidak, mengembalikan False.

Contoh

Log mentah
```
name: this is endswith!!!
```

Aturan transformasi

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

Hasil

name: this is endswith!!!
str_endswith: True

str_startswith

Fungsi str_startswith memeriksa apakah sebuah string diawali dengan awalan yang ditentukan.

Sintaksis
```
str_startswith(value, prefix, start, end)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan diperiksa.
prefix	Arbitrary (auto-converted to string)	Ya	Awalan. Nilai parameter ini dapat berupa string atau elemen.
start	Number	Tidak	Posisi mulai pemeriksaan. Nilai 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.
end	Number	Tidak	Posisi akhir pemeriksaan. Nilai 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.

Respons

Jika string diawali dengan awalan tertentu, mengembalikan True. Jika tidak, mengembalikan False.

Contoh

Log mentah
```
name: !! this is startwith
```

Aturan transformasi

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

Hasil

name: !! this is startwith
str_startswith: True

str_find

Memeriksa apakah string sumber berisi substring tertentu.

Sintaksis
```
str_find(value, str, begin, end)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli tempat substring akan dicari.
str	Arbitrary (auto-converted to string)	Ya	Substring yang akan dicari.
begin	Number	Tidak	Posisi mulai pencarian. Nilai default 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.
end	Number	Tidak	Posisi akhir indeks. Nilai default adalah panjang string. Nilai 0 menunjukkan karakter pertama. Nilai -1 menunjukkan karakter terakhir.

Respons

Mengembalikan posisi kemunculan pertama substring tertentu.

Contoh

Log mentah
```
name: hello world
```

Aturan transformasi

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

Hasil
```
name: hello world
str_find: 0
```

str_count

Menghitung jumlah kemunculan karakter dalam string.

Sintaksis
```
str_count(value, sub, start, end)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String sumber untuk penghitungan.
sub	Arbitrary (auto-converted to string)	Ya	Karakter yang jumlah kemunculannya ingin dihitung.
start	Number	Tidak	Posisi mulai pencarian karakter tertentu dalam string. Nilai yang valid: 0 (default): karakter pertama -1: karakter terakhir
end	Number	Tidak	Posisi akhir pencarian karakter tertentu dalam string. Nilai yang valid: 0: karakter pertama -1 (default): karakter terakhir

Respons

Mengembalikan jumlah kemunculan karakter tertentu.

Contoh

Log mentah
```
name: this is really a string
```

Aturan transformasi

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

Hasil

name: this is really a string
str_count: 3

str_rfind

Mengembalikan posisi kemunculan terakhir substring.

Sintaksis
```
str_rfind(value, substr, beg, end)
```
Catatan
Fungsi ini mendukung parameter variabel dasar. Pemanggilan fungsi.

Parameter

Nama Parameter	Tipe data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String sumber yang akan dicari.
substr	Arbitrary (auto-converted to string)	Ya	Karakter yang akan dicari.
beg	Number	Tidak	Posisi mulai pencarian. Nilai default: 0.
end	Number	Tidak	Posisi akhir pencarian. Nilai default adalah panjang string.

Respons

Mengembalikan posisi kemunculan terakhir karakter atau string tertentu.

Contoh

Log mentah
```
name: this is really a string
```

Aturan transformasi

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

Hasil

name: this is really a string
str_rfind: 20

str_split

Memisahkan string menjadi substring berdasarkan pemisah tertentu.

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

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dipisahkan.
sep	Number	Tidak	Delimiter. Nilai None menunjukkan spasi.
maxsplit	Number	Tidak	Jumlah maksimum substring tempat string dapat dipisahkan. Nilai -1 menunjukkan tanpa batas.

Respons

Mengembalikan string yang telah diproses.

Contoh

Memisahkan nilai field content menggunakan delimiter spasi.

Log mentah
```
content: hello world
```

Aturan transformasi

e_set("str_split", str_split(v("content"), " "))

Hasil

content: hello world
str_split: ["hello", "world"]

str_splitlines

Memisahkan string berdasarkan line feed.

Sintaksis
```
str_splitlines(value, keepends)
```

Parameter

Nama Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dipisahkan.
keepends	Boolean	Tidak	Menentukan apakah line feed dipertahankan dalam hasil. Line feed mencakup `\r`, `\r\n`, dan `\n`. Nilai default: False, yang menunjukkan bahwa line feed dihapus. Nilai True menunjukkan bahwa line feed dipertahankan.

Respons

Mengembalikan daftar yang telah diproses.

Contoh

Contoh 1

Log mentah
```
content: ab c\n\nde fg\rkl\r\n
```

Aturan transformasi

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

Hasil

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

Contoh 2

Log mentah
```
content: ab c\n\nde fg\rkl\r\n
```

Aturan transformasi

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

Hasil

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

str_partition

Memisahkan string menjadi tiga bagian dari kiri ke kanan menggunakan delimiter tertentu.

Sintaksis
```
str_partition(value, substr)
```

Parameter

Parameter	Tipe Data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String yang akan dipisahkan.
substr	Arbitrary (auto-converted to string)	Tidak	Delimiter.

Respons

Mengembalikan daftar hasil pemisahan.

Contoh

Memisahkan nilai field website menjadi tiga bagian dari kiri ke kanan menggunakan delimiter ..

Log mentah
```
website: www.aliyun.com
```

Aturan transformasi

e_set("str_partition", str_partition(v("website"), "."))

Hasil

website: www.aliyun.com
str_partition:  ["www", ".", "aliyun.com"]

str_rpartition

Memisahkan string menjadi tiga bagian dari kanan ke kiri menggunakan delimiter tertentu.

Sintaksis
```
str_rpartition(value, substr)
```

Parameter

Nama parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dipisahkan.
substr	Arbitrary (auto-converted to string)	Tidak	Delimiter.

Respons

Mengembalikan daftar yang telah diproses.

Contoh

Memisahkan nilai field website menjadi tiga bagian dari kanan ke kiri menggunakan delimiter ..

Log mentah
```
website: www.aliyun.com
```

Aturan transformasi

e_set("str_partition", str_rpartition(v("website"), "."))

Hasil

  website: www.aliyun.com
  str_partition: ["www.aliyun", ".", "com"]

str_center

Menambahkan padding pada string hingga panjang tertentu dengan karakter tertentu.

Sintaksis
```
str_center(value, width, fillchar)
```

Parameter

Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
width	Number	Ya	Panjang string setelah padding.
fillchar	Arbitrary (auto-converted to string)	Tidak	Karakter yang digunakan untuk padding. Nilai default: spasi.

Respons

Mengembalikan string baru.

Catatan
Jika panjang string baru setelah padding lebih kecil daripada panjang string asli, string asli dikembalikan.

Contoh

Contoh 1: Menambahkan padding pada string menggunakan tanda bintang (*).

Log mentah
```
center: this is center
```

Aturan transformasi

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

Hasil

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

Contoh 2: Menambahkan padding pada string menggunakan spasi.

Log mentah
```
center: this is center
```

Aturan transformasi

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

Hasil

center: this is center
str_center:              this is center

str_zfill

Fungsi str_zfill menambahkan angka nol di sebelah kiri string hingga mencapai panjang yang ditentukan.

Sintaksis
```
str_zfill(value, width)
```

Parameter

Nama parameter	Tipe data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
width	Number	Ya	Panjang string setelah padding.

Respons

Mengembalikan string baru.

Contoh

Log mentah
```
center: this is zfill
```

Aturan transformasi

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

Hasil

center:this is zfill
str_zfill:000000000000000000000000000this is zfill

str_expandtabs

Mengganti \t dalam string dengan spasi.

Sintaksis
```
str_expandtabs(value, tabsize)
```

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
tabsize	Number	Ya	Jumlah spasi setelah konversi.

Respons

Mengembalikan string baru.

Contoh

Contoh 1: Mengonversi \t dalam nilai field logstash menjadi spasi.

Log mentah
```
logstash: this is\tstring
```

Aturan transformasi

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

Hasil

logstash: this is\tstring
str_expandtabs: this is string

Contoh 2: Mengonversi \t dalam nilai field center menjadi spasi.

Log mentah
```
{"center": "this is\tstring"}
```

Aturan transformasi

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

Hasil

center: this is\tstring
str_expandtabs: this is         string

str_ljust

Menambahkan padding kanan pada string hingga panjang tertentu dengan karakter tertentu.

Sintaksis
```
str_ljust(value, width, fillchar)
```

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
width	Number	Ya	Panjang string setelah padding.
fillchar	Arbitrary (auto-converted to string)	Tidak	Karakter yang digunakan untuk padding. Nilai default: spasi.

Respons

Mengembalikan string baru.

Catatan
Jika panjang string baru setelah padding lebih kecil daripada panjang string asli, string asli dikembalikan.

Contoh

Contoh 1

Log mentah
```
content: this is ljust
```

Aturan transformasi

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

Hasil

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

Contoh 2

Log mentah
```
center: this is ljust
```

Aturan transformasi

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

Hasil

center: this is ljust
str_ljust: this is ljust

Contoh 3: Jika width kurang dari atau sama dengan panjang string, fungsi mengembalikan string asli.
- Log mentah
```
center: this is ljust
```
- Aturan transformasi
```
e_set("str_ljust", str_ljust(v("center"),10,  "*"))
```
- Hasil
```
center: this is ljust
str_ljust: this is ljust
```

str_rjust

Menambahkan padding kiri pada string hingga panjang tertentu dengan karakter tertentu.

Sintaksis
```
str_rjust(value, width, fillchar)
```

Parameter

Parameter	Tipe data	Wajib	Deskripsi
value	Arbitrary (auto-converted to string)	Ya	String asli yang akan dimodifikasi.
width	Number	Ya	Panjang string setelah padding.
fillchar	Arbitrary (auto-converted to string)	Tidak	Karakter yang digunakan untuk padding. Nilai default: spasi.

Respons

Mengembalikan string baru.

Catatan
Jika panjang string baru setelah padding lebih kecil daripada panjang string asli, string asli dikembalikan.

Contoh

Log mentah
```
center: this is rjust
```

Aturan transformasi

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

Hasil

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

str_zip

Memisahkan dua nilai string atau ekspresi dan menggabungkan hasilnya menjadi satu string.

Sintaksis

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

Parameter

Nama Parameter	Type	Wajib	Deskripsi
value1	Arbitrary (auto-converted to string)	Ya	Nilai yang akan digabungkan.
value2	Arbitrary (auto-converted to string)	Ya	Nilai yang akan digabungkan.
combine_sep	Arbitrary (auto-converted to string)	Tidak	Identifier yang digunakan untuk menggabungkan elemen. Nilai default: `#`.
sep	Arbitrary (auto-converted to string)	Tidak	Delimiter yang digunakan di antara elemen setelah penggabungan. Nilai harus berupa satu karakter. Nilai default: `,`.
quote	Arbitrary (auto-converted to string)	Tidak	Karakter yang digunakan untuk membungkus elemen setelah penggabungan. Parameter ini wajib jika nilai berisi delimiter. Nilai default: `"`.
lparse	Arbitrary (auto-converted to string)	Tidak	Delimiter dan quote yang digunakan di antara elemen `value1`. Delimiter default: `,`. Quote default: `"`. Format: `lparse=(',', '"')`. Catatan Quote memiliki prioritas lebih tinggi daripada delimiter.
rparse	Arbitrary (auto-converted to string)	Tidak	Delimiter dan quote yang digunakan di antara elemen `value2`. Delimiter default `,`. Quote default: `"`. Format: `rparse=(',', '"')`. Catatan Quote memiliki prioritas lebih tinggi daripada delimiter.

Respons

Mengembalikan string gabungan.

Contoh

Contoh 1

Log mentah
```
website: wwww.aliyun.com
escape_name: o
```

Aturan transformasi

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

Hasil

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

Contoh 2

Log mentah
```
website: wwww.aliyun.com
escape_name: o
```

Aturan transformasi

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

Hasil

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

Contoh 3: Menggunakan parameter sep.

Log mentah
```
f1: a,b,c
f2: x,y,z
```

Aturan transformasi

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

Hasil

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

Contoh 4: Menggunakan parameter quote.

Log mentah
```
f1: "a,a", b, "c,c"
f2: x, "y,y", z
```

Aturan transformasi

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

Hasil

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

Contoh 5: Menggunakan nilai field yang panjangnya berbeda.

Log mentah
```
f1: a,b
f2: x,y,z
```

Aturan transformasi

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

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

Contoh 6: Menggunakan parameter lparse dan rparse.

Log mentah
```
f1: a#b#c
f2: x|y|z
```

Aturan transformasi

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

Hasil

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

Contoh 7: Menggunakan parameter lparse dan rparse.

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

Aturan transformasi

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

Hasil

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

str_isalnum

Memeriksa apakah string bersifat alfanumerik.

Sintaksis
```
str_isalnum(value)
```
Parameter

Nama parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: 13
```

Aturan transformasi

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

Hasil
```
content: 13
str_isalnum: True
```

str_isalpha

Memeriksa apakah string hanya terdiri dari huruf.

Sintaksis
```
str_isalpha(value)
```
Parameter

Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: 13
```

Aturan transformasi

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

Hasil
```
content: 13
str_isalpha: False
```

str_isascii

Menentukan apakah string merupakan ASCII.

Sintaksis
```
str_isascii(value)
```
Parameter

Nama parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: asw123
```

Aturan transformasi

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

Hasil
```
content: asw123
str_isascii: True
```

str_isdecimal

Memeriksa apakah string hanya berisi karakter desimal.

Sintaksis
```
str_isdecimal(value)
```
Parameter

Nama Parameter

Type

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Contoh 1

Log mentah
```
welcome: Hello
```

Aturan transformasi

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

Hasil
```
welcome: Hello
str_isdecimal: False
```

Contoh 2

Log mentah
```
num: 123
```

Aturan transformasi

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

Hasil
```
num: 123
str_isdecimal: True
```

str_isdigit

Memeriksa apakah string hanya berisi angka.

Sintaksis
```
str_isdigit(value)
```
Parameter

Nama Parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: 13
```

Aturan transformasi

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

Hasil
```
content: 13
str_isdigit: True
```

str_isidentifier

Menentukan apakah string merupakan identifier Python yang valid.

Sintaksis
```
str_isidentifier(value)
```
Parameter

Nama parameter

Tipe Data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
class: class
```

Aturan transformasi

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

Hasil
```
class: class
str_isidentifier: True
```

str_islower

Memeriksa apakah string hanya berisi huruf kecil.

Sintaksis
```
str_islower(value)
```
Parameter

Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
lower: asds
```

Aturan transformasi

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

Hasil
```
lower: asds
str_islower: True
```

str_isnumeric

Memeriksa apakah string hanya berisi angka.

Sintaksis
```
str_isnumeric(value)
```
Parameter

Parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
num: 123
```

Aturan transformasi

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

Hasil
```
num: 123
str_isnumeric: True
```

str_isprintable

Fungsi str_isprintable memeriksa apakah semua karakter dalam string tersebut dapat dicetak.

Sintaksis
```
str_isprintable(value)
```
Parameter

Nama parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: vs;,.as
```

Aturan transformasi

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

Hasil
```
content: vs;,.as
str_isprintable: True
```

str_isspace

Menentukan apakah string hanya terdiri dari karakter spasi.

Sintaksis
```
str_isspace(value)
```
Parameter

Nama Parameter

Tipe

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
space:  as afsd
```

Aturan transformasi

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

Hasil
```
space:  as afsd
str_isspace: False
```

str_istitle

Memeriksa apakah huruf pertama setiap kata dalam string berupa huruf kapital dan huruf sisanya berupa huruf kecil.

Sintaksis
```
str_istitle(value)
```
Parameter

Parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
title: Alex Is A Boy
```

Aturan transformasi

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

Hasil
```
str_istitle:true
title:Alex Is A Boy
```

str_isupper

Memeriksa apakah semua huruf dalam string berupa huruf kapital.

Sintaksis
```
str_isupper(value)
```
Parameter

Nama Parameter

Tipe data

Wajib

Deskripsi

value

Arbitrary (auto-converted to string)

Ya

String yang akan diperiksa.
Respons

Mengembalikan nilai True atau False.

Contoh

Log mentah
```
content: ASSD
```

Aturan transformasi

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

Hasil
```
content: ASSD
str_isupper: True
```

str_uuid

Menghasilkan UUID acak.

Sintaksis
```
str_uuid(lower=True)
```

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
lower	Boolean	Tidak	Menentukan apakah huruf dalam UUID output berupa huruf kecil. Nilai default: True, yang menunjukkan bahwa huruf berupa huruf kecil.

Respons

Mengembalikan UUID.

Contoh

Contoh 1

Log mentah
```
content: I am Iron man
```
Aturan transformasi
```
e_set("UUID", str_uuid())
```

Hasil

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

Contoh 2

Log mentah
```
content: I am Iron man
```
Aturan transformasi
```
e_set("UUID", str_uuid(lower=False))
```

Hasil

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

Fungsi

str_format

Sintaksis

Parameter

Respons

Contoh

str_join

Sintaksis

Parameter

Respons

Contoh

str_encode

Sintaksis

Parameter

Respons

Contoh

str_decode

Sintaksis

Parameter

Respons

Contoh

str_replace

Sintaksis

Parameter

Respons

Contoh

str_sort

Sintaksis

Parameter

Respons

Contoh

str_reverse

Sintaksis

Parameter

Respons

Contoh

str_logstash_config_normalize

Sintaksis

Parameter

Respons

Contoh

str_hex_escape_encode

Sintaksis

Parameter

Respons

Contoh

str_strip

Sintaksis

Parameter

Respons

Contoh

str_lower

Sintaksis

Parameter

Respons

Contoh

str_upper

Sintaksis

Parameter

Respons

Contoh

str_title

Sintaksis

Parameter

Respons

Contoh

str_capitalize

Sintaksis

Parameter

Respons

Contoh

str_lstrip

Sintaksis

Parameter

Respons

Contoh

str_rstrip

Sintaksis

Parameter

Respons