21-11-2026, 10:01
warning 209: function should return a value#1
Kısa özet: warning 209: function should return a value, bir fonksiyonun bazı yollardan değer döndürüp bazılarından döndürmemesi durumunda çıkar. Komut ve olay fonksiyonlarında dönüş değeri davranışı belirler: PLUGIN_CONTINUE diğer eklentilerin ve oyunun komutu işlemesine izin verir, PLUGIN_HANDLED komutu burada bitirir (örneğin sohbete yazılan /vip herkese görünmez). Dönüş unutulursa davranış belirsizleşir; fonksiyonun tüm yollarının sonuna uygun return ekleyin.
Uyarı ne diyor?
Bir fonksiyonun bazı yollardan değer döndürüp bazı yollardan döndürmemesi bu uyarıya yol açar. Eklenti derlenir ama davranış belirsizleşebilir.
Örnek
KOD
public komut_vip(id) {
if (!(get_user_flags(id) & ADMIN_LEVEL_H))
return PLUGIN_HANDLED;
client_print(id, print_chat, "VIP menusu acildi");
// burada return eksik
}İlk yolda değer döndürülüyor ama ikinci yolda dönüş yok; derleyici bunu uyarır.
Neden önemli?
Komut ve olay fonksiyonlarında dönüş değeri davranışı belirler:
- PLUGIN_CONTINUE: diğer eklentiler ve oyun da komutu işlemeye devam eder.
- PLUGIN_HANDLED: komut burada biter; örneğin sohbete yazılan /vip herkese görünmez.
Dönüş değeri unutulursa davranış belirsizleşir ve komutun sohbette görünmesi ya da görünmemesi tutarsız olur.
Çözüm
Fonksiyonun sonuna uygun dönüşü ekleyin:
KOD
return PLUGIN_HANDLED;
}Her koşul yolunun bir değer döndürdüğünden emin olun.
Say komutlarında
Say komutlarında yazının sohbette görünmesini istemiyorsanız PLUGIN_HANDLED, görünmesini istiyorsanız PLUGIN_CONTINUE döndürün. Yanlış seçim komutların sohbeti doldurmasına ya da başka eklentilerin komutu işlememesine yol açar.
Diğer fonksiyonlar
Değer döndürmesi beklenen yardımcı fonksiyonlarda da (hesaplama, kontrol) tüm yolların değer döndürmesi gerekir. Uyarı genellikle uzun if-else zincirlerinde unutulan bir dalı gösterir.
Önleme
Yeni bir fonksiyon yazarken önce dönüş türünü ve değerini düşünün; fonksiyonun sonuna varsayılan bir return ekleyin. Uyarıları sıfırda tutmak, bu tür unutkanlıkları baştan yakalar.
Sık yapılan hatalar
- Dönüş değerini unutmak.
- PLUGIN_HANDLED/CONTINUE farkını bilmemek.
- Uyarıyı görmezden gelmek.
- if-else dallarını eksik bırakmak.
- Komutun sohbette görünmesini düşünmemek.
Sık sorulan sorular
HANDLED ne yapar? Komutu burada bitirir.
CONTINUE ne yapar? Diğer eklentilerin de işlemesine izin verir.
Uyarı neden? Bazı yollardan değer dönmüyor.
Örnek senaryo
VIP komutunuz bazen sohbette görünüyor bazen görünmüyor. warning 209'u fark edip fonksiyonun sonuna return PLUGIN_HANDLED ekleyince davranış tutarlı hâle geliyor.
Kontrol listesi
- Tüm yollar değer döndürüyor mu?
- Doğru değer mi?
- Komut sohbette nasıl görünüyor?
- Uyarılar sıfır mı?
- Test edildi mi?
Ek ipucu
Komut fonksiyonlarınız için küçük bir şablon (kontrol, işlem, return) belirleyin; her yeni komutta aynı kalıbı kullanmak bu tür unutkanlıkları tamamen ortadan kaldırır. Değişiklikleri önce test ortamında deneyin, çalışan son hâli yedekte tutun ve sonuçları bir not dosyasına yazın. Küçük adımlarla ilerleyip her adımda sonucu doğrulamak, hataları bulmayı ve geri dönmeyi çok kolaylaştırır.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.