İçeriğe geç

Görev 7 — Fonksiyon atölyesi

Kazanacağın yetenek: Tekrarlanan kodu İngilizce adlandırılmış, girdisi ve çıktısı açık fonksiyonlara ayırmak.

Fonksiyon, adı olan ve tekrar çağrılabilen bir davranıştır. Bu derste görev ödülü verme kodunu tek yerde toplayacak; girdi, çıktı ve yan etki kavramlarını ayıracaksın.

SendClientMessage(playerid, 0xFFFFFFFF, "Gorev tamamlandi.");

Burada:

  • SendClientMessage çağrılan fonksiyon,
  • playerid, renk ve metin fonksiyona verilen argümanlar,
  • oyuncuya giden mesaj fonksiyonun yan etkisidir.

Her SA-MP fonksiyonunun parametre sırası, kabul ettiği tag’ler ve dönüş anlamı kendi referans sayfasında belirtilir.

bool:GiveMissionReward(playerid, amount)
{
if (!IsPlayerConnected(playerid) || amount <= 0)
{
return false;
}
PlayerData[playerid][playerScore] += amount;
GivePlayerMoney(playerid, amount);
return true;
}

Çağırırken sonucu kontrol et:

if (GiveMissionReward(playerid, 250))
{
SendClientMessage(playerid, 0x33CC33FF, "250 puan ve para kazandin.");
}

bool: dönüş tag’i bu fonksiyonun “başarılı mı?” sorusuna cevap verdiğini anlatır. Fonksiyon aynı zamanda oyuncu verisini ve oyun parasını değiştirdiği için yan etkiye de sahiptir.

Tek hücrelik normal bir parametrenin kopyası fonksiyona verilir:

DoubleValue(value)
{
value *= 2;
return value;
}
new originalValue = 5;
new result = DoubleValue(originalValue);
// originalValue is 5, result is 10.

Fonksiyon içindeki value değişse de dışarıdaki originalValue değişmez.

& ile tek hücreyi referans olarak geçirirsen fonksiyon dışarıdaki değeri değiştirebilir:

ResetValue(&value)
{
value = 0;
}

Diziler zaten referansla geçirilir. Fonksiyon diziyi değiştirmeyecekse const ile bunu açıkça belirt:

SendInfoMessage(playerid, const message[])
{
return SendClientMessage(playerid, 0xFFFFFFFF, message);
}

Bu hem niyeti belgeler hem de yanlışlıkla yazmayı derleyicinin yakalamasına yardım eder.

  • forward, fonksiyon gövdesi görülmeden önce imzasını bildirir.
  • public, fonksiyonun AMX dışından bulunup çağrılabilmesini sağlar.

Callback’ler ve timer ile çağrılacak fonksiyonlar genellikle public olur. Sıradan yardımcı fonksiyonları yalnızca “çalışsın” diye public yapma:

forward OnMissionExpired(playerid);
public OnMissionExpired(playerid)
{
PlayerData[playerid][isPlayerOnMission] = false;
return 1;
}

Bir fonksiyon yazmadan önce sor:

  1. Tek ve açık bir işi var mı?
  2. Gereken bilgi parametreyle mi geliyor, gizli bir global bağımlılık mı var?
  3. Başarısızlık dönüş değerinden anlaşılabiliyor mu?
  4. Verilen string veya diziyi değiştirmiyorsa const mu?
  5. Çağıran kod dönen sonucu gerçekten ele alıyor mu?

GiveMissionReward fonksiyonunun girdilerini, dönüş değerini ve yan etkilerini açıklayabiliyor; değerle ve referansla geçirilen parametreyi ayırt edebiliyorsan devam et.

Sonraki adım: callback yaşam döngüsü.