Di MariaDB, INSTR()
adalah fungsi string bawaan yang mengembalikan posisi kemunculan pertama substring dalam string lain.
INSTR()
mirip dengan LOCATE()
fungsi, kecuali LOCATE()
menyediakan pilihan untuk menentukan posisi awal untuk pencarian. Juga, urutan argumen dibalik antara dua fungsi ini.
Sintaks
Sintaksnya seperti ini:
INSTR(str,substr)
Dimana str
adalah string, substr
adalah substring untuk ditemukan.
Contoh
Berikut ini contoh dasarnya:
SELECT INSTR('The hot sun', 'hot');
Hasil:
+-----------------------------+ | INSTR('The hot sun', 'hot') | +-----------------------------+ | 5 | +-----------------------------+
Tidak Peka Huruf Besar
INSTR()
melakukan pencarian peka huruf besar/kecil:
SELECT INSTR('The hot sun', 'HOT');
Hasil:
+-----------------------------+ | INSTR('The hot sun', 'HOT') | +-----------------------------+ | 5 | +-----------------------------+
Beberapa Kejadian
Jika substring muncul lebih dari sekali, hanya posisi substring pertama yang dikembalikan:
SELECT INSTR('The hot sun is really hot', 'hot');
Hasil:
+-------------------------------------------+ | INSTR('The hot sun is really hot', 'hot') | +-------------------------------------------+ | 5 | +-------------------------------------------+
Kecocokan Sebagian
Jika substring adalah bagian dari kata yang lebih besar, itu masih cocok:
SELECT INSTR('The hottest sun', 'hot');
Hasil:
+---------------------------------+ | INSTR('The hottest sun', 'hot') | +---------------------------------+ | 5 | +---------------------------------+
Tetapi jika string hanya bagian dari substring, itu tidak cocok:
SELECT INSTR('The hot sun', 'hottest');
Hasil:
+---------------------------------+ | INSTR('The hot sun', 'hottest') | +---------------------------------+ | 0 | +---------------------------------+
Ruang
Karakter spasi masih berupa string, jadi kita dapat menyertakan spasi di substring, meskipun itu satu-satunya karakter:
SELECT INSTR('The hot sun', ' ');
Hasil:
+---------------------------+ | INSTR('The hot sun', ' ') | +---------------------------+ | 4 | +---------------------------+
String Kosong
Inilah yang terjadi ketika substring adalah string kosong:
SELECT INSTR('The hot sun', '');
Hasil:
+--------------------------+ | INSTR('The hot sun', '') | +--------------------------+ | 1 | +--------------------------+
Tidak Cocok
Jika substring tidak ditemukan dalam string, INSTR()
mengembalikan 0
:
SELECT INSTR('The hot sun', 'cold');
Hasil:
+------------------------------+ | INSTR('The hot sun', 'cold') | +------------------------------+ | 0 | +------------------------------+
Argumen Null
Memberikan null
untuk salah satu argumen menghasilkan null
:
SELECT
INSTR('The hot sun', null),
INSTR(null, 'hot');
Hasil:
+----------------------------+--------------------+ | INSTR('The hot sun', null) | INSTR(null, 'hot') | +----------------------------+--------------------+ | NULL | NULL | +----------------------------+--------------------+
Menyediakan Jumlah Argumen yang Salah
Memanggil INSTR()
dengan jumlah argumen yang salah, atau tanpa memberikan argumen apa pun menghasilkan kesalahan:
SELECT INSTR('hot');
Hasil:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'INSTR'