SA-MP Pluginlerde String, Float ve Dizi Kullanımı
Integer parametreler doğrudan params dizisinden okunabilir. String, Float, referans ve dizilerde ise Pawn’ın bellek modeline uygun dönüşüm gerekir. Yanlış cast bazen yalnızca hatalı değer üretir, bazen bütün SA-MP sunucusunu kapatır.
Bu bölümde her veri türünü ayrı bir native ile işleyeceğiz.
Pawn string değerini C++ string’e çevir
Bölüm başlığı “Pawn string değerini C++ string’e çevir”Pawn string parametresi params[1] içinde metnin kendisi olarak gelmez; AMX belleğindeki adresi gelir. Güvenli okuma sırası şöyledir:
amx_GetAddrile fiziksel adrese ulaş.amx_StrLenile uzunluğu öğren.- null karakteri için bir byte daha ayır.
amx_GetStringile veriyi kopyala.
#include <string>#include <vector>
bool ReadPawnString(AMX* amx, cell amxAddress, std::string& output){ cell* physicalAddress = nullptr; if (amx_GetAddr(amx, amxAddress, &physicalAddress) != AMX_ERR_NONE) { return false; }
int length = 0; if (amx_StrLen(physicalAddress, &length) != AMX_ERR_NONE || length < 0) { return false; }
std::vector<char> buffer(static_cast<std::size_t>(length) + 1); if (amx_GetString(buffer.data(), physicalAddress, 0, buffer.size()) != AMX_ERR_NONE) { return false; }
output.assign(buffer.data(), static_cast<std::size_t>(length)); return true;}Bu yardımcıyı log native’inde kullan:
cell AMX_NATIVE_CALL Plugin_Log(AMX* amx, cell* params){ if (!HasParams(params, 1)) { return 0; }
std::string message; if (!ReadPawnString(amx, params[1], message)) { return 0; }
logprintf("[starter] %s", message.c_str()); return 1;}logprintf(message.c_str()) yazma. Oyuncudan gelen metindeki %s veya %n gibi karakterler format string olarak yorumlanabilir. Sabit format ve ayrı %s parametresi kullan.
Pawn string buffer’ına değer yaz
Bölüm başlığı “Pawn string buffer’ına değer yaz”String döndürmek için Pawn tarafı hedef dizi ve kapasitesini gönderir:
native Plugin_GetStatus(output[], size);C++ tarafı adresi çözer ve amx_SetString kullanır:
cell AMX_NATIVE_CALL Plugin_GetStatus(AMX* amx, cell* params){ if (!HasParams(params, 2) || params[2] <= 0) { return 0; }
cell* output = nullptr; if (amx_GetAddr(amx, params[1], &output) != AMX_ERR_NONE) { return 0; }
const char* status = "ready"; const int error = amx_SetString( output, status, 0, 0, static_cast<std::size_t>(params[2]) );
return error == AMX_ERR_NONE ? 1 : 0;}Pawn kullanımı:
new status[16];
if (Plugin_GetStatus(status, sizeof status)){ printf("Plugin status: %s", status);}Kapasiteyi C++ tarafında tahmin etme. Pawn’dan gelen size değerini doğrula ve amx_SetString sınırı olarak kullan.
Float değerini doğru dönüştür
Bölüm başlığı “Float değerini doğru dönüştür”Pawn Float: değerini yine bir cell içinde, float’ın bit düzenini koruyarak saklar. static_cast<float>(params[1]) sayısal cast yaptığı için yanlıştır.
- Pawn’dan C++’a:
amx_ctof - C++’tan Pawn’a:
amx_ftoc
cell AMX_NATIVE_CALL Plugin_Square(AMX*, cell* params){ if (!HasParams(params, 1)) { return amx_ftoc(0.0F); }
const float value = amx_ctof(params[1]); return amx_ftoc(value * value);}Pawn bildirimi ve kullanımında Float: etiketi bulunmalıdır:
native Float:Plugin_Square(Float:value);
new Float:result = Plugin_Square(4.5);printf("Result: %.2f", result);Burada native’in C++ dönüş türü hâlâ cell’dir. amx_ftoc, float’ın bitlerini Pawn’ın beklediği hücre biçiminde korur.
Referans parametresine değer yaz
Bölüm başlığı “Referans parametresine değer yaz”Pawn’daki & parametresi, pluginin çağıranın değişkenini güncellemesini sağlar:
native Plugin_GetMetrics(&playerCount, &Float:loadFactor);cell AMX_NATIVE_CALL Plugin_GetMetrics(AMX* amx, cell* params){ if (!HasParams(params, 2)) { return 0; }
cell* playerCount = nullptr; cell* loadFactor = nullptr;
if (amx_GetAddr(amx, params[1], &playerCount) != AMX_ERR_NONE || amx_GetAddr(amx, params[2], &loadFactor) != AMX_ERR_NONE) { return 0; }
*playerCount = 42; *loadFactor = amx_ftoc(0.75F); return 1;}Başarı değeri 1, iki output değişkeninin de yazıldığını ifade eder. Herhangi bir adres çözülemezse hiçbir pointer’ı dereference etme.
Pawn dizisini oku veya değiştir
Bölüm başlığı “Pawn dizisini oku veya değiştir”Dizi parametresi de ilk elemana ait AMX adresidir. C++ tarafı dizinin gerçek kapasitesini kendiliğinden bilemez; boyut ayrıca gönderilmelidir.
native Plugin_FillSequence(values[], size);cell AMX_NATIVE_CALL Plugin_FillSequence(AMX* amx, cell* params){ if (!HasParams(params, 2)) { return 0; }
const cell size = params[2]; if (size <= 0 || size > 4096) { return 0; }
cell* values = nullptr; if (amx_GetAddr(amx, params[1], &values) != AMX_ERR_NONE) { return 0; }
for (cell index = 0; index < size; ++index) { values[index] = index + 1; }
return 1;}Üst sınır, hatalı veya kötü niyetli bir çağrının uzun süre sunucu thread’ini meşgul etmesini önler. Gerçek sınırı pluginin kullanım alanına göre belirle.
Kayıt listesi ve include dosyası
Bölüm başlığı “Kayıt listesi ve include dosyası”Yeni fonksiyonların tamamını pluginNatives dizisine ve starter.inc dosyasına ekle. C++ uygulaması ile Pawn bildirimi aynı sırayı ve tür sözleşmesini kullanmalıdır:
native Plugin_Log(const message[]);native Plugin_GetStatus(output[], size);native Float:Plugin_Square(Float:value);native Plugin_GetMetrics(&playerCount, &Float:loadFactor);native Plugin_FillSequence(values[], size);Güvenli AMX veri kontrol listesi
Bölüm başlığı “Güvenli AMX veri kontrol listesi”- Adres kullanmadan önce
amx_GetAddrsonucunu kontrol et. - String kapasitesine null karakterini dahil et.
- Kullanıcı metnini doğrudan format string yapma.
- Float için yalnızca
amx_ctofveamx_ftockullan. - Dizi boyutunu Pawn’dan al, negatif ve aşırı değerleri reddet.
- Başarıdan önce bütün output adreslerinin geçerli olduğunu doğrula.
Sıradaki adım: C++ pluginden Pawn callback’i çağır.