All Products
Search
Document Center

ApsaraVideo VOD:Fungsi string

Last Updated:Nov 07, 2026

Topik ini menjelaskan sintaksis, deskripsi, parameter, dan nilai kembali dari fungsi string, serta menyertakan contoh penggunaannya.

substr

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

substr(s, i, j)

Deskripsi

Mengekstrak bagian dari sebuah string.

Parameter

  • s: string sumber.

  • i: posisi awal ekstraksi dalam string sumber, dihitung mulai dari 1. Nilai -1 menentukan karakter paling kanan dari string. Tipe data: integer.

  • j: posisi akhir ekstraksi dalam string sumber, dihitung mulai dari 1. Nilai -1 menentukan karakter paling kanan dari string. Tipe data: integer.

Nilai kembali

Mengembalikan substring s[i, j] yang diekstrak dari string sumber yang ditentukan oleh s.

Contoh

//Catatan: Dua metode yang digunakan untuk menentukan apakah sebuah file adalah file M3U8.
if eq(substr($uri, -5, -1), '.m3u8') {
    say(concat($uri, ' is .m3u8'))
}

uri_len = len($uri)
if eq(substr($uri, -5, uri_len), '.m3u8') {
    say(concat($uri, ' is .m3u8'))
}

concat

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

concat(s1, ...)

Deskripsi

Menggabungkan string.

Parameter

String yang ingin Anda gabungkan. Anda dapat menentukan satu atau lebih string. Nilai numerik didukung.

Nilai kembali

Mengembalikan string yang telah digabungkan.

Contoh

// Menggabungkan string berikut
str1 = 'hello'
str2 = ' '
str3 = 'world'
say(concat(str1, str2, str3))

Output:

  hello world

upper

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

upper(s)

Deskripsi

Mengonversi string menjadi huruf kapital.

Parameter

s: string yang ingin Anda konversi.

Nilai kembali

Mengembalikan string yang ditentukan oleh parameter s dalam huruf kapital.

Contoh

str = 'hello world'                                                                                                                                                                                   
say(upper(str)) 

Output:

HELLO WORLD

lower

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

lower(s)

Deskripsi

Mengonversi string menjadi huruf kecil.

Parameter

s: string yang ingin Anda konversi.

Nilai kembali

Mengembalikan string yang ditentukan oleh parameter s dalam huruf kecil.

Contoh

str = 'HELLO WORLD'
say(lower(str))

Output:

hello world

len

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

len(s)

Deskripsi

Mendapatkan panjang sebuah string.

Parameter

s: string yang ingin Anda ukur.

Nilai kembali

Mengembalikan panjang string yang ditentukan oleh parameter s. Tipe data: integer.

Contoh

str = 'hello world'
say(len(str)) // Mengembalikan panjang str. Di sini hasilnya adalah 11.

byte

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

byte(c)

Deskripsi

Mendapatkan nilai ASCII dari sebuah karakter.

Parameter

c: karakter yang nilai ASCII-nya ingin Anda dapatkan. Anda hanya dapat menentukan satu karakter.

Nilai kembali

Mengembalikan nilai ASCII dari karakter yang ditentukan. Tipe data: numerik.

Contoh

say(byte('a'))
say(byte('A'))

Output:

97
65

match_re

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

match_re(s, p [, o])

Deskripsi

Menggunakan mesin Perl Compatible Regular Expressions (PCRE) untuk pencocokan ekspresi reguler. Untuk informasi selengkapnya, lihat Sintaksis PCRE.

Parameter

  • s: string yang ingin Anda cocokkan. Tipe data: string.

  • p: ekspresi reguler untuk pencocokan. Tipe data: string.

  • o: mesin ekspresi reguler. Tipe data: string. Parameter ini bersifat opsional.

    • nilai kosong: menentukan bahwa fungsi ini peka huruf besar/kecil (case-sensitive).

    • i: menentukan bahwa fungsi ini tidak peka huruf besar/kecil (case-insensitive).

Nilai kembali

Jika string sesuai dengan ekspresi reguler, maka true dikembalikan. Jika tidak, false dikembalikan.

Contoh

str = 'Hello'
// Pencocokan tepat dengan "Hello"
say(match_re(str, 'Hello'))
// Pencocokan tanpa mempedulikan huruf besar/kecil dengan "Hello" 
say(match_re(str, 'hello', i))
// Mencocokkan string apa pun yang berakhiran huruf "l"
say(match_re(str, '.*l$'))

Output:

true
true
false

capture_re

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

capture_re(s, p [,init])

Deskripsi

Menangkap kecocokan dari sebuah string dan mengembalikan substring yang sesuai. Untuk informasi selengkapnya tentang PCRE, lihat Sintaksis PCRE.

Parameter

  • s: string yang ingin Anda cocokkan. Tipe data: string.

  • p: ekspresi reguler untuk pencocokan. Tipe data: string.

  • init: posisi awal pencocokan, dihitung mulai dari 1. Tipe data: integer.

Nilai kembali

Mengembalikan substring yang cocok dalam tipe dictionary jika string sesuai dengan ekspresi reguler. Jika tidak, dictionary kosong akan dikembalikan.

Contoh

pcs = capture_re($request_uri,'^/([^/]+)/([^/]+)([^?]+)\?(.*)')
sec1 = get(pcs, 1)
sec2 = get(pcs, 2)
sec3 = get(pcs, 3)
if or(not(sec1), not(sec2), not(sec3)) {
   add_rsp_header('X-TENGINE-ERROR', 'auth failed - missing necessary uri set')
   exit(403)
}
digest = md5(concat(sec1, sec3))
if ne(digest, sec2) {
    add_rsp_header('X-TENGINE-ERROR', 'auth failed - invalid digest')
    exit(403)
}                                                                                                                                                      

Contoh respons

"X-TENGINE-ERROR:auth failed - missing necessary uri set"

gsub_re

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

gsub_re(subject, regex, replace [,option])

Deskripsi

Mengganti semua kecocokan dalam sebuah string dan mengembalikan string setelah penggantian. Untuk informasi selengkapnya tentang PCRE, lihat Sintaksis PCRE.

Parameter

  • subject: string yang ingin Anda cocokkan. Tipe data: string.

  • regex: ekspresi reguler. Tipe data: string.

  • replace: string pengganti. Tipe data: string.

    Anda dapat menentukan parameter replace menggunakan substring yang cocok.

    • $0: menentukan semua substring yang sesuai dengan regex.

    • $N: menentukan substring yang sesuai dengan sub-ekspresi dalam kurung ke-N () dari regex.

  • option: mesin ekspresi reguler. Tipe data: string. Parameter ini bersifat opsional.

Nilai kembali

Mengganti semua substring yang sesuai dengan parameter regex yang ditentukan dalam parameter subject yang ditentukan dengan nilai yang ditetapkan oleh parameter replace, lalu mengembalikan string setelah penggantian.

Contoh

subject = 'Hello, Es'
regex = '([a-zA-Z])[a-z]+'
replace = '[$0,$1]'
add_rsp_header('X-DEBUG-GSUB-RE', gsub_re(subject, regex, replace))                                                                                                                                    

Contoh respons

"X-DEBUG-GSUB-RE:[Hello,H], [Es,E]"

split

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

split(s [,sep])

Deskripsi

Memisahkan string menjadi array substring dan mengembalikan array tersebut.

Parameter

  • s: string yang ingin Anda pisahkan. Tipe data: string.

  • sep: pemisah yang digunakan untuk memisahkan string. Tipe data: string.

Nilai kembali

Mengembalikan array pasangan kunci-nilai dalam tipe dictionary. Nilai parameter key adalah angka yang dimulai dari 1, misalnya, [1]=xx dan [2]=y. Jika sep dikosongkan, string akan dipisahkan berdasarkan karakter spasi putih. Karakter spasi putih mencakup karakter spasi dan karakter tab (\t).

Contoh

if $arg_from {
    t = split($arg_from, ',')
    if get(t, 1) {
        say(concat('[1]=', get(t, 1)))
    }
    if get(t, 2) {
        say(concat('[2]=', get(t, 1)))
    }
}                                                                                                                                

Permintaan:

http://www.example.com?from=xx1,xx2,xx3

Output:

[1]=xx1
[2]=xx1

split_as_key

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

split_as_key(s [,sep])

Deskripsi

Memisahkan string menjadi array substring dan mengembalikan array tersebut.

Parameter

  • s: string yang ingin Anda pisahkan. Tipe data: string.

  • sep: pemisah yang digunakan untuk memisahkan string. Tipe data: string.

Nilai kembali

Mengembalikan parameter respons dengan cara yang sama seperti fungsi split(). Namun, parameter key dinamai berdasarkan setiap elemen yang dipisahkan: Element 1 -> Element 2.

Contoh

def echo_each(k, v, u) {
    s = concat(k, '=', v, ' u=', get(u, 1))
    say(s) 
}
if $arg_from {
    t = split_as_key($arg_from, ',')
    foreach(t, echo_each, ['hi,dsl'])
}                                                                                                                                  

Permintaan:

http://www.example.com?from=xx1,xx2,xx3

Output:

xx2=xx2 u=hi,dsl
xx1=xx1 u=hi,dsl
xx3=xx3 u=hi,dsl

tohex

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

tohex(s)

Deskripsi

Mengonversi string menjadi string heksadesimal.

Parameter

s: string yang ingin Anda konversi.

Nilai kembali

Mengembalikan string heksadesimal yang dikonversi dari string yang ditentukan oleh parameter s.

Contoh

digest = sha1('xxxx')
add_rsp_header('X-DSL-TOHEX', tohex(digest))

Contoh respons

"X-DSL-TOHEX: 4ad583af22c2e7d40c1c916b2920299155a46464"

tostring

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

tostring(a)

Deskripsi

Mengonversi data tipe apa pun menjadi string.

Parameter

a: data yang ingin Anda konversi. Tipe data: tipe apa pun.

Nilai kembali

Mengembalikan string yang dikonversi dari nilai yang ditentukan oleh parameter a.

Contoh

say(tostring(123))

Output:

123

tochar

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

tochar(n1, n2, ...)

Deskripsi

  • Mengonversi satu atau lebih integer internal (nilai ASCII) menjadi string. Misalnya, 48 sesuai dengan karakter "0".

  • Panjang string yang dikembalikan didasarkan pada jumlah parameter yang ditentukan.

Parameter

nX: integer yang ingin Anda konversi. Anda dapat menentukan satu atau lebih integer.

Nilai kembali

Mengembalikan string yang dikonversi dari integer.

Contoh

say(tochar(97))
say(tochar(65))

Output:

a
A

reverse

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

reverse(str)

Deskripsi

Membalik urutan string.

Parameter

str: string yang ingin Anda balik urutannya.

Nilai kembali

Mengembalikan string yang urutannya telah dibalik dari string yang ditentukan.

Contoh

say(reverse('hello'))

Output:

olleh

find

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

string.find (s, substr, pos)

Deskripsi

Mencari substring dalam string yang ditentukan.

Parameter

  • s: string yang akan dicari.

  • substr: substring yang ingin dicari.

  • pos: posisi dimulainya pencarian. Tipe data: numerik. Parameter ini bersifat opsional. Anda dapat menentukan integer negatif. Nilai default adalah 1.

Nilai kembali

  • Mengembalikan array jika substring yang ditentukan ditemukan.

    • Indeks 1 menunjukkan posisi awal pencarian.

    • Indeks 2 menunjukkan posisi akhir pencarian.

  • Mengembalikan array kosong jika substring yang ditentukan tidak ditemukan.

Contoh

str = 'hello world'
say(concat('r start pos: ',get(find(str, 'r'), 1)))
say(concat('r end pos: ',get(find(str, 'r'), 2)))
say(concat('rl start pos: ',get(find(str, 'rl'), 1)))
say(concat('rl end pos: ',get(find(str, 'rl'), 2)))

Output:

r start pos: 9
r end pos: 9
rl start pos: 9
rl end pos: 10

format

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

format(fmt, ···)

Deskripsi

Memformat nilai dari satu atau lebih parameter. String format adalah parameter pertama, yang harus berupa string. String format mengikuti spesifikasi parameter sprintf yang digunakan oleh fungsi dalam bahasa pemrograman C.

Sintaksis string format adalah: %[parameter][flag][field width][.precision]specifier.

  • %%: mencetak tanda persen literal (%).

  • %c: mengonversi integer menjadi karakter ASCII.

  • %d: mengonversi integer menjadi angka desimal.

  • %f: mengonversi angka dengan presisi N menjadi angka floating point.

  • %o: mengonversi integer menjadi angka oktal.

  • %s: mengonversi integer menjadi string.

  • %x: mengonversi integer menjadi angka heksadesimal dalam huruf kecil.

  • %X: mengonversi integer menjadi angka heksadesimal dalam huruf kapital.

Parameter

  • fmt: tipe string. Parameter ini menentukan string format.

  • Jumlah parameter variabel: tipe apa pun.

Nilai kembali

Mengembalikan string ASCII.

Contoh

say(concat('format:', format('%%%s$%.2s$%s$%c$%d$%2.2f$%.2o$%x$%X', 'format', 3.1415926, true, 95, 3.1415926, 3.1415926, 3.1415926, 10, 10)))

Output:

format:%format$3.$true$_$3$3.14$03$a$A

tobin

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

tobin(str)

Deskripsi

Mengonversi string heksadesimal menjadi string ASCII.

Parameter

str: string heksadesimal byte ganda yang ingin Anda konversi. Tidak peka huruf besar/kecil.

Nilai kembali

Mengembalikan string ASCII.

Contoh

say(concat('tobin:', tobin('2F2F')))

Output:

tobin://

trim

Tabel berikut menjelaskan detail mengenai fungsi ini.

Fitur

Deskripsi

Sintaksis

trim(s, [, loc])

Deskripsi

Menghapus semua karakter spasi putih sebelum atau sesudah string yang ditentukan oleh parameter s, dan mengembalikan string dengan karakter spasi putih yang ditentukan telah dihapus.

Parameter

  • s: string.

  • loc: nilai default adalah both. Parameter ini bersifat opsional. Nilai yang valid:

    • both: menghapus karakter spasi putih sebelum dan sesudah string.

    • left: hanya menghapus karakter spasi putih sebelum string.

    • right: hanya menghapus karakter spasi putih sesudah string.

Nilai kembali

Mengembalikan string dengan karakter spasi putih yang ditentukan telah dihapus.

Contoh

say(concat('trim():', trim(' abcd ')))
say(concat('trim(left):', trim(' abcd', 'left')))
say(concat('trim(right):', trim('abcd ', 'right')))

Output:

trim():abcd
trim(left):abcd
trim(right):abcd