summaryrefslogtreecommitdiff
path: root/man3/wcsnlen.3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2004-11-03 13:51:07 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2004-11-03 13:51:07 +0000
commitfea681dafb1363a154b7fc6d59baa83d2a9ebc5c (patch)
tree8ea275c0f242af739617d0afc3e1b16c4eff3dc2 /man3/wcsnlen.3
Import of man-pages 1.70man-pages-1.70
Diffstat (limited to 'man3/wcsnlen.3')
-rw-r--r--man3/wcsnlen.336
1 files changed, 36 insertions, 0 deletions
diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3
new file mode 100644
index 000000000..fed21f11e
--- /dev/null
+++ b/man3/wcsnlen.3
@@ -0,0 +1,36 @@
+.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
+.\"
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" References consulted:
+.\" GNU glibc-2 source code and manual
+.\" Dinkumware C library reference http://www.dinkumware.com/
+.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\"
+.TH WCSNLEN 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.SH NAME
+wcsnlen \- determine the length of a fixed-size wide-character string
+.SH SYNOPSIS
+.nf
+.B #include <wchar.h>
+.sp
+.BI "size_t wcsnlen(const wchar_t *" s ", size_t " maxlen );
+.fi
+.SH DESCRIPTION
+The \fBwcsnlen\fP function is the wide-character equivalent of the \fBstrnlen\fP
+function. It returns the number of wide-characters in the string pointed to by
+\fIs\fP, not including the terminating L'\\0' character, but at most
+\fImaxlen\fP. In doing this, \fBwcsnlen\fP looks only at the first \fImaxlen\fP
+wide-characters at \fIs\fP and never beyond \fIs+maxlen\fP.
+.SH "RETURN VALUE"
+The \fBwcsnlen\fP function returns \fIwcslen(s)\fP, if that is less than
+\fImaxlen\fP, or \fImaxlen\fP if there is no L'\\0' character among the
+first \fImaxlen\fP wide characters pointed to by \fIs\fP.
+.SH "CONFORMING TO"
+This function is a GNU extension.
+.SH "SEE ALSO"
+.BR strnlen (3),
+.BR wcslen (3)