İçeriğe geç

format Kullanımı (SA-MP NPC)

Değerleri biçimlendirerek sonucu bir string buffer’a yazar.

Kategori: NPC API

format(output[], len = sizeof output, const format[], {Float,_}:...);
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.

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.

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.