home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | VERSIONS | CONFORMING TO | SEE ALSO | COLOPHONThe Linux Programming Interface


WCSNLEN(3)                    Linux Programmer's Manual                    WCSNLEN(3)

NAME         top

       wcsnlen - determine the length of a fixed-size wide-character string

SYNOPSIS         top

       #include <wchar.h>

       size_t wcsnlen(const wchar_t *s, size_t maxlen);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       wcsnlen():
           Since glibc 2.10:
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Before glibc 2.10:
               _GNU_SOURCE

DESCRIPTION         top

       The wcsnlen() function is the wide-character equivalent of the strnlen(3)
       function.  It returns the number of wide-characters in the string pointed to
       by s, not including the terminating L'\0' character, but at most maxlen.  In
       doing this, wcsnlen() looks only at the first maxlen wide-characters at s and
       never beyond s+maxlen.

RETURN VALUE         top

       The wcsnlen() function returns wcslen(s), if that is less than maxlen, or
       maxlen if there is no L'\0' character among the first maxlen wide characters
       pointed to by s.

VERSIONS         top

       The wcsnlen() function is provided in glibc since version 2.1.

CONFORMING TO         top

       This function is a GNU extension.

SEE ALSO         top

       strnlen(3), wcslen(3)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2010-09-15                           WCSNLEN(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter