CListBox::AddString Fonksiyonu
Fonksiyon yazıyı ekler ve eklediği yerin index numarasına geri döner.
Bütün fonksiyonlar başarısızlık durumunda LIST BOX_ERR ya da LIST BOX_ERRSPACE değerine geri döner. Geri dönüş değerinin kontrol edilmesine gerek yoktur.
Anahtar Notlar (Fonksiyon başarısının kontrolü) : Fonksiyon başarısının test edilme gerekliliğine göre fonksiyonları üç bölüme ayırabiliriz:
1) Başarı kontrolünün kesinlikle gerektiği fonksiyonlar. Bu tür fonksiyonların başarısı kesinlikle her çağrıldığında test edilmelidir. Bu tür fonksiyonların başarısız olma olasılıkları hem fazladır hem de programcının dışındaki faktörlere bağlı olabilir. Örneğin fopen ve malloc fonksiyonlarında olduğu gibi.
2) Başarısının testine gerek olmayan ancak problemli bir durumla karşılaşıldığında şüphe üzerine test edilmesi gereken fonksiyonlar. Bu tür fonksiyonlarda başarısızlık olasılığı çok düşüktür. Programcı normal bir kodlama yapmışsa neredeyse imkansızdır. Ya da fonksiyon başarısız olduğunda programcının yapabileceği bir şey yoktur. Örneğin fclose fonksiyonunun SetWindowText API fonksiyonunun geri dönüş değerlerini kontrol etmeye gerek yoktur.
3) Programın debug ve release versiyonları oluşturulacak bir biçimde kodlama yapılıyorsa bazı fonksiyonların başarıları yalnızca debug versiyonunda kontrol edilebilir. Bu tür fonksiyonlar özellikle birinci be ikinci grup arasında kalan fonksiyonlar olabilir. Örneğin CreateWindow fonksiyonu gibi.
