strcoll(3)

strcoll3

Compare strings, according to current collation

Usage

#include <string.h>

int

strcoll(const char *s1, const char *s2);

#include <string.h>

#include <xlocale.h>

int

strcoll_l(const char *s1, const char *s2, locale_t loc);

Library

Standard C Library (libc, -lc)

Overview

The strcoll() function lexicographically compares the null-terminated strings s1 and s2 according to the current locale collation and returns an integer greater than, equal to, or less than 0, according as s1 is greater than, equal to, or less than s2. If information about the current locale collation is not available, the value of strcmp(s1, s2) is returned.

Although the strcoll() function uses the current locale, the strcoll_l() function may be passed a locale directly. See xlocale(3) for more information.

Releases

163 releases since Mac OS X 10.0; the text changed 4 times.

  1. 10.0–10.1.5
  2. 10.2–10.2.8
  3. 10.3–10.4.11
  4. 10.5–10.6.8
  5. 10.7–26.5

Standards

The strcoll() function conforms to ISO/IEC 9899:1990 (“ISO C90”).

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.