Temel Dil
Metin İşlemleri
Enterpolasyon ve metin üyeleri.
Enterpolasyon ve metin üyeleri.
Referans
Bu sayfa 11 katalog öğesini kapsar. Aşağıdaki maddeler language-spec, örnekler ve katalog alanlarından üretilmiştir.
kırp
Nedir?
metin.kırp() baştaki ve sondaki boşlukları kırpar; yeni metin döndürür. Kaynak metni değiştirmez.
Ne zaman kullanılır?
Kullanıcı veya dosya girdisindeki kenar boşluklarını temizlemek.
Parametreler ve dönüş
m.kırp(): metin — alıcı metin. Boş sonuç geçerli metin olabilir.
Kullanım
syaz " İbrahim ".kırp()Basit örnek
syaz " İbrahim ".kırp()Çıktı
İbrahim
Dikkat edilmesi gerekenler
- Yeni metin üretir; alıcıyı yerinde değiştirmez.
- Derleyici SUPPORTED.
İlgili konular
büyük
Nedir?
metin.büyük() açık tr-TR kültürüyle büyük harfe çevirir. Identifier büyük/küçük harf kurallarından ayrıdır; konak kültürü sonucu değiştirmez.
Ne zaman kullanılır?
Türkçe harf dönüşümüyle büyük harf üretmek (i→İ).
Parametreler ve dönüş
m.büyük(): metin. Örnek: "istanbul".büyük() → İSTANBUL.
Kullanım
syaz "istanbul".büyük()Basit örnek
syaz "istanbul".büyük()syaz "i".büyük()Çıktı
İSTANBUL İ
Dikkat edilmesi gerekenler
- tr-TR kültürüdür; ordinal arama değildir.
- Dil kimliği case-sensitive kalır; bu üye metin dönüşümüdür.
küçük
Nedir?
metin.küçük() açık tr-TR kültürüyle küçük harfe çevirir. "İSTANBUL".küçük() → istanbul; "I".küçük() → ı.
Ne zaman kullanılır?
Türkçe küçük harf dönüşümü gerektiğinde.
Parametreler ve dönüş
m.küçük(): metin. Konak kültürü sonucu değiştirmez.
Kullanım
syaz "İSTANBUL".küçük()Basit örnek
syaz "İSTANBUL".küçük()syaz "I".küçük()Çıktı
istanbul ı
Dikkat edilmesi gerekenler
- tr-TR; identifier casing değildir.
- Derleyici SUPPORTED.
içerir
Nedir?
metin.içerir(parça) ordinal ve büyük/küçük harf duyarlı alt metin arar; mantıksal döner. Kültür sıralaması kullanmaz.
Ne zaman kullanılır?
Metinde alt dizgi var mı diye bakmak.
Parametreler ve dönüş
m.içerir(parça: metin): mantıksal — ordinal, case-sensitive.
Kullanım
içinde: mantıksal = "Merhaba dünya".içerir("dünya")syaz "{içinde}"Basit örnek
içinde: mantıksal = "Merhaba dünya".içerir("dünya")syaz "{içinde}"Çıktı
doğru
Dikkat edilmesi gerekenler
- Ordinal;
büyük/küçükkültüründen ayrı. - Koleksiyon
içeririle karıştırmayın.
İlgili konular
başlar
Nedir?
metin.başlar(parça) metnin ordinal ve büyük/küçük harf duyarlı önek sınamasıdır; sonuç mantıksal döner.
Ne zaman kullanılır?
Önek doğrulamak.
Parametreler ve dönüş
m.başlar(parça: metin): mantıksal.
Kullanım
içinde: mantıksal = "Merhaba".başlar("Mer")syaz "{içinde}"Basit örnek
içinde: mantıksal = "Merhaba".başlar("Mer")syaz "{içinde}"Çıktı
doğru
Dikkat edilmesi gerekenler
- Ordinal case-sensitive.
- Derleyici SUPPORTED.
biter
Nedir?
metin.biter(parça) metnin ordinal ve büyük/küçük harf duyarlı sonek sınamasıdır; sonuç mantıksal döner.
Ne zaman kullanılır?
Uzantı veya sonek kontrolü.
Parametreler ve dönüş
m.biter(parça: metin): mantıksal.
Kullanım
son: mantıksal = "Merhaba".biter("aba")syaz "{son}"Basit örnek
son: mantıksal = "Merhaba".biter("aba")syaz "{son}"Çıktı
doğru
Dikkat edilmesi gerekenler
- Ordinal case-sensitive.
- Derleyici SUPPORTED.
değiştir
Nedir?
metin.değiştir(eski, yeni) ordinal, case-sensitive değiştirme yapar ve yeni metin döndürür.
Ne zaman kullanılır?
Alt metni başka bir metinle değiştirmek.
Parametreler ve dönüş
m.değiştir(eski: metin, yeni: metin): metin — ordinal.
Kullanım
syaz "Merhaba dünya".değiştir("dünya", "US")Basit örnek
syaz "Merhaba dünya".değiştir("dünya", "US")Çıktı
Merhaba US
Dikkat edilmesi gerekenler
- Kültür duyarsız arama değildir; ordinaldir.
- Derleyici SUPPORTED.
böl
Nedir?
metin.böl(ayraç) metni ayıraçla böler ve liste\<metin\> döndürür. Boş parçalar korunur. Boş ayıraç reddedilir.
Ne zaman kullanılır?
CSV benzeri veya ayraçlı metni parçalamak.
Parametreler ve dönüş
m.böl(ayraç: metin): liste\<metin\>. RUNTIME: boş ayıraç US1536 (DiagnosticCodes’ta JsonType adı; aynı kod).
Kullanım
parçalar: liste<metin> = "a,b,c".böl(",")Basit örnek
parçalar: liste<metin> = "a,b".böl(",")syaz "{parçalar.adet}"syaz parçalar[0]Çıktı
2 a
Geçersiz örnek
parçalar: liste<metin> = "a,b".böl("")US1536 — boş ayraç reddedilir.
Dikkat edilmesi gerekenler
- Boş ayraç → US1536.
- Boş parçalar korunur.
- Derleyici SUPPORTED.
İlgili konular
birleştir
Nedir?
birleştir ayıraç metin üyesidir: ayıraç.birleştir(liste) öğeleri birleştirip tek metin üretir. Alıcı listedeki öğeler değil, ayraçtır.
Ne zaman kullanılır?
Metin listesini tek satırda birleştirmek.
Parametreler ve dönüş
",".birleştir(değerler: liste\<metin\>): metin. yol.birleştir ile karıştırmayın.
Kullanım
syaz ",".birleştir(["a", "b", "c"])Basit örnek
syaz ",".birleştir(["a", "b", "c"])Çıktı
a,b,c
Dikkat edilmesi gerekenler
- Alıcı ayraç metnidir:
",".birleştir([...]). yol.birleştirdosya yolu API’sidir.- Derleyici SUPPORTED.
İlgili konular
Enterpolasyon kuralları
Nedir?
\{...\} enterpolasyon deliğidir; \{\{/\}\} kaçışı tek süslü üretir. Zaman biçimleri kültürden bağımsız: tarih yyyy-MM-dd; saat HH:mm:ss; tarihsaat yyyy-MM-dd HH:mm:ss; süre «N ms».
Sözdizimi
ad: metin = "İbrahim"syaz "Merhaba {ad}"syaz "{{süslü}}"Basit örnek
ad: metin = "İbrahim"syaz "Merhaba {ad}"Çıktı
Merhaba İbrahim
Dikkat edilmesi gerekenler
büyük/küçükTürkçe kültür; arama/değiştir ordinal.- Kapanmayan enterpolasyon US0204.
İlgili konular
Metin üye API
Nedir?
metin üyeleri: kırp, büyük, küçük, içerir, başlar, biter, değiştir, böl, birleştir. büyük/küçük açık tr-TR kültürüdür (konak kültürü sonucu değiştirmez). içerir/başlar/biter/değiştir ordinal ve büyük/küçük harf duyarlıdır.
Ne zaman kullanılır?
Türkçe harf dönüşümü, arama, bölme veya birleştirme gerektiğinde.
Parametreler ve dönüş
kırp(): metin. büyük(): metin, küçük(): metin. içerir(parça: metin): mantıksal, başlar(parça), biter(parça). değiştir(eski, yeni): metin. böl(ayraç): liste\<metin\> (boş parçalar korunur; boş ayraç US1536). birleştir ayıraç metninin üyesidir: ",".birleştir(liste\<metin\>): metin.
Kullanım
syaz "istanbul".büyük()syaz "İSTANBUL".küçük()syaz "Merhaba dünya".içerir("dünya")syaz ",".birleştir(["a", "b", "c"])Geçerli örnek
içinde: mantıksal = "Merhaba".başlar("Mer")son: mantıksal = "Merhaba".biter("aba")syaz "{içinde}"syaz "{son}"Çıktı
doğru doğru
Geçersiz örnek
parçalar: liste<metin> = "a,b".böl("")US1536 — boş ayraç reddedilir.
Dikkat edilmesi gerekenler
- "istanbul".büyük() → İSTANBUL; "İSTANBUL".küçük() → istanbul; "I".küçük() → ı.
- Arama/değiştir sıralama kültürüne bağlı değildir (ordinal).
- Derleyici stdlib metin üyeleri SUPPORTED (tr-TR).