type, and remove unnecessary parentheses around the casted value.
Thus, for example, the following:
.IR "(size_t) (\-1)" .
becomes:
.IR "(size_t)\ \-1" .
session leader.)
.SH RETURN VALUE
On success, a session ID is returned.
-On error, \fI(pid_t) \-1\fP will be returned, and
+On error, \fI(pid_t)\ \-1\fP will be returned, and
.I errno
is set appropriately.
.SH ERRORS
On error, the value
.B MAP_FAILED
(that is,
-.IR "(void *) \-1" )
+.IR "(void\ *)\ \-1" )
is returned, and
.I errno
is set appropriately.
returns a pointer to the new virtual memory area.
On error, the value
.B MAP_FAILED
-(that is, \fI(void *) \-1\fP) is returned,
+(that is, \fI(void\ *)\ \-1\fP) is returned,
and \fIerrno\fP is set appropriately.
.SH ERRORS
.TP
On success
.BR shmat ()
returns the address of the attached shared memory segment; on error
-.I (void *) \-1
+.I (void\ *)\ \-1
is returned, and
.I errno
is set to indicate the cause of the error.
.BR CLOCKS_PER_SEC .
If the processor time used is not available or its value cannot
be represented, the function returns the value
-.IR (clock_t)\-1 .
+.IR (clock_t)\ \-1 .
.SH "CONFORMING TO"
C89, C99, POSIX.1-2001.
POSIX requires that
time cannot be represented as calendar time (seconds since the Epoch),
.BR mktime ()
returns a value of
-.I (time_t)(\-1)
+.I (time_t)\ \-1
and does not alter the
\fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure.
.SH "RETURN VALUE"
1. An invalid multibyte sequence is encountered in the input.
In this case
it sets \fIerrno\fP to \fBEILSEQ\fP and returns
-.IR (size_t)(\-1) .
+.IR (size_t)\ \-1 .
\fI*inbuf\fP
is left pointing to the beginning of the invalid multibyte sequence.
.PP
input byte sequence terminates after it.
In this case it sets \fIerrno\fP to
\fBEINVAL\fP and returns
-.IR (size_t)(\-1) .
+.IR (size_t)\ \-1 .
\fI*inbuf\fP is left pointing to the
beginning of the incomplete multibyte sequence.
.PP
4. The output buffer has no more room for the next converted character.
In this case it sets \fIerrno\fP to \fBE2BIG\fP and returns
-.IR (size_t)(\-1) .
+.IR (size_t)\ \-1 .
.PP
A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
\fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL.
At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
If the output buffer has no more room for this reset sequence, it sets
\fIerrno\fP to \fBE2BIG\fP and returns
-.IR (size_t)(\-1) .
+.IR (size_t)\ \-1 .
Otherwise it increments
\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
written.
function returns the number of characters converted in a
non-reversible way during this call; reversible conversions are not counted.
In case of error, it sets \fIerrno\fP and returns
-.IR (size_t)(\-1) .
+.IR (size_t)\ \-1 .
.SH ERRORS
The following errors can occur, among others:
.TP
function returns a freshly allocated conversion
descriptor.
In case of error, it sets \fIerrno\fP and returns
-.IR (iconv_t)(\-1) .
+.IR (iconv_t)\ \-1 .
.SH ERRORS
The following error can occur, among others:
.TP
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrlen ()
-returns \fI(size_t)(\-2)\fP.
+returns \fI(size_t)\ \-2\fP.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
sequence before the next complete character,
.BR mbrlen ()
returns
-\fI(size_t) \-1\fP and sets \fIerrno\fP to \fBEILSEQ\fP.
+\fI(size_t)\ \-1\fP and sets \fIerrno\fP to \fBEILSEQ\fP.
In this case,
the effects on \fI*ps\fP are undefined.
.PP
sequence starting at \fIs\fP, if a non-null wide character was recognized.
It returns 0, if a null wide character was recognized.
It returns
-.I "(size_t) \-1"
+.I "(size_t)\ \-1"
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
-It returns \fI(size_t)(\-2)\fP if it couldn't parse a complete multibyte
+It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrtowc ()
-returns \fI(size_t)(\-2)\fP.
+returns \fI(size_t)\ \-2\fP.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
was recognized.
It returns 0, if a L'\\0' wide character was recognized.
It returns
-.I (size_t)(\-1)
+.I (size_t)\ \-1
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
-It returns \fI(size_t)(\-2)\fP if it couldn't parse a complete multibyte
+It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
not including the terminating null wide character.
If an invalid multibyte sequence was
encountered,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
terminating null wide character.
If an invalid multibyte sequence was
encountered,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99
.PP
1. An invalid multibyte sequence has been encountered.
In this case
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned.
.PP
2. \fIn\fP non-L'\\0' wide characters have been stored at \fIdest\fP.
terminating null wide character.
If an invalid multibyte sequence was
encountered,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned.
.SH "CONFORMING TO"
C99
have been written to the byte array at \fIs\fP.
If \fIwc\fP can not be
represented as a multibyte sequence (according to the current locale),
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99.
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
not including the terminating null byte.
If a wide character was encountered which
could not be converted,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned,
and
.I errno
not including the terminating null byte.
If a wide character was encountered
which could not be converted,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned, and
.I errno
set to \fBEILSEQ\fP.
1. A wide character has been encountered that can not be represented as a
multibyte sequence (according to the current locale).
In this case
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned.
.PP
2. The length limit forces a stop.
converted part of multibyte sequence, not including the terminating null byte.
If a wide character was encountered which could not be
converted,
-.I (size_t)(\-1)
+.I (size_t)\ \-1
is returned.
.SH "CONFORMING TO"
C99.
projects / thirdparty / man-pages.git / commitdiff
