wcsncmp(3)

wcsncmp3

Compare two fixed-size wide-character strings

Usage

#include <wchar.h>

int wcsncmp(const wchar_t s1[], const wchar_t s2[], size_t n);

Library

Standard C library (libc, -lc)

Overview

The wcsncmp() function is the wide-character equivalent of the strncmp(3) function. It compares the wide-character string pointed to by s1 and the wide-character string pointed to by s2, but at most n wide characters from each string. In each string, the comparison extends only up to the first occurrence of a null wide character (L'\0'), if any.

Return value

The wcsncmp() function returns zero if the wide-character strings at s1 and s2, truncated to at most length n, are equal. It returns an integer greater than zero if at the first differing position i (i < n), the corresponding wide-character s1[i] is greater than s2[i]. It returns an integer less than zero if at the first differing position i (i < n), the corresponding wide-character s1[i] is less than s2[i].

Attributes

For an explanation of the terms used in this section, see attributes(7).

InterfaceAttributeValue
wcsncmp()Thread safetyMT-Safe

Releases

14 releases since Debian 2.2 (Potato); the text changed 13 times.

  1. 2.2
  2. 3.0
  3. 3.1
  4. 4.0
  5. 5.0
  6. 6.0
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. Arch

Standards

C11, POSIX.1-2008.

History

POSIX.1-2001, C99.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.