snprintf() fonksiyonu

Bildirim

Açıklama

Bir karakter dizisi içinde format tanımlayıcıları ile tanımlanan değerleri boyutu bufsz parametresi ile tanımlanan bir karakter dizisi içine yazar.

En fazla bufsz-1 kadar karakter yazılır. Sonuçta ortaya çıkan karakter dizisi, bufsz sıfır olmadıkça boş bir karakterle ('\0') sonlandırılır. Eğer bufsz sıfır ise, hiçbir şey yazılmaz ve buffer NULL bir işaretçi olabilir, ancak dönüş değeri hesaplanarak geri döndürülür.

Format parametresi ile gösterilen karakter dizisi içinde yer alan karakterleri normal bir şekilde, % işareti ile başlayan format tanımlayıcılarını ise tanımlanan her bir format tanımlayıcı için, format parametresinden sonra yer alan parametrelerden sıra ile değer okuyarak format karakter dizisini buffer parametresi ile gösterilen karakter dizisine yazar.

Format parametresinde yer alan karakter dizisi buffer parametre dizi genişliğini aşarsa belirsiz sonuçlar yaratabilir.

int snprintf (char buffer, size_t bufsz, const char *format, par1, par2, ...);

Kontrol dizisinin içinde hem normal karakterler hem de % işareti ile başlayan format tanımlayıcıları adı verilen ifadeler yer alabilir. snprintf() fonksiyonu " " işaretleri arasında yer alan normal karakterleri sıra ile ekrana yazar. Kontrol dizisi içinde yer alan her bir format tanımlayıcısı için par ifadesi ile gösterilen bir değer tanımlanır. Ancak, burada dikkat edilmesi gereken 2 önemli nokta vardır:

par ifadesi ile gösterilen argümanlar bir değişken, sabit, ifade veya bir fonksiyon çağrısı olabilir.

Fonksiyon çalışmaya başladığında, önce kontrol dizisi içinde yer alan ilk karaktere bakar. Eğer normal bir karakter ise hemen ekrana yazar. Eğer bir format tanımlayıcısı ise, bu format tanımlayıcısına karşılık gelen ilk argüman değerini ekrana yazar. Kontrol dizisi içindeki bütün karakterleri sıra ile bu şekilde kontrol edip işlem yaptıktan sonra çalışması sona erer.

Format tanımlayıcıları kendilerine karşılık gelen argümanların ekrana nasıl yazılacağını belirler. snprintf() fonksiyonu format tanımlayıcıları ile karşılaştığında ekrana farklı bir veri yazacağını ve bu verinin snprintf() fonksiyonu çağrılırken karakter dizisinden sonra tanımlanmış olan argüman değerlerinden sıra ile alınacağını anlar.

Snprintf_s() fonksiyonu aynı işlemleri yapar. Farklı olarak, çalışma zamanında aşağıdaki hatalar tespit edildiğinde, yüklenmiş olan kısıtlayıcı işlem fonksiyonu çağrılır:

Parametreler

buffer: Format parametresinde oluşturulan karakter dizisinin yazdırılacağı karakter dizisidir.

bufsz: Buffer parametresine yazdırılabilecek maksimum karakter sayısını gösterir (boş sonlandırıcı karakter dahil).

format: Buffer parametresine yazdırılacak olan bir karakter dizisidir.

Bu karakter dizisi stdout'a yazılacak olan metni içerir. Karakter dizisi içinde normal karakterler veya % karakteri ile başlayan ve format karakter dizisinden sonra gelen parametreler ile doldurulacak olan format tanımlayıcıları yer alabilir.

Format tanımlayıcı genel yapısı :

%[göstergeler][genişlik][.hassasiyet][uzunluk]format tanımlayıcısı

Bir format tanımlayıcısı toplam 6 farklı ifadeden oluşmaktadır. En baştaki % işareti ile en sonda yer alan format tanımlayıcı harfi mutlaka kullanılmalıdır. [] işaretleri arasında yer alan diğer dört ifade isteğe bağlı olarak kullanılır.

uzunluk : İsteğe bağlı olarak tanımlanan bu değer okutulacak argümanın boyutunu gösterir. hh, h, l, ll, j, z, t, L değerlerinden biri kullanıldığında, karşılık gelen argümanın gösterdiği veri tipini değiştirir.

... : Format parametresi ile gösterilen karakter dizisinde yer alan ve % karakteri ile başlayan her bir format tanımlayıcı için, format karakter dizisinden sonra bir parametre tanımlanması gerekir.

Dönüş değeri

Snprintf() fonksiyonu buffer parametresine yazılan karakter sayısını int bir değer olarak geri döndürür (sonda yer alan boş karakter hariç ('\0')). Karakter dizisi ve karakter format tanımlayıcılarında bir kodlama hatası meydana gelirse, negatif bir sayı geri döndürür.

Snprintf_s() fonksiyonu buffer parametresine yazılan karakter sayısını int bir değer olarak geri döndürür (sonda yer alan boş karakter hariç ('\0')). Eğer bir çalışma zamanı kısıt ihlal hatası veya bir kodlama hatası oluşursa negatif bir sayı geri döndürür.

Örnek

#include <stdio.h>

int main(void)
{
    int id = 36;
    float fd = 121.45;
    char cdizi[] = "C Programlama Dili";
    char buffer[100];

    snprintf(buffer, 100, "%d %.2f %s\n", id, fd, cdizi);

    printf("Oluşturulan karakter dizisi: %s", buffer);

    return 0;
}

Yukarıdaki örnekte, program aşağıdaki satırı ekrana yazar:

Oluşturulan karakter dizisi: 36 121.45 C Programlama Dili

Program, snprintf() fonksiyonu ile birer adet int ve float değer ile ve bir karakter dizisini tek bir karakter dizisi altında toplayarak ekrana yazar.