vfprintf() fonksiyonu

Bildirim

Açıklama

Arg parametresi ile gösterilen değişken argüman listesinden aldığı değerleri format parametresi ile gösterilen karakter dizisi içinde düzenleyerek sonuçları stream parametresi ile gösterilen dosya akışına yazar.

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, arg parametresi ile gösterilen değerler listesinden sıra ile değer okuyarak format karakter dizisini dosya akışına yazar.

fprintf() fonksiyonunda format tanımlayıcılarına değer okutmak için format parametresinden sonra gelen ek parametreler kullanılırken vfprintf() fonksiyonunda arg parametre listesinde yer alan değişken adresleri kullanılmaktadır.

Her durumda, arg parametre değerine vfprintf() fonksiyonu kullanılmadan önce va_start() fonksiyonu tarafından bir ilk değer verilmiş olmalı ve fonksiyon kullanımından sonra ise va_end() fonksiyonu tarafından serbest bırakılmalıdır.

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

Fonksiyon çalışmaya başladığında, önce kontrol dizisi içinde yer alan ilk karaktere bakar. Eğer normal bir karakter ise hemen dosya akışına yazar. Eğer bir format tanımlayıcısı ise, bu format tanımlayıcısına karşılık gelen arg parametresi ile gösterilen listedeki ilk argüman değerini dosya akışına 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 dosya akışına nasıl yazılacağını belirler. vprintf() fonksiyonu format tanımlayıcıları ile karşılaştığında dosya akışına farklı bir veri yazacağını ve bu verinin vprintf() fonksiyonu çağrılırken karakter dizisinden sonra tanımlanmış olan arg liste değerlerinden sıra ile alınacağını anlar.

Vfprintf_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

stream: Karakter dizisinin yazılacağı akışı tanımlayan FILE nesnesi işaretçisidir.

format: Dosya akışına yazdırılacak olan bir karakter dizisidir.

Bu karakter dizisi dosya akışına yazılacak olan metni içerir. Karakter dizisi içinde normal karakterler veya % karakteri ile başlayan ve format karakter dizisinden sonra gelen arg parametresi ile gösterilen listedeki değerlerle sıra 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.

arg : va_start() ile ilk değer verilen değerler listesini tanımlayan bir değerdir.

Dönüş değeri

Vfprintf() fonksiyonu dosya çıkışına yazılan karakter sayısını int bir değer olarak geri döndürür. Bir hata meydana gelirse, negatif bir sayı geri döndürür.

Vfprintf_s() fonksiyonu dosya çıkışına yazılan karakter sayısını int bir değer olarak geri döndürür. Eğer bir çıkış hatası, 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>
#include <stdarg.h>
#include <stdlib.h>

void ArgList(int write, FILE *stream, const char * format, ...);

int main(void)
{
    FILE *fp;
    char cd;
    int id;
    float fd;
    char cdizi[20];

    /* Dosyayı oluşturma ve yazma için açma */
    if ((fp = fopen ("dosya.txt", "w+")) == NULL) {
         printf("Dosya açma hatası!");
         exit(1);
    }

    /* Dosyaya yazma işlemi */
    ArgList(1, fp, "%c %d %.2f %s", 'K', 54, 415.75, "Bilgisayar");

    rewind(fp);

    /* Dosyadan okuma işlemi */
    ArgList(0, fp, "%c %d %f %s", &cd, &id, &fd, cdizi);
    printf("Dosyadan okunan değerler: %c %d %.2f %s", cd, id, fd, cdizi);

    fclose(fp);

    return 0;
}

void ArgList(int write, FILE *stream, const char *format, ...)
{
  va_list args;
  va_start (args, format);
  if (write) vfprintf (stream, format, args);
  else vfscanf (stream, format, args);
  va_end (args);
}

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

Dosyadan okunan değerler: K 54 415.75 Bilgisayar

Program birer adet char, int, float ve karakter dizisi değeri oluşturur. Yazma ve okuma modunda bir dosya oluşturularak açılır. Değerlere karşılık gelen format tanımlayıcılarını içeren bir karakter dizisi ile farklı değerleri kullanarak ArgList() fonksiyonunu dosyaya yazma amacıyla çağırır. Fonksiyon içinde va_start() ile oluşturulan argüman listesi ve format parametre değeri ile vfprintf() fonksiyonu çağrılarak dosyaya yazma işlemi yapılır. Daha sonra aynı işlemler vfscanf() fonksiyonu ile dosyadan okuma amacıyla yapılır. Dosyadan okunan değerler ekrana yazılır.