strcoll() fonksiyonu

Bildirim

int strcoll(const char *str1, const char *str2);

Açıklama

Str1 parametresi ile gösterilen karakter dizisini str2 parametresi ile gösterilen karakter dizisi ile, seçili C yerel ayarının LC_COLLATE kategorisine göre uygun olarak, karşılaştırır. Eğer her iki karakter dizisindeki tüm karakterler aynı ise sıfır değeri, aksi takdirde sıfırdan farklı bir değer geri döndürür.

Fonksiyon str1 ve str2 parametreleri ile gösterilen karakter dizilerini ilk karakterden itibaren karşılaştırmaya başlar. Birbirlerine eşitse, karakterler farklı olana veya karakter dizisinin sonunu gösteren boş bir karakterle karşılaşana kadar karşılaştırma işlemine devam eder.

Parametreler

str1: Karşılaştırma yapılacak ilk karakter dizisinin başlangıcını gösteren bir işaretçidir.

str2: Karşılaştırma yapılacak ikinci karakter dizisinin başlangıcını gösteren bir işaretçidir.

Dönüş değeri

Dönüş değeri;

<0 ise str1 bellek içeriği str2 bellek içeriğinden küçüktür.
>0 ise str2 bellek içeriği str1 bellek içeriğinden küçüktür.
=0 ise str1 bellek içeriği str2 bellek içeriğine eşittir.

Örnek


#include <stdio.h>
#include <string.h>

int main(void)
{
    const char *cp1 = "Bilgisayar";
    const char *cp2 = "Bilgileri";
    int ret;

    ret = strcoll(cp1, cp2);

    if(ret<0) printf("cp1 karakter dizisi cp2 karakter dizisinden küçüktür!");
    else if(ret>0) printf("cp2 karakter dizisi cp1 karakter dizisinden küçüktür!");
    else printf("cp1 karakter dizisi cp2 karakter dizisine eşittir!");

    return 0;
}

Yukarıdaki örnekte, program aşağıdaki satırı ekrana yazar.

cp2 karakter dizisi cp1 karakter dizisinden küçüktür!

Program strcoll() fonksiyonu ile iki karakter dizisini karşılaştırarak elde ettiği sonucu ekrana yazar.