İçeriğe geç

Türkçe İ/ı sorunu: ToLower() neden “fıle” üretir, giriş neden bozulur?

  • Anasayfa
  • Blog
  • Türkçe İ/ı sorunu: ToLower() neden “fıle” üretir, giriş neden bozulur?
Türkçe İ/ı sorunu: ToLower() neden “fıle” üretir, giriş neden bozulur?
Kısa cevap

Türkçede “I” harfinin küçüğü “ı”, “i” harfinin büyüğü “İ”’dir. Kültüre duyarlı ToLower(), ToUpper() veya büyük-küçük harf duyarsız karşılaştırmalar tr-TR ortamında “FILE” metnini “fıle” yapar ve “[email protected]” ile “[email protected]” eşleşmez. Çözüm; kimlik, anahtar, e-posta ve protokol metinlerinde kültürden bağımsız (ordinal/invariant) karşılaştırma kullanmak ve veritabanı harmanlamasını (collation) bilinçli seçmektir.

Belirtiler: “Invalid column name”, eşleşmeyen e-posta, çalışmayan arama

  • Geliştiricinin bilgisayarında sorunsuz çalışan uygulama, bölge ayarı Türkçe olan sunucuda veya istemcide farklı davranır.
  • Kullanıcı e-postasını büyük harfle yazınca giriş yapamaz; “kullanıcı bulunamadı” hatası alır.
  • Arama kutusunda “istanbul” yazınca “ISTANBUL” olarak kaydedilmiş kayıtlar gelmez.
  • Yapılandırma dosyasındaki “File”, “Id”, “Info” gibi anahtarlar veya enum değerleri tanınmaz.
  • Türkçe harmanlamalı bir SQL Server veritabanında sorgu şu hatayla düşer: “Msg 207, Level 16: Invalid column name ’musteriid’.” veya “Msg 208: Invalid object name ’dbo.MUSTERI’.”
  • Aynı sorgu, kodu yazan kişinin İngilizce harmanlamalı test veritabanında hatasız çalışır.

Kök neden: Türkçenin dört ayrı “i” harfi var

Latin alfabesi kullanan dillerin çoğunda “i” (U+0069) ile “I” (U+0049) aynı harfin küçük ve büyük biçimidir. Türkçede (ve Azericede) ise iki ayrı harf çifti vardır: “i” ile “İ” (U+0130) ve “ı” (U+0131) ile “I”. Unicode’un SpecialCasing.txt dosyası bu kuralı açıkça tanımlar: Türkçede “I” küçültülünce noktasız “ı”, “i” büyütülünce noktalı “İ” olur.

Microsoft Learn bu durumu “Turkish-I problem” olarak adlandırır ve kanonik örneği verir: büyük-küçük harf duyarsız ama kültüre duyarlı bir karşılaştırmayla yazılmış IsFileURI(“file:”) çağrısı, İngilizce kültürde true, Türkçe kültürde false döner. Belgeye göre bu, Türk sistemlerinde “FILE:” ile başlayan adresleri engelleyen bir güvenlik kontrolünün atlatılmasına bile yol açabilir. Java belgesi de aynı uyarıyı verir: “TITLE”.toLowerCase() Türkçe yerel ayarda “tıtle” döndürür ve programlama dili tanımlayıcıları, protokol anahtarları ve HTML etiketleri için Locale.ROOT kullanılmalıdır.

Veritabanı tarafında mekanizma aynıdır. SQL Server, işletim sistemi bölge ayarı Türkçe olan bir sunucuya kurulumda varsayılan harmanlama olarak Turkish_CI_AS seçer. Microsoft’un belgesine göre veritabanı harmanlaması, sütun verilerinin yanı sıra tablo ve sütun adları gibi tüm meta veriler için de kullanılır. “CI” büyük-küçük harf duyarsız demektir, ancak Türkçe kurallara göre “i” ile “I” aynı harfin iki biçimi değildir. Bu yüzden Turkish_CI_AS altında N’i’ = N’I’ yanlış, N’i’ = N’İ’ doğru döner; MusteriID adlı sütuna “musteriid” diye başvurmak 207 hatası verir.

Sorun yalnızca “i/I” harflerini içeren metinlerde görülür. “Ad”, “Tutar” gibi alanlar sorunsuz çalıştığı için hata çoğu zaman rastgele ve açıklanamaz görünür; testlerde yakalanmaması da bundandır.

Microsoft’un rehberine göre XML ve HTML etiketleri, kullanıcı adları, dosya yolları ve sistem nesnelerinin adları kültürden bağımsız verilerdir; bunlar kültüre duyarlıymış gibi yorumlanırsa ince hatalar, düşük performans ve bazı durumlarda güvenlik sorunları ortaya çıkar. Rehber ayrıca Ordinal karşılaştırıcının davranışının hiç değişmediğini, kültüre duyarlı karşılaştırıcıların ise ICU ve Windows NLS güncellemeleriyle zaman içinde değişebildiğini belirtir. Yani kültüre duyarlı bir karşılaştırma bugün testten geçse bile bir platform güncellemesinden sonra farklı sonuç verebilir.

Adım adım çözüm

  1. Ortamı tespit edin: uygulamanın çalıştığı sunucunun ve istemcinin kültürünü (CultureInfo.CurrentCulture, Java’da Locale.getDefault()) ve veritabanının harmanlamasını kaydedin.
  2. Sorunu yeniden üretin: aşağıdaki kısa testleri hem tr-TR hem en-US kültüründe çalıştırarak farkı görün.
  3. Metinleri sınıflandırın: kullanıcıya gösterilen ve dilbilimsel sıralanan metinler (ürün adı, unvan) kültüre duyarlı kalabilir; kimlik, e-posta, kullanıcı adı, dosya yolu, URL şeması, yapılandırma anahtarı, enum adı ve protokol değerleri kültürden bağımsız işlenmelidir.
  4. .NET’te karşılaştırmaları StringComparison.Ordinal veya StringComparison.OrdinalIgnoreCase ile yapın; sözlük ve kümelerde StringComparer.OrdinalIgnoreCase verin. Normalleştirme gerekiyorsa Microsoft’un önerisi ToLowerInvariant yerine ToUpperInvariant kullanmaktır.
  5. Java’da toLowerCase() ve toUpperCase() çağrılarını parametresiz bırakmayın; kültürden bağımsız metinler için toLowerCase(Locale.ROOT) kullanın.
  6. JavaScript’te toUpperCase() ve toLowerCase() Unicode’un varsayılan eşlemesini kullanır; Türkçe kurala göre dönüşüm isteniyorsa yerel ayarı açıkça verin (toLocaleUpperCase(“tr-TR”)), istenmiyorsa toLocale… yöntemlerini yerel ayarsız çağırmayın, çünkü sonuç tarayıcının diline bağlı olur.
  7. SQL Server’da kod içindeki tablo ve sütun adlarını, nesnenin oluşturulduğu harf biçimiyle birebir yazın. Belirli bir karşılaştırmada Türkçe kural istenmiyorsa sorguda COLLATE ile başka bir harmanlama belirtin.
  8. Düzeltmeden sonra testleri tr-TR kültüründe ve Turkish_CI_AS veritabanında tekrar çalıştırın.
// C#: sorunu görmek ve düzeltmek
CultureInfo.CurrentCulture = new CultureInfo("tr-TR");
Console.WriteLine("FILE".ToLower());          // fıle
Console.WriteLine("FILE".ToLowerInvariant()); // file

bool ayni = string.Equals(girilen, kayitli, StringComparison.OrdinalIgnoreCase);
string anahtar = eposta.Trim().ToUpperInvariant();
var ayarlar = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
// Java
"TITLE".toLowerCase(Locale.forLanguageTag("tr")); // tıtle
"TITLE".toLowerCase(Locale.ROOT);                 // title

// JavaScript
"FILE".toLocaleLowerCase("tr-TR");     // fıle
"istanbul".toLocaleUpperCase("tr-TR"); // İSTANBUL
"file".toUpperCase();                  // FILE
-- SQL Server: harmanlamayı ve davranışı kontrol etme (salt okuma)
SELECT SERVERPROPERTY('Collation') AS SunucuHarmanlamasi,
       DATABASEPROPERTYEX(DB_NAME(), 'Collation') AS VeritabaniHarmanlamasi;

SELECT CASE WHEN N'i' = N'I' COLLATE Turkish_CI_AS THEN 'esit' ELSE 'farkli' END; -- farkli
SELECT CASE WHEN N'i' = N'İ' COLLATE Turkish_CI_AS THEN 'esit' ELSE 'farkli' END; -- esit

-- Tek bir karşılaştırmada Türkçe kuralı devre dışı bırakma
SELECT * FROM dbo.Musteri
WHERE Eposta = @eposta COLLATE Latin1_General_100_CI_AS;

Veritabanı harmanlamasını ALTER DATABASE ile değiştirmek mevcut sütunların harmanlamasını değiştirmez; Microsoft bunu açıkça belirtir. ERP gibi hazır yazılımların veritabanlarında harmanlama değişikliği üretici desteği olmadan yapılmamalıdır.

Kalıcı önlem

  • E-posta ve kullanıcı adını kayıt anında kültürden bağımsız biçimde (örneğin ToUpperInvariant) normalleştirilmiş ayrı bir sütunda saklayın ve arama ile girişte yalnızca bu sütunu kullanın.
  • .NET projelerinde CA1307, CA1309 ve CA1310 kod analizi kurallarını açın; Microsoft bu kuralların istemeden kullanılan kültüre duyarlı karşılaştırmaları bulduğunu belirtir.
  • Java projelerinde parametresiz toLowerCase() ve toUpperCase() çağrılarını kod incelemesinde yasaklayın.
  • Birim testlerinizi en az bir kez tr-TR kültüründe çalıştırın; test verisine “FILE”, “Id”, “ISMAIL” gibi I içeren örnekler ekleyin.
  • Yeni veritabanlarında harmanlamayı kurulum varsayılanına bırakmayın; uygulamanın ihtiyacına göre bilinçli seçin ve belgeleyin.
  • SQL betiklerinde nesne adlarını her zaman oluşturuldukları biçimde yazın; ORM kullanıyorsanız ad eşlemesini açıkça tanımlayın.

Ne zaman uzman çağırmalı?

Sorun canlı bir ERP veya müşteri portalında giriş, fatura eşleştirme ya da entegrasyon gibi kritik akışları etkiliyorsa, harmanlama değişikliği veya toplu veri normalleştirmesi düşünüyorsanız ya da kaynak koduna erişiminiz sınırlıysa uzman desteği almak daha güvenlidir. Denizli’deki işletmelerde sahada karşılaştığımız bu tür sorunlarda Workas, özel yazılım geliştirme hizmeti kapsamında kod incelemesi, test senaryosu ve veritabanı tarafındaki düzeltmeyi birlikte planlayarak destek verir.

Sıkça Sorulan Sorular

Uygulamanın kültürünü en-US yapmak sorunu çözer mi?

Belirtiyi gizler ama kalıcı çözüm değildir; tarih, sayı ve sıralama gibi Türkçe gösterilmesi gereken bilgiler de bozulur. Doğrusu yalnızca kimlik ve anahtar karşılaştırmalarını ordinal/invariant yapmaktır.

Neden ToLowerInvariant yerine ToUpperInvariant önerilir?

Microsoft’un .NET metin karşılaştırma rehberi, karşılaştırma amacıyla normalleştirme yapılırken ToUpperInvariant kullanılmasını önerir. Mümkünse normalleştirme yerine doğrudan OrdinalIgnoreCase karşılaştırması tercih edilir.

Turkish_CI_AS harmanlamasını kullanmak yanlış mı?

Hayır. Türkçe metinlerin doğru sıralanması için gereklidir. Sorun, bu harmanlamanın kimlik ve anahtar gibi dilden bağımsız metinlere de uygulanmasından ve koddaki nesne adlarının farklı harf biçimiyle yazılmasından doğar.

Sorun sadece Windows’ta mı görülür?

Hayır. .NET, Java ve JavaScript tüm platformlarda Türkçe yerel ayara göre aynı dönüşüm kurallarını uygular; işletim sisteminden bağımsız olarak kültür veya yerel ayar Türkçe ise sorun ortaya çıkar.

Kaynaklar

  1. Microsoft Learn: Best practices for comparing strings in .NET
  2. Oracle Java SE 21 API: String (toLowerCase / toUpperCase)
  3. MDN: String.prototype.toLocaleUpperCase()
  4. Unicode Character Database: SpecialCasing.txt
  5. Microsoft Learn: Collation and Unicode support (SQL Server)

Hadi Başlayalım

Bizimle İşbirliği Yapın!

İşletmenizin BT ihtiyaçlarını birlikte planlayalım; size en uygun çözümü hızla sunalım.

x

Workas Yazılım Teknoloji, 2002'den bu yana Denizli'de işletmelere ERP, siber güvenlik, network, sunucu ve yedekleme, özel yazılım ve yapay zeka çözümleri sunar.

Adres
Kınıklı, Hüseyin Yılmaz Cd. No:67,
B Blok Z06, 20160 Pamukkale/Denizli
Bizimle İletişime Geçin
0549 669 99 06
0535 089 29 29
Çalışma Saatleri
Pzt - Cmt: 8.00 - 18.00