man3/wcslen.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" SPDX-License-Identifier: GPL-2.0-or-later
   4 .\"
   5 .\" References consulted:
   6 .\"   GNU glibc-2 source code and manual
   7 .\"   Dinkumware C library reference http://www.dinkumware.com/
   8 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
   9 .\"   ISO/IEC 9899:1999
  10 .\"
  11 .TH WCSLEN 3  2021-08-27 "Linux man-pages (unreleased)"
  12 .SH NAME
  13 wcslen \- determine the length of a wide-character string
  14 .SH LIBRARY
  15 Standard C library
  16 .RI ( libc ", " \-lc )
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wchar.h>
  20 .PP
  21 .BI "size_t wcslen(const wchar_t *" s );
  22 .fi
  23 .SH DESCRIPTION
  24 The
  25 .BR wcslen ()
  26 function is the wide-character equivalent
  27 of the
  28 .BR strlen (3)
  29 function.
  30 It determines the length of the wide-character string pointed to
  31 by
  32 .IR s ,
  33 excluding the terminating null wide character (L\(aq\e0\(aq).
  34 .SH RETURN VALUE
  35 The
  36 .BR wcslen ()
  37 function returns the
  38 number of wide characters in
  39 .IR s .
  40 .SH ATTRIBUTES
  41 For an explanation of the terms used in this section, see
  42 .BR attributes (7).
  43 .ad l
  44 .nh
  45 .TS
  46 allbox;
  47 lbx lb lb
  48 l l l.
  49 Interface       Attribute       Value
  50 T{
  51 .BR wcslen ()
  52 T}      Thread safety   MT-Safe
  53 .TE
  54 .hy
  55 .ad
  56 .sp 1
  57 .SH STANDARDS
  58 POSIX.1-2001, POSIX.1-2008, C99.
  59 .SH NOTES
  60 In cases where the input buffer may not contain
  61 a terminating null wide character,
  62 .BR wcsnlen (3)
  63 should be used instead.
  64 .SH SEE ALSO
  65 .BR strlen (3)