format Kullanımı (SA-MP NPC)
Değerleri biçimlendirerek sonucu bir string buffer’a yazar.
Kategori: NPC API
Sözdizimi
Bölüm başlığı “Sözdizimi”format(output[], len = sizeof output, const format[], {Float,_}:...);Parametreler
Bölüm başlığı “Parametreler”| Parametre | Açıklama |
|---|---|
output[] |
Verinin okunacağı veya yazılacağı output buffer’ı. |
len = sizeof output |
Hedef buffer’ın hücre cinsinden kapasitesi. |
const format[] |
Yer tutucular içerebilen biçim metni. |
{Float,_}:... |
Fonksiyona verilen {Float,_}:... değeri. |
Dönüş değeri
Bölüm başlığı “Dönüş değeri”Hedef buffer’a yazılan karakter sayısını döndürür. Bu değer başarı bayrağı değildir. Buffer kapasitesi yetersizse metin kesilebileceğinden dönüşü ve hedef boyutunu birlikte değerlendir.
Okunan değer return ile değil, output çıkış parametresi üzerinden alınır.
Kullanım örneği
Bölüm başlığı “Kullanım örneği”new message[96];format(message, sizeof message, "Oyuncu %d: %d puan", playerid, score);SendClientMessage(playerid, 0xFFFFFFFF, message);Fonksiyonun yazacağı output değişkenleri çağrıdan önce tanımlanır; sonuçlar çağrıdan sonra okunur.