~ubuntu-branches/ubuntu/breezy/manpages-posix/breezy

« back to all changes in this revision

Viewing changes to man3p/wcsncmp.3p

  • Committer: Bazaar Package Importer
  • Author(s): Francesco Paolo Lovergine
  • Date: 2004-08-27 10:47:48 UTC
  • Revision ID: james.westby@ubuntu.com-20040827104748-8zjxz9vva0n0t4sm
Tags: 1.67-3
rules: linking manpages-posix not manpages.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved 
 
2
.TH "WCSNCMP" P 2003 POSIX
 
3
.\" wcsncmp 
 
4
.SH NAME
 
5
wcsncmp \- compare part of two wide-character strings
 
6
.SH SYNOPSIS
 
7
.LP
 
8
\fB#include <wchar.h>
 
9
.br
 
10
.sp
 
11
int wcsncmp(const wchar_t *\fP\fIws1\fP\fB, const wchar_t *\fP\fIws2\fP\fB,
 
12
size_t\fP \fIn\fP\fB);
 
13
.br
 
14
\fP
 
15
.SH DESCRIPTION
 
16
.LP
 
17
The \fIwcsncmp\fP() function shall compare not more than \fIn\fP wide-character
 
18
codes (wide-character codes that follow a null
 
19
wide-character code are not compared) from the array pointed to by
 
20
\fIws1\fP to the array pointed to by \fIws2\fP.
 
21
.LP
 
22
The sign of a non-zero return value shall be determined by the sign
 
23
of the difference between the values of the first pair of
 
24
wide-character codes that differ in the objects being compared.
 
25
.SH RETURN VALUE
 
26
.LP
 
27
Upon successful completion, \fIwcsncmp\fP() shall return an integer
 
28
greater than, equal to, or less than 0, if the possibly
 
29
null-terminated array pointed to by \fIws1\fP is greater than, equal
 
30
to, or less than the possibly null-terminated array pointed
 
31
to by \fIws2\fP, respectively.
 
32
.SH ERRORS
 
33
.LP
 
34
No errors are defined.
 
35
.LP
 
36
\fIThe following sections are informative.\fP
 
37
.SH EXAMPLES
 
38
.LP
 
39
None.
 
40
.SH APPLICATION USAGE
 
41
.LP
 
42
None.
 
43
.SH RATIONALE
 
44
.LP
 
45
None.
 
46
.SH FUTURE DIRECTIONS
 
47
.LP
 
48
None.
 
49
.SH SEE ALSO
 
50
.LP
 
51
\fIwcscmp\fP() , the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
 
52
\fI<wchar.h>\fP
 
53
.SH COPYRIGHT
 
54
Portions of this text are reprinted and reproduced in electronic form
 
55
from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
 
56
-- Portable Operating System Interface (POSIX), The Open Group Base
 
57
Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
 
58
Electrical and Electronics Engineers, Inc and The Open Group. In the
 
59
event of any discrepancy between this version and the original IEEE and
 
60
The Open Group Standard, the original IEEE and The Open Group Standard
 
61
is the referee document. The original Standard can be obtained online at
 
62
http://www.opengroup.org/unix/online.html .