Bir Windows test makinesini Alman bölgesel ayarlarına alın, bir sayfanın başına ölçekle-kaydır matrix ekleyen bir yordam koşturun ve içerik akışını dökün. 0.5 0 0 0.25 0.00001 12.75 cm yerine 0,5 0 0 0,25 1E-5 12,75 cm alırsınız. Bir içerik ayrıştırıcısı bunu önce 0 sayısı olarak okur, sonra tanımadığı bir ,5 tokeni, sonra da cm'in beklediği altı operandla artık uyuşmayan sayılar olarak; sayfa, hiç istemediğiniz bir dönüşümle çizilir. Bir makinenin ayrıştıracağı sayıların sabit bir noktaya, üs olmamasına ve hiçbir şekilde FormatSettings'e bağımlı olmamasına ihtiyacı vardır; yazan tarafta da okuyan tarafta da
Virgüllü ondalık bir locale PDF sayılarını neden bozar?
Virgüllü ondalık bir locale PDF sayılarını bozar, çünkü Delphi'nin varsayılan float biçimlendirmesi masaüstünü izlerken PDF sayı sözdizimi sabittir. FloatToStr, FormatSettings.DecimalSeparator kullanır; yani de-DE, fr-FR ya da pt-BR bir makinede her kesir virgülle çıkar. ISO 32000-1 §7.3.3 bir sayıda rakamlara, tek bir noktaya ve baştaki işarete izin verir. Başkasına değil. Virgül bu yüzden bir sayıyı geçerli bir tamsayı artı çöp diye böler ve sonuç, doğru çizmesi gerekirken yanlış çizen bir sayfadır
İlk tuzağın arkasında ikincisi vardır ve ABD makinelerinde de ısırır. FloatToStr, büyüklük 1E-4'ün altına düştüğünde üs gösterimine geçen ffGeneral biçimini kullanır; minicik bir offset böylece 1E-5 olarak yazılır. Aynı §7.3.3, PDF'in üs biçimini desteklemediğini söyler. İkisini de render edilmiş çıktıdan geriye izlemek eziyettir; çünkü kaymış bir matrix, kendi kodunuzdaki bir yerleşim hatasına tam olarak benzer ve sayfada bölgesel ayarları işaret eden hiçbir şey yoktur
PDFlibPas, losLab PDF Developer Library for Delphi, AddPageMatrix'in operandlarını altı ondalıkla PLDoubleToStrConst üzerinden yazar ve sizin adınıza sayfa içeriği üreten çağrı noktaları aynı kuralı izler. Bildiğimiz en ucuz regresyon testi, ayracı sürecin içinde virgüle çevirir, API'yi çağırır ve sonucu virgül ile üs için tarar:
uses
System.SysUtils, PDFlibrary;
// Kendi denetiminiz, kütüphanenin parçası değil. Bilerek kaba:
// (Hello, world) Tj gibi metin dizeleri de virgül taşır; o yüzden
// yalnızca şekil çizen bir test sayfasında koşturun
function HasLocaleDamage(const Content: AnsiString): Boolean;
var
I: Integer;
begin
Result := False;
for I := 1 to Length(Content) do
begin
if Content[I] = ',' then
Exit(True);
if (Content[I] in ['E', 'e']) and (I > 1) and (I < Length(Content)) and
(Content[I - 1] in ['0'..'9']) and (Content[I + 1] in ['0'..'9', '-', '+']) then
Exit(True);
end;
end;
var
Lib: TPDFlib;
OldSeparator: Char;
Content: AnsiString;
begin
Lib := TPDFlib.Create;
try
Lib.SetPageDimensions(300, 200);
Lib.DrawBox(10, 10, 20, 20, 1);
OldSeparator := FormatSettings.DecimalSeparator;
try
FormatSettings.DecimalSeparator := ','; // Alman (de-DE) masaüstünü taklit et
Lib.AddPageMatrix(0.5, 0.25, 1E-5, 12.75);
Content := Lib.GetPageContentToString;
// Beklenen: 0.5 0 0 0.25 0.00001 12.75 cm
// FloatToStr üretirdi: 0,5 0 0 0,25 1E-5 12,75 cm
Writeln(Content);
if HasLocaleDamage(Content) then
Writeln('Locale leaked into the content stream');
finally
FormatSettings.DecimalSeparator := OldSeparator;
end;
finally
Lib.Free;
end;
end;
İşlem içinde FormatSettings.DecimalSeparator değiştirmek bir kestirmedir. İşletim sisteminden kendi TFormatSettings'ini kuran kodu çalıştırmaz; uygulamanız öyle yapıyorsa, gerçek Alman bölgesel ayarlarıyla kurulu bir CI ajanı daha dürüst bir testtir
İki tür sayı, iki yardımcı ailesi
PDFlibPas sayı yardımcılarını hedef kitleye göre ayırır: insanlara gösterilen metin localei izleyebilir, makine için yazılan hiçbir şey izlemez. PDFlibExtra.pas'taki PLFloatToStr ile PLStrToFloat, FloatToStr ve StrToFloat üzerinden ince sarmalayıcılardır ve bildirimlerinin yorumu yalnızca insan-okur metin için olduklarını söyler. Makine çıktısı (PDF, FDF, XFDF, JSON, XML, CSV) invariant aileden geçer: yazmak için PLDoubleToStrConst, okumak için PLTryStrToFloatInvariant ve kendi TryStrToFloat çağrılarınız için nokta ondalıklı bir TFormatSettings kaydı gerektiğinde PLInvariantFormatSettings
Hassasiyet küresel değil, işe göre seçilir. Matrixler altı ondalık, koordinatlar ile TJ ayarları dört, renkler ile FDF dikdörtgenleri üç alır. Makineye dönük taraf, API yüzeyinin gösterdiğinden daha çok yeri kapsar:
AddPageMatrix,ScalePageveDeskewPage; üçü de mevcut sayfa içeriğinin başına bircmekler- Sayfa elemanları üretilirken yazılan
Tmsıfırlamaları,TJilerlemeleri vecmdönüşümleri - Metin yola çevrilirken üretilen glyph yerleşim matrixleri ve hat noktaları
RedactRegion'un başına eklediği siyah doldurma kutusu, FDF dışa aktarmasındaki/Rectdeğerleri ve yeniden renklendirmenin yazdığı renk operandları
PLDoubleToStrConst elle yazılmış bir biçimlendiricidir ve sabit bir TFormatSettings ile FloatToStrF'i sarmalamak yerine bunun doğru karar olduğunu düşünüyoruz. ffFixed, tamsayı kısmı hassasiyeti aşınca bilimsel gösterime döner ve 0.5'in daha kısa ve özdeş olduğu yerde 0.500000 bırakırdı. Özel yordam daima nokta yazar, sondaki sıfırları kırpar ve sonlu girdi için asla üs yazmaz. İstenen hassasiyetten küçük sıfır olmayan bir değerin anlamlı basamaklarını da korur: PLDoubleToStrConst(1E-9, 6) çağrısı 0.000000001 döndürür ve kabaca 5E-16 altındaki değerler ancak 0 olur. Minicik bir ölçek faktörünü sıfıra yuvarlamak geçerli bir matrixi tekil hâle getirir; bu, yerinden oynanmış her ondalıktan daha kötü bir başarısızlıktır
Biçimlendiriciye karşı birim testi yazacaksanız örnek değerleri ikili kayan nokta düşünerek seçin. "Dört anlamlı basamak" için aşikâr seçim 0.000012345'tir ama o double 1E8 ile çarpılınca 1234.4999… çıkar; sonuç 0.00001234 olur ve iddia, localelerle hiç ilgisi olmayan bir nedenden başarısız olur. Orta noktadan açıkça uzakta duran bir değer, örneğin 0.000012346, tartışmayı kökünden kaldırır:
uses
PDFlibExtra;
// Assert çağrıları, kendi test projenize eklediğiniz denetimlerdir
procedure CheckNumberHelpers;
var
V: Double;
begin
// Makine çıktısı: nokta ondalık, üs yok, sondaki sıfırlar kırpılmış
Assert(PLDoubleToStrConst(1E-5, 6) = '0.00001');
Assert(PLDoubleToStrConst(-0.5, 6) = '-0.5');
Assert(PLDoubleToStrConst(0.000012346, 4) = '0.00001235'); // 4 anlamlı basamağı korur
Assert(PLDoubleToStrConst(12345.25, 4) = '12345.25');
// Makine girdisi: EConvertError yerine yumuşak başarısızlık
Assert(PLTryStrToFloatInvariant('0.5', V) and (V = 0.5));
Assert(PLTryStrToFloatInvariant(' 12.75 ', V) and (V = 12.75)); // girdi kırpılır
Assert(not PLTryStrToFloatInvariant('0,5', V)); // content sayıları asla virgül kullanmaz
end;
Ayrıştırma tarafı yazma tarafından neden daha tehlikeli?
Ayrıştırma tarafı daha tehlikelidir, çünkü localee bağlı bir ayrıştırıcı hafif yanlış bir sayı üretmez; fırlatır. StrToFloat, metin sistem ayracıyla uyuşmadığında EConvertError atar. Onun üzerine kurulu bir yeniden renklendirme geçişi, virgüllü ondalık bir makinede sıradan bir 0.5 g operatörüne vardığı anda durur; yani pratikte her gerçek sayfada başarısız demektir. "10.5,20.5,50.5,40.5" gibi bir clip dizgesi tümüyle reddedilir; SVG uzunlukları, SVG renkleri, annotation köşe listeleri ve output intent değerleri ya reddedilir ya sessizce varsayılanlarla değiştirilir. Bu, geliştirici makinesinde her testi geçen, Münih'teki ilk müşteride çöken koddur; kazara çalışan Delphi kodu yazısındaki durumlarla aynı ailedendir
Kütüphanedeki her StrToFloat tarzı çağrı, girdisinin nereden geldiğine göre sınıflanır. İçerik akışı operandları, SVG öznitelikleri, painter renk dizgileri ve virgülle ayrılmış clip ile köşe listelerinin sabit nokta sözdizimi vardır; hepsi PLTryStrToFloatInvariantdan geçer. O yardımcı metni kırpar, PLInvariantFormatSettings ile ayrıştırır ve boş, bozuk, NaN ya da sonsuz girdi için (değeri 0'a set ederek) False döndürür. Virgülle ayrılmış listelerde tartışılacak bir şey bile olmadı: virgül hem liste ayracı hem ondalık işareti olamaz, dolayısıyla uyumda kalınacak eski bir biçim yoktur
PDF'i tek renk uzayına çevirme rehberinde anlatılan yeniden renklendirme hattı için sonuç şudur: RecolorPage ile RecolorDocument sayfa içeriğini her localede aynı şekilde ayrıştırır. Çağıranın CheckDocumentPolicy'e yazdığı kural değerleri, hoşgörülü yolu izleyen tek ayrıştırma durumudur; çünkü o dizgeyi bir insan yazmıştır ve büyük olasılıkla yerel ondalık işaretini kullanmıştır
Dize üzerinden aktarılan bir sayı iki ucun anlaşmasını ister
Bir sayı, kodun bir bölümü tarafından bir dizgeye yazılıp başka bir bölümü tarafından geri okunduğunda, yazan ile okuyan aynı teammülü izlemek zorundadır; yalnızca birini değiştirmek gidiş-dönüşü bozar. Etiketli PDF yapı öznitelikleri tam olarak böyle çalışır. SetStructElemBBox dört değeri tek dizgeye biçimler ve AddTagAttribute üzerinden saklar. /A öznitelik sözlüğü yazıldığında, o dizge sayı mı, dizi mi, name mi olacağına karar verilmek için yeniden ayrıştırılır
İki uç da sistem localeini izleseydi, gidiş-dönüş Alman bir makinede kendi içinde tutarlı olurdu. Sıkıntı, belgeleri izleyip AddTagAttribute'e "0.5" geçiren bir çağırandan başlar: localee bağlı bir okuyucu onu ayrıştıramaz ve /0.5 PDF name'ini yayar. PDF/VCR yer tutucuları ayna görüntüye çarpar; çünkü onların GTS_BBox'u noktayla üretilir ve kaydetmeden önceki localee bağlı bir doğrulama adımı onu reddederdi. Yalnızca yazanı noktaya çevirmek işleri daha da bozar; çünkü virgüllü ondalık sistemlerde her SetStructElem* değeri sonra name'e dönüşür
Bu yüzden yazanlar PLDoubleToStrConst(v, 6) kullanır, okuyan ise PLTryStrToFloatLenient: önce nokta biçimini dener, sonra sistem localeine düşer. "1,25" geçiren virgül-localeli bir çağıran 1.25 sayısını alır. Bir maliyeti var ve bilerek kabul ettik: Alman bir sistemde "1.500" bin beş yüz değil 1.5 olarak okunur, çünkü nokta biçimi kazanır. API noktayı ayracı olarak belgeler; yani bir öznitelik dizgesinde Alman tarzı binlik gruplama, pes etmeyi seçtiğimiz girdidir. Sabit NAN ve INF dizgeleri sayı sayılmaz
uses
System.SysUtils, PDFlibrary;
var
Lib: TPDFlib;
begin
FormatSettings.DecimalSeparator := ','; // virgüllü ondalık çağıran
Lib := TPDFlib.Create;
try
Lib.BeginTag('Figure', 'Sales chart', '');
Lib.SetStructElemBBox(10.5, 20.25, 200.5, 100.75); // /BBox [ 10.5 20.25 200.5 100.75 ]
Lib.AddTagAttribute('Layout', 'SpaceAfter', '0.5'); // /SpaceAfter 0.5, /0.5 yerine
Lib.AddTagAttribute('Layout', 'StartIndent', '1,25'); // locale geri dönüşüyle /StartIndent 1.25
Lib.DrawText(20, 20, 'figure');
Lib.EndTag;
Lib.SaveToFile('tagged.pdf');
finally
Lib.Free;
end;
end;
Kendi kodunuz için önerimiz, AddTagAttribute'e nokta ondalıklı dizgeler geçirmeniz ve virgül geri dönüşünü denetleyemediğiniz değerlere bırakmanızdır; eski bir yapılandırma dosyasından yüklenen dizgeler gibi. O özniteliklerin çevresindeki yapı ağacının nasıl kurulduğu etiketli PDF yapı rehberinde işlenir
NaN ve sonsuzluk nerede durdurulur
AddPageMatrix, ScalePage ve RedactRegion, NaN ve sonsuz argümanları baştan reddeder ve 0 döndürür; çünkü hiçbir PDF sayısı ikisini de temsil edemez. Denetim açık olmalıdır. NaN bir <= 0 testinin yanından sıvışır; yani bir ölçek faktörü üzerindeki tek başına bir aralık denetimi, NaN bir ölçeğin biçimlendiriciye kadar yol almasına izin verirdi. NaN üzerinde Round çağırmak, x87 birimi geçersiz işlemleri varsayılan olarak maskelemediğinden Win32'de EInvalidOp fırlatır. PLDoubleToStrConst, NaN için son savunma hattı olarak 0 yazar; ama bir matrix içindeki sıfır tekil bir dönüşümdür ve sayfayı gerçekten koruyan denetim API düzeyindekidir. Kendi kodunuzda dönüş değerini test edin: ScalePage, hesapladığınız bir faktör için 0 döndürdüyse, her şeyden önce faktörü yazdırın; çünkü yukarı akıştaki bir 0/0 tam olarak bu NaN'ı üretir
İki sınır bilinçlidir. Metafile durum dizeleri tek bir sürecin içinde locale ile yazılır ve okunur, hiçbir dosyaya ulaşmaz; o yüzden localee bağlı kalırlar. Ve sayfa üretim yolu üzerinden küçük değerleri test ediyorsanız içeriği çağrının hemen ardından okuyun: sayfa içeriğini belgenin koordinat hassasiyetiyle sonradan yeniden yayan bir işlem, 1E-5'i meşru olarak 0'a çevirir; o yuvarlamadır, locale sızıntısı değil
Benimsenmeye değer alışkanlık kısadır. Uygulamanızın PDF üreten yollarını bir kez virgül ayracıyla koşturun, çıktıyı virgül ve üs için tarayın ve FloatToStr'u bir ayrıştırıcının okuyacağı her şeyin dışında tutun. Var olan bir dosyadan okunan sayılar ilgili bir kuralı izler; kesin kaynak metnin bir kayıt boyunca nasıl hayatta kaldığı ayrıştırılan ondalık hassasiyetini koruma yazısında işlenir. Deneme derlemeleri, API referansı ve lisanslama ayrıntıları PDFlibPas Delphi PDF library ürün sayfasındadır