STUFF (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Fungsi STUFF menyisipkan string ke string lain. Ini menghapus panjang karakter yang ditentukan dalam string pertama pada posisi mulai lalu menyisipkan string kedua ke string pertama pada posisi awal.

Konvensi Sintaksis T-SQL

Sintaks

STUFF ( character_expression , start , length , replaceWith_expression )  

Catatan

Untuk melihat sintaks transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

character_expression
Adalah ekspresi data karakter. character_expression dapat berupa konstanta, variabel, atau kolom dari data karakter atau biner.

start
Adalah nilai bilangan bulat yang menentukan lokasi untuk memulai penghapusan dan penyisipan. Jika awal negatif atau nol, string null dikembalikan. Jika start lebih panjang dari character_expression pertama, string null dikembalikan. start dapat berjenis bigint.

panjang
Adalah bilangan bulat yang menentukan jumlah karakter yang akan dihapus. Jika panjangnya negatif, string null dikembalikan. Jika panjangnya lebih panjang dari character_expression pertama, penghapusan terjadi hingga karakter terakhir di character_expression terakhir. Jika panjangnya nol, penyisipan terjadi di lokasi awal dan tidak ada karakter yang dihapus. panjangnya bisa berjenis bigint.

replaceWith_expression
Adalah ekspresi data karakter. character_expression dapat berupa konstanta, variabel, atau kolom dari data karakter atau biner. Ekspresi ini menggantikan karakter panjangcharacter_expression dimulai dari awal. Menyediakan NULL sebagai replaceWith_expression, menghapus karakter tanpa menyisipkan apa pun.

Jenis Pengembalian

Mengembalikan data karakter jika character_expression adalah salah satu jenis data karakter yang didukung. Mengembalikan data biner jika character_expression adalah salah satu jenis data biner yang didukung.

Keterangan

Jika posisi awal atau panjangnya negatif, atau jika posisi awal lebih besar dari panjang string pertama, string null dikembalikan. Jika posisi awal adalah 0, nilai null dikembalikan. Jika panjang yang akan dihapus lebih panjang dari string pertama, panjangnya akan dihapus ke karakter pertama dalam string pertama.

Kesalahan dimunculkan jika nilai yang dihasilkan lebih besar dari maksimum yang didukung oleh jenis pengembalian.

Karakter Tambahan (Pasangan Pengganti)

Saat menggunakan kolatasi SC, baik character_expression maupun replaceWith_expression dapat menyertakan pasangan pengganti. Parameter panjang menghitung setiap pengganti dalam character_expression sebagai satu karakter.

Contoh

Contoh berikut mengembalikan string karakter yang dibuat dengan menghapus tiga karakter dari string pertama, , abcdefmulai dari posisi 2, di b, dan menyisipkan string kedua pada titik penghapusan.

SELECT STUFF('abcdef', 2, 3, 'ijklmn');  
GO  

Berikut adalah hasil yang ditetapkan.

---------   
aijklmnef   
  
(1 row(s) affected)  

Lihat juga

CONCAT (SQL Bertransaksi)
CONCAT_WS (SQL Bertransaksi)
FORMATMESSAGE (SQL bertransaksi)
QUOTENAME (SQL Bertransaksi)
REPLACE (Transact-SQL)
TERBALIK (SQL bertransaksi)
STRING_AGG (T-SQL)
STRING_ESCAPE (SQL Bertransaksi)
TERJEMAHKAN (SQL Bertransaksi)
Tipe Data (Transact-SQL)
Fungsi String (SQL Transact)