---
name: "wcscoll"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/wcscoll"
---

# wcscoll(3)

compare wide strings according to current collation

## NAME

**wcscoll** – compare wide strings according to current collation

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

**#include \<wchar.h\>**

*int*\

**wcscoll**(*const wchar\_t \*s1*, *const wchar\_t \*s2*);

## DESCRIPTION

The **wcscoll**() function compares the null-terminated strings *s1* and *s2* according to the current locale collation order. In the “C” locale, **wcscoll**() is equivalent to **wcscmp**().

## RETURN VALUES

The **wcscoll**() function returns an integer greater than, equal to, or less than 0, if *s1* is greater than, equal to, or less than *s2*.

No return value is reserved to indicate errors; callers should set *errno* to 0 before calling **wcscoll**(). If it is non-zero upon return from **wcscoll**(), an error has occurred.

## ERRORS

The **wcscoll**() function will fail if:

- \[EILSEQ\]

  An invalid wide character code was specified.

- \[ENOMEM\]

  Cannot allocate enough memory for temporary buffers.

## SEE ALSO

[setlocale(3)](/setlocale/3.md), [strcoll(3)](/strcoll/3.md), [wcscmp(3)](/wcscmp/3.md), [wcsxfrm(3)](/wcsxfrm/3.md)

## STANDARDS

The **wcscoll**() function conforms to ISO/IEC 9899:1999 (“ISO C99”).

## BUGS

The current implementation of **wcscoll**() only works in single-byte LC\_CTYPE locales, and falls back to using **wcscmp**() in locales with extended character sets.