İçeriğe geç

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 parametresi params[1] içinde metnin kendisi olarak gelmez; AMX belleğindeki adresi gelir. Güvenli okuma sırası şöyledir:

  1. amx_GetAddr ile fiziksel adrese ulaş.
  2. amx_StrLen ile uzunluğu öğren.
  3. null karakteri için bir byte daha ayır.
  4. amx_GetString ile 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.

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.

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.

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.

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.

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);
  • Adres kullanmadan önce amx_GetAddr sonucunu kontrol et.
  • String kapasitesine null karakterini dahil et.
  • Kullanıcı metnini doğrudan format string yapma.
  • Float için yalnızca amx_ctof ve amx_ftoc kullan.
  • 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.