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.
Fonksiyon çağrısını oku
Bölüm başlığı “Fonksiyon çağrısını oku”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.
Kendi fonksiyonunu tanımla
Bölüm başlığı “Kendi fonksiyonunu tanımla”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.
Parametreler varsayılan olarak değerle geçer
Bölüm başlığı “Parametreler varsayılan olarak değerle geçer”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.
Referans ve const
Bölüm başlığı “Referans ve const”& 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 ve public aynı şey değildir
Bölüm başlığı “forward ve public aynı şey değildir”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;}Fonksiyon tasarım kontrol listesi
Bölüm başlığı “Fonksiyon tasarım kontrol listesi”Bir fonksiyon yazmadan önce sor:
- Tek ve açık bir işi var mı?
- Gereken bilgi parametreyle mi geliyor, gizli bir global bağımlılık mı var?
- Başarısızlık dönüş değerinden anlaşılabiliyor mu?
- Verilen string veya diziyi değiştirmiyorsa
constmu? - Çağıran kod dönen sonucu gerçekten ele alıyor mu?
Kontrol noktası
Bölüm başlığı “Kontrol noktası”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ü.