1WCSLEN(3P)                 POSIX Programmer's Manual                WCSLEN(3P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       wcslen, wcsnlen — get length of a fixed-sized wide-character string
13

SYNOPSIS

15       #include <wchar.h>
16
17       size_t wcslen(const wchar_t *ws);
18       size_t wcsnlen(const wchar_t *ws, size_t maxlen);
19

DESCRIPTION

21       For wcslen(): The functionality described on  this  reference  page  is
22       aligned  with the ISO C standard. Any conflict between the requirements
23       described here and the ISO C standard is unintentional. This volume  of
24       POSIX.1‐2017 defers to the ISO C standard.
25
26       The  wcslen() function shall compute the number of wide-character codes
27       in the wide-character string to which ws points, not including the ter‐
28       minating null wide-character code.
29
30       The  wcsnlen() function shall compute the smaller of the number of wide
31       characters in the array to which ws points, not including any terminat‐
32       ing  null  wide-character code, and the value of maxlen.  The wcsnlen()
33       function shall never examine more than the first maxlen  characters  of
34       the wide-character array pointed to by ws.
35

RETURN VALUE

37       The wcslen() function shall return the length of ws.
38
39       The  wcsnlen() function shall return the number of wide characters pre‐
40       ceding the first null wide-character code in  the  array  to  which  ws
41       points,  if  ws  contains  a  null wide-character code within the first
42       maxlen wide characters; otherwise, it shall return maxlen.
43
44       No return values are reserved to indicate an error.
45

ERRORS

47       No errors are defined.
48
49       The following sections are informative.
50

EXAMPLES

52       None.
53

APPLICATION USAGE

55       None.
56

RATIONALE

58       None.
59

FUTURE DIRECTIONS

61       None.
62

SEE ALSO

64       strlen()
65
66       The Base Definitions volume of POSIX.1‐2017, <wchar.h>
67

69       Portions of this text are reprinted and reproduced in  electronic  form
70       from  IEEE Std 1003.1-2017, Standard for Information Technology -- Por‐
71       table Operating System Interface (POSIX), The Open Group Base  Specifi‐
72       cations  Issue  7, 2018 Edition, Copyright (C) 2018 by the Institute of
73       Electrical and Electronics Engineers, Inc and The Open Group.   In  the
74       event of any discrepancy between this version and the original IEEE and
75       The Open Group Standard, the original IEEE and The Open Group  Standard
76       is  the  referee document. The original Standard can be obtained online
77       at http://www.opengroup.org/unix/online.html .
78
79       Any typographical or formatting errors that appear  in  this  page  are
80       most likely to have been introduced during the conversion of the source
81       files to man page format. To report such errors,  see  https://www.ker‐
82       nel.org/doc/man-pages/reporting_bugs.html .
83
84
85
86IEEE/The Open Group                  2017                           WCSLEN(3P)
Impressum