2005-10-28 Bob Wilson <bob.wilson@acm.org>

* libc/ctype/ctype.tex: Use hyphens as appropriate, but not  otherwise.
        * libc/ctype/islower.c: Likewise.
        * libc/ctype/isupper.c: Likewise.
        * libc/ctype/iswalnum.c: Likewise.
        * libc/ctype/iswalpha.c: Likewise.
        * libc/ctype/iswblank.c: Likewise.
        * libc/ctype/iswcntrl.c: Likewise.
        * libc/ctype/iswdigit.c: Likewise.
        * libc/ctype/iswgraph.c: Likewise.
        * libc/ctype/iswlower.c: Likewise.
        * libc/ctype/iswprint.c: Likewise.
        * libc/ctype/iswpunct.c: Likewise.
        * libc/ctype/iswspace.c: Likewise.
        * libc/ctype/iswupper.c: Likewise.
        * libc/ctype/iswxdigit.c: Likewise.
        * libc/ctype/tolower.c: Likewise.
        * libc/ctype/toupper.c: Likewise.
        * libc/ctype/towctrans.c: Likewise.
        * libc/ctype/towlower.c: Likewise.
        * libc/ctype/towupper.c: Likewise.
        * libc/string/strcasecmp.c: Likewise.
        * libc/string/strcoll.c: Likewise.
        * libc/string/strings.tex: Likewise.
        * libc/string/strlwr.c: Likewise.
        * libc/string/strncasecmp.c: Likewise.
        * libc/string/strupr.c: Likewise.
        * libc/string/wcscoll.c: Likewise.
        * libc/string/wcslcat.c: Likewise.
        * libc/string/wcslcpy.c: Likewise.
        * libc/string/wcsnlen.c: Likewise.
        * libc/string/wcsstr.c: Likewise.
        * libc/string/wcstrings.tex: Likewise.
        * libc/string/wmemchr.c: Likewise.
        * libc/string/wmemcmp.c: Likewise.
        * libc/string/wmemcpy.c: Likewise.
        * libc/string/wmemmove.c: Likewise.
        * libc/string/wmemset.c: Likewise.
This commit is contained in:
Jeff Johnston 2005-10-28 21:33:23 +00:00
parent 239c2bf93e
commit a306ebc97e
38 changed files with 173 additions and 133 deletions

View File

@ -1,3 +1,43 @@
2005-10-28 Bob Wilson <bob.wilson@acm.org>
* libc/ctype/ctype.tex: Use hyphens as appropriate, but not otherwise.
* libc/ctype/islower.c: Likewise.
* libc/ctype/isupper.c: Likewise.
* libc/ctype/iswalnum.c: Likewise.
* libc/ctype/iswalpha.c: Likewise.
* libc/ctype/iswblank.c: Likewise.
* libc/ctype/iswcntrl.c: Likewise.
* libc/ctype/iswdigit.c: Likewise.
* libc/ctype/iswgraph.c: Likewise.
* libc/ctype/iswlower.c: Likewise.
* libc/ctype/iswprint.c: Likewise.
* libc/ctype/iswpunct.c: Likewise.
* libc/ctype/iswspace.c: Likewise.
* libc/ctype/iswupper.c: Likewise.
* libc/ctype/iswxdigit.c: Likewise.
* libc/ctype/tolower.c: Likewise.
* libc/ctype/toupper.c: Likewise.
* libc/ctype/towctrans.c: Likewise.
* libc/ctype/towlower.c: Likewise.
* libc/ctype/towupper.c: Likewise.
* libc/string/strcasecmp.c: Likewise.
* libc/string/strcoll.c: Likewise.
* libc/string/strings.tex: Likewise.
* libc/string/strlwr.c: Likewise.
* libc/string/strncasecmp.c: Likewise.
* libc/string/strupr.c: Likewise.
* libc/string/wcscoll.c: Likewise.
* libc/string/wcslcat.c: Likewise.
* libc/string/wcslcpy.c: Likewise.
* libc/string/wcsnlen.c: Likewise.
* libc/string/wcsstr.c: Likewise.
* libc/string/wcstrings.tex: Likewise.
* libc/string/wmemchr.c: Likewise.
* libc/string/wmemcmp.c: Likewise.
* libc/string/wmemcpy.c: Likewise.
* libc/string/wmemmove.c: Likewise.
* libc/string/wmemset.c: Likewise.
2005-10-28 Bob Wilson <bob.wilson@acm.org> 2005-10-28 Bob Wilson <bob.wilson@acm.org>
* libc/misc/unctrl.c: Replace FUNCTION description. * libc/misc/unctrl.c: Replace FUNCTION description.

View File

@ -12,7 +12,7 @@ The header file @file{ctype.h} defines the macros.
* isascii:: ASCII character predicate * isascii:: ASCII character predicate
* iscntrl:: Control character predicate * iscntrl:: Control character predicate
* isdigit:: Decimal digit predicate * isdigit:: Decimal digit predicate
* islower:: Lower-case character predicate * islower:: Lowercase character predicate
* isprint:: Printable character predicates (isprint, isgraph) * isprint:: Printable character predicates (isprint, isgraph)
* ispunct:: Punctuation character predicate * ispunct:: Punctuation character predicate
* isspace:: Whitespace character predicate * isspace:: Whitespace character predicate
@ -21,23 +21,23 @@ The header file @file{ctype.h} defines the macros.
* toascii:: Force integers to ASCII range * toascii:: Force integers to ASCII range
* tolower:: Translate characters to lowercase * tolower:: Translate characters to lowercase
* toupper:: Translate characters to uppercase * toupper:: Translate characters to uppercase
* iswalnum:: Alphanumeric wide-character predicate * iswalnum:: Alphanumeric wide character predicate
* iswalpha:: Alphabetic wide-character predicate * iswalpha:: Alphabetic wide character predicate
* iswblank:: Blank wide-character predicate * iswblank:: Blank wide character predicate
* iswcntrl:: Control wide-character predicate * iswcntrl:: Control wide character predicate
* iswdigit:: Decimal digit wide-character predicate * iswdigit:: Decimal digit wide character predicate
* iswgraph:: Graphic wide-character predicate * iswgraph:: Graphic wide character predicate
* iswlower:: Lower-case wide-character predicate * iswlower:: Lowercase wide character predicate
* iswprint:: Printable wide-character predicate * iswprint:: Printable wide character predicate
* iswpunct:: Punctuation wide-character predicate * iswpunct:: Punctuation wide character predicate
* iswspace:: Whitespace wide-character predicate * iswspace:: Whitespace wide character predicate
* iswupper:: Uppercase wide-character predicate * iswupper:: Uppercase wide character predicate
* iswxdigit:: Hexadecimal digit wide-character predicate * iswxdigit:: Hexadecimal digit wide character predicate
* iswctype:: Extensible wide-character test * iswctype:: Extensible wide-character test
* wctype:: Compute wide-character test type * wctype:: Compute wide-character test type
* towlower:: Translate wide-characters to lower case * towlower:: Translate wide characters to lowercase
* towupper:: Translate wide-characters to upper case * towupper:: Translate wide characters to uppercase
* towctrans:: Extensible wide-character case mapping * towctrans:: Extensible wide-character translation
* wctrans:: Compute wide-character translation type * wctrans:: Compute wide-character translation type
@end menu @end menu

View File

@ -1,7 +1,7 @@
/* /*
FUNCTION FUNCTION
<<islower>>---lower-case character predicate <<islower>>---lowercase character predicate
INDEX INDEX
islower islower
@ -17,7 +17,7 @@ int islower(<[c]>);
DESCRIPTION DESCRIPTION
<<islower>> is a macro which classifies ASCII integer values by table <<islower>> is a macro which classifies ASCII integer values by table
lookup. It is a predicate returning non-zero for minuscules lookup. It is a predicate returning non-zero for minuscules
(lower-case alphabetic characters), and 0 for other characters. (lowercase alphabetic characters), and 0 for other characters.
It is defined only when <<isascii>>(<[c]>) is true or <[c]> is EOF. It is defined only when <<isascii>>(<[c]>) is true or <[c]> is EOF.
You can use a compiled subroutine instead of the macro definition by You can use a compiled subroutine instead of the macro definition by

View File

@ -16,7 +16,7 @@ int isupper(<[c]>);
DESCRIPTION DESCRIPTION
<<isupper>> is a macro which classifies ASCII integer values by table <<isupper>> is a macro which classifies ASCII integer values by table
lookup. It is a predicate returning non-zero for upper-case letters lookup. It is a predicate returning non-zero for uppercase letters
(<<A>>--<<Z>>), and 0 for other characters. It is defined only when (<<A>>--<<Z>>), and 0 for other characters. It is defined only when
<<isascii>>(<[c]>) is true or <[c]> is EOF. <<isascii>>(<[c]>) is true or <[c]> is EOF.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<iswalnum>>---alpha-numeric wide-character test <<iswalnum>>---alphanumeric wide character test
INDEX INDEX
iswalnum iswalnum
@ -16,10 +16,10 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<iswalnum>> is a function which classifies wide-character values that <<iswalnum>> is a function which classifies wide-character values that
are alpha-numeric. are alphanumeric.
RETURNS RETURNS
<<iswalnum>> returns non-zero if <[c]> is a alpha-numeric wide-character. <<iswalnum>> returns non-zero if <[c]> is a alphanumeric wide character.
PORTABILITY PORTABILITY
<<iswalnum>> is C99. <<iswalnum>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswalpha>>---alphabetic wide-character test <<iswalpha>>---alphabetic wide character test
INDEX INDEX
iswalpha iswalpha
@ -48,7 +48,7 @@ DESCRIPTION
are alphabetic. are alphabetic.
RETURNS RETURNS
<<iswalpha>> returns non-zero if <[c]> is an alphabetic wide-character. <<iswalpha>> returns non-zero if <[c]> is an alphabetic wide character.
PORTABILITY PORTABILITY
<<iswalpha>> is C99. <<iswalpha>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswblank>>---wide-character blank test <<iswblank>>---blank wide character test
INDEX INDEX
iswblank iswblank
@ -48,7 +48,7 @@ DESCRIPTION
are categorized as blank. are categorized as blank.
RETURNS RETURNS
<<iswblank>> returns non-zero if <[c]> is a blank wide-character. <<iswblank>> returns non-zero if <[c]> is a blank wide character.
PORTABILITY PORTABILITY
<<iswblank>> is C99. <<iswblank>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswcntrl>>---wide-character cntrl test <<iswcntrl>>---control wide character test
INDEX INDEX
iswcntrl iswcntrl
@ -45,10 +45,10 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<iswcntrl>> is a function which classifies wide-character values that <<iswcntrl>> is a function which classifies wide-character values that
are categorized as a control character. are categorized as control characters.
RETURNS RETURNS
<<iswcntrl>> returns non-zero if <[c]> is a control wide-character. <<iswcntrl>> returns non-zero if <[c]> is a control wide character.
PORTABILITY PORTABILITY
<<iswcntrl>> is C99. <<iswcntrl>> is C99.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<iswdigit>>---decimal digit wide-character test <<iswdigit>>---decimal digit wide character test
INDEX INDEX
iswdigit iswdigit
@ -19,7 +19,7 @@ DESCRIPTION
are decimal digits. are decimal digits.
RETURNS RETURNS
<<iswdigit>> returns non-zero if <[c]> is a decimal digit wide-character. <<iswdigit>> returns non-zero if <[c]> is a decimal digit wide character.
PORTABILITY PORTABILITY
<<iswdigit>> is C99. <<iswdigit>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswgraph>>---graphic wide-character test <<iswgraph>>---graphic wide character test
INDEX INDEX
iswgraph iswgraph
@ -48,7 +48,7 @@ DESCRIPTION
are graphic. are graphic.
RETURNS RETURNS
<<iswgraph>> returns non-zero if <[c]> is a graphic wide-character. <<iswgraph>> returns non-zero if <[c]> is a graphic wide character.
PORTABILITY PORTABILITY
<<iswgraph>> is C99. <<iswgraph>> is C99.

View File

@ -1,7 +1,7 @@
/* /*
FUNCTION FUNCTION
<<iswlower>>---lower-case wide-character test <<iswlower>>---lowercase wide character test
INDEX INDEX
iswlower iswlower
@ -17,10 +17,10 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<iswlower>> is a function which classifies wide-character values that <<iswlower>> is a function which classifies wide-character values that
have an upper-case translation. have uppercase translations.
RETURNS RETURNS
<<iswlower>> returns non-zero if <[c]> is a lower-case wide-character. <<iswlower>> returns non-zero if <[c]> is a lowercase wide character.
PORTABILITY PORTABILITY
<<iswlower>> is C99. <<iswlower>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswprint>>---printable wide-character test <<iswprint>>---printable wide character test
INDEX INDEX
iswprint iswprint
@ -48,7 +48,7 @@ DESCRIPTION
are printable. are printable.
RETURNS RETURNS
<<iswprint>> returns non-zero if <[c]> is a printable wide-character. <<iswprint>> returns non-zero if <[c]> is a printable wide character.
PORTABILITY PORTABILITY
<<iswprint>> is C99. <<iswprint>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswpunct>>---punctuation wide-character test <<iswpunct>>---punctuation wide character test
INDEX INDEX
iswpunct iswpunct
@ -48,7 +48,7 @@ DESCRIPTION
are punctuation. are punctuation.
RETURNS RETURNS
<<iswpunct>> returns non-zero if <[c]> is a punctuation wide-character. <<iswpunct>> returns non-zero if <[c]> is a punctuation wide character.
PORTABILITY PORTABILITY
<<iswpunct>> is C99. <<iswpunct>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<iswspace>>---wide-character space test <<iswspace>>---whitespace wide character test
INDEX INDEX
iswspace iswspace
@ -45,10 +45,10 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<iswspace>> is a function which classifies wide-character values that <<iswspace>> is a function which classifies wide-character values that
are categorized as white-space. are categorized as whitespace.
RETURNS RETURNS
<<iswspace>> returns non-zero if <[c]> is a white-space wide-character. <<iswspace>> returns non-zero if <[c]> is a whitespace wide character.
PORTABILITY PORTABILITY
<<iswspace>> is C99. <<iswspace>> is C99.

View File

@ -1,7 +1,7 @@
/* /*
FUNCTION FUNCTION
<<iswupper>>---upper-case wide-character test <<iswupper>>---uppercase wide character test
INDEX INDEX
iswupper iswupper
@ -17,10 +17,10 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<iswupper>> is a function which classifies wide-character values that <<iswupper>> is a function which classifies wide-character values that
have an upper-case translation. have uppercase translations.
RETURNS RETURNS
<<iswupper>> returns non-zero if <[c]> is a upper-case wide-character. <<iswupper>> returns non-zero if <[c]> is a uppercase wide character.
PORTABILITY PORTABILITY
<<iswupper>> is C99. <<iswupper>> is C99.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<iswxdigit>>---hexadecimal digit wide-character test <<iswxdigit>>---hexadecimal digit wide character test
INDEX INDEX
iswxdigit iswxdigit
@ -15,11 +15,11 @@ TRAD_SYNOPSIS
wint_t <[c]>; wint_t <[c]>;
DESCRIPTION DESCRIPTION
<<iswxdigit>> is a function which classifies wide-character values that <<iswxdigit>> is a function which classifies wide character values that
are hexadecimal digits. are hexadecimal digits.
RETURNS RETURNS
<<iswxdigit>> returns non-zero if <[c]> is a hexadecimal digit wide-character. <<iswxdigit>> returns non-zero if <[c]> is a hexadecimal digit wide character.
PORTABILITY PORTABILITY
<<iswxdigit>> is C99. <<iswxdigit>> is C99.

View File

@ -19,8 +19,8 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<tolower>> is a macro which converts upper-case characters to lower <<tolower>> is a macro which converts uppercase characters to lowercase,
case, leaving all other characters unchanged. It is only defined when leaving all other characters unchanged. It is only defined when
<[c]> is an integer in the range <<EOF>> to <<255>>. <[c]> is an integer in the range <<EOF>> to <<255>>.
You can use a compiled subroutine instead of the macro definition by You can use a compiled subroutine instead of the macro definition by
@ -30,10 +30,10 @@ undefining this macro using `<<#undef tolower>>'.
only be used when <[c]> is known to be an uppercase character (<<A>>--<<Z>>). only be used when <[c]> is known to be an uppercase character (<<A>>--<<Z>>).
RETURNS RETURNS
<<tolower>> returns the lower-case equivalent of <[c]> when it is a <<tolower>> returns the lowercase equivalent of <[c]> when it is a
character between <<A>> and <<Z>>, and <[c]> otherwise. character between <<A>> and <<Z>>, and <[c]> otherwise.
<<_tolower>> returns the lower-case equivalent of <[c]> when it is a <<_tolower>> returns the lowercase equivalent of <[c]> when it is a
character between <<A>> and <<Z>>. If <[c]> is not one of these character between <<A>> and <<Z>>. If <[c]> is not one of these
characters, the behaviour of <<_tolower>> is undefined. characters, the behaviour of <<_tolower>> is undefined.

View File

@ -19,8 +19,8 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<toupper>> is a macro which converts lower-case characters to upper <<toupper>> is a macro which converts lowercase characters to uppercase,
case, leaving all other characters unchanged. It is only defined when leaving all other characters unchanged. It is only defined when
<[c]> is an integer in the range <<EOF>> to <<255>>. <[c]> is an integer in the range <<EOF>> to <<255>>.
You can use a compiled subroutine instead of the macro definition by You can use a compiled subroutine instead of the macro definition by
@ -30,10 +30,10 @@ undefining this macro using `<<#undef toupper>>'.
only be used when <[c]> is known to be a lowercase character (<<a>>--<<z>>). only be used when <[c]> is known to be a lowercase character (<<a>>--<<z>>).
RETURNS RETURNS
<<toupper>> returns the upper-case equivalent of <[c]> when it is a <<toupper>> returns the uppercase equivalent of <[c]> when it is a
character between <<a>> and <<z>>, and <[c]> otherwise. character between <<a>> and <<z>>, and <[c]> otherwise.
<<_toupper>> returns the upper-case equivalent of <[c]> when it is a <<_toupper>> returns the uppercase equivalent of <[c]> when it is a
character between <<a>> and <<z>>. If <[c]> is not one of these character between <<a>> and <<z>>. If <[c]> is not one of these
characters, the behaviour of <<_toupper>> is undefined. characters, the behaviour of <<_toupper>> is undefined.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<towctrans>>---extensible wide-character case mapping <<towctrans>>---extensible wide-character translation
INDEX INDEX
towctrans towctrans
@ -46,7 +46,7 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<towctrans>> is a function which converts wide-characters based on <<towctrans>> is a function which converts wide characters based on
a specified translation type <[w]>. If the translation type is a specified translation type <[w]>. If the translation type is
invalid or cannot be applied to the current character, no change invalid or cannot be applied to the current character, no change
to the character is made. to the character is made.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<towlower>>---translate wide-characters to lower case <<towlower>>---translate wide characters to lowercase
INDEX INDEX
towlower towlower
@ -45,12 +45,12 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<towlower>> is a function which converts upper-case wide-characters to lower <<towlower>> is a function which converts uppercase wide characters to
case, leaving all other characters unchanged. lowercase, leaving all other characters unchanged.
RETURNS RETURNS
<<towlower>> returns the lower-case equivalent of <[c]> when it is a <<towlower>> returns the lowercase equivalent of <[c]> when it is a
upper-case wide-character, otherwise, it returns the input character. uppercase wide character; otherwise, it returns the input character.
PORTABILITY PORTABILITY
<<towlower>> is C99. <<towlower>> is C99.

View File

@ -29,7 +29,7 @@
/* /*
FUNCTION FUNCTION
<<towupper>>---translate wide-characters to upper case <<towupper>>---translate wide characters to uppercase
INDEX INDEX
towupper towupper
@ -45,12 +45,12 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
<<towupper>> is a function which converts lower-case wide-characters to upper <<towupper>> is a function which converts lowercase wide characters to
case, leaving all other characters unchanged. uppercase, leaving all other characters unchanged.
RETURNS RETURNS
<<towupper>> returns the upper-case equivalent of <[c]> when it is a <<towupper>> returns the uppercase equivalent of <[c]> when it is a
lower-case wide-character, otherwise, it returns the input character. lowercase wide character, otherwise, it returns the input character.
PORTABILITY PORTABILITY
<<towupper>> is C99. <<towupper>> is C99.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<strcasecmp>>---case insensitive character string compare <<strcasecmp>>---case-insensitive character string compare
INDEX INDEX
strcasecmp strcasecmp

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<strcoll>>---locale specific character string compare <<strcoll>>---locale-specific character string compare
INDEX INDEX
strcoll strcoll

View File

@ -22,7 +22,7 @@ managing areas of memory. The corresponding declarations are in
* strcat:: Concatenate strings * strcat:: Concatenate strings
* strchr:: Search for character in string * strchr:: Search for character in string
* strcmp:: Character string compare * strcmp:: Character string compare
* strcoll:: Locale specific character string compare * strcoll:: Locale-specific character string compare
* strcpy:: Copy string * strcpy:: Copy string
* strcspn:: Count chars not in string * strcspn:: Count chars not in string
* strerror:: Convert error number to string * strerror:: Convert error number to string

View File

@ -15,7 +15,7 @@ TRAD_SYNOPSIS
char *<[a]>; char *<[a]>;
DESCRIPTION DESCRIPTION
<<strlwr>> converts each characters in the string at <[a]> to <<strlwr>> converts each character in the string at <[a]> to
lowercase. lowercase.
RETURNS RETURNS

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<strncasecmp>>---case insensitive character string compare <<strncasecmp>>---case-insensitive character string compare
INDEX INDEX
strncasecmp strncasecmp

View File

@ -15,7 +15,7 @@ TRAD_SYNOPSIS
char *<[a]>; char *<[a]>;
DESCRIPTION DESCRIPTION
<<strupr>> converts each characters in the string at <[a]> to <<strupr>> converts each character in the string at <[a]> to
uppercase. uppercase.
RETURNS RETURNS

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wcscoll>>---locale specific wide-character string compare <<wcscoll>>---locale-specific wide-character string compare
INDEX INDEX
wcscoll wcscoll

View File

@ -14,12 +14,12 @@ TRAD_SYNOPSIS
size_t <[siz]>; size_t <[siz]>;
DESCRIPTION DESCRIPTION
The <<wcslcat>> function appends wide-characters from <[src]> to The <<wcslcat>> function appends wide characters from <[src]> to
end of the <[dst]> wide-character string so that the resultant end of the <[dst]> wide-character string so that the resultant
wide-character string is not more than <[siz]> wide-characters wide-character string is not more than <[siz]> wide characters
including terminating null wide-character code. A terminating including the terminating null wide-character code. A terminating
null wide-character is always added unless <[siz]> is 0. Thus, null wide character is always added unless <[siz]> is 0. Thus,
the maximum number of wide-characters that can be appended from the maximum number of wide characters that can be appended from
<[src]> is <[siz]> - 1. If copying takes place between objects <[src]> is <[siz]> - 1. If copying takes place between objects
that overlap, the behaviour is undefined. that overlap, the behaviour is undefined.
@ -28,7 +28,7 @@ RETURNS
wide-character string length of <[src]> (does not include wide-character string length of <[src]> (does not include
terminating null wide-characters). If the return value is terminating null wide-characters). If the return value is
greater than or equal to <[siz]>, then truncation occurred and greater than or equal to <[siz]>, then truncation occurred and
not all wide-characters from <[src]> were appended. not all wide characters from <[src]> were appended.
PORTABILITY PORTABILITY
No supporting OS subroutines are required. No supporting OS subroutines are required.

View File

@ -14,16 +14,16 @@ TRAD_SYNOPSIS
size_t <[siz]>; size_t <[siz]>;
DESCRIPTION DESCRIPTION
<<wcslcpy>> copies wide-characters from <[src]> to <[dst]> <<wcslcpy>> copies wide characters from <[src]> to <[dst]>
such that up to <[siz]> - 1 characters are copied. A such that up to <[siz]> - 1 characters are copied. A
terminating null is appended to the result, unless <[siz]> terminating null is appended to the result, unless <[siz]>
is zero. is zero.
RETURNS RETURNS
<<wcslcpy>> returns the number of wide-characters in <[src]>, <<wcslcpy>> returns the number of wide characters in <[src]>,
not including the terminating null wide-character. If the not including the terminating null wide character. If the
return value is greater than or equal to <[siz]>, then return value is greater than or equal to <[siz]>, then
not all wide-characters were copied from <[src]> and truncation not all wide characters were copied from <[src]> and truncation
occurred. occurred.
PORTABILITY PORTABILITY

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wcsnlen>>---get fixed-size wide character string length <<wcsnlen>>---get fixed-size wide-character string length
INDEX INDEX
wcsnlen wcsnlen
@ -16,8 +16,8 @@ TRAD_SYNOPSIS
size_t <[maxlen]>; size_t <[maxlen]>;
DESCRIPTION DESCRIPTION
The <<wcsnlen>> function computes the number of wide character codes The <<wcsnlen>> function computes the number of wide-character codes
in the wide character string pointed to by <[s]> not including the in the wide-character string pointed to by <[s]> not including the
terminating L'\0' wide character but at most <[maxlen]> wide terminating L'\0' wide character but at most <[maxlen]> wide
characters. characters.

View File

@ -14,7 +14,7 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
The <<wcsstr>> function locates the first occurrence in the The <<wcsstr>> function locates the first occurrence in the
wide-character string pointed to by <[big]> of the sequence of wide-character string pointed to by <[big]> of the sequence of
wide-characters (excluding the terminating null wide-character) in the wide characters (excluding the terminating null wide character) in the
wide-character string pointed to by <[little]>. wide-character string pointed to by <[little]>.
RETURNS RETURNS

View File

@ -2,21 +2,21 @@
@chapter Wide Character Strings (@file{wchar.h}) @chapter Wide Character Strings (@file{wchar.h})
This chapter describes wide-character string-handling functions and This chapter describes wide-character string-handling functions and
managing areas of memory containing wide-characters. The corresponding managing areas of memory containing wide characters. The corresponding
declarations are in @file{wchar.h}. declarations are in @file{wchar.h}.
@menu @menu
* wmemchr:: Find wide-character in memory * wmemchr:: Find wide character in memory
* wmemcmp:: Compare two wide-character memory areas * wmemcmp:: Compare two wide-character memory areas
* wmemcpy:: Copy wide-character memory regions * wmemcpy:: Copy wide-character memory regions
* wmemmove:: Move possibly overlapping wide-character memory * wmemmove:: Move possibly overlapping wide-character memory
* wmemset:: Set an area of memory to a specified wide-character * wmemset:: Set an area of memory to a specified wide character
* wcscat:: Concatenate wide-character strings * wcscat:: Concatenate wide-character strings
* wcschr:: Search for wide-character in string * wcschr:: Search for wide character in string
* wcscmp:: Wide-character string compare * wcscmp:: Wide-character string compare
* wcscoll:: Locale specific Wide-character string compare * wcscoll:: Locale-specific wide-character string compare
* wcscpy:: Copy wide-character string * wcscpy:: Copy wide-character string
* wcscspn:: Count wide-chars not in string * wcscspn:: Count wide characters not in string
* wcslcat:: Concatenate wide-character strings to specified length * wcslcat:: Concatenate wide-character strings to specified length
* wcslcpy:: Copy wide-character string to specified length * wcslcpy:: Copy wide-character string to specified length
* wcslen:: Wide-character string length * wcslen:: Wide-character string length
@ -24,8 +24,8 @@ declarations are in @file{wchar.h}.
* wcsncmp:: Wide-character string compare * wcsncmp:: Wide-character string compare
* wcsncpy:: Counted copy wide-character string * wcsncpy:: Counted copy wide-character string
* wcsnlen:: Wide-character string length with maximum limit * wcsnlen:: Wide-character string length with maximum limit
* wcspbrk:: Find wide-chars in string * wcspbrk:: Find wide characters in string
* wcsrchr:: Reverse search for wide-character in string * wcsrchr:: Reverse search for wide character in string
* wcsspn:: Find initial match in wide-character string * wcsspn:: Find initial match in wide-character string
* wcsstr:: Find wide-character string segment * wcsstr:: Find wide-character string segment
* wcswidth:: Number of column positions of a wide-character string * wcswidth:: Number of column positions of a wide-character string

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wmemchr>>---find a wide-character in memory <<wmemchr>>---find a wide character in memory
ANSI_SYNOPSIS ANSI_SYNOPSIS
@ -15,9 +15,9 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
The <<wmemchr>> function locates the first occurrence of <[c]> in the The <<wmemchr>> function locates the first occurrence of <[c]> in the
initial <[n]> wide-characters of the object pointed to be <[s]>. This initial <[n]> wide characters of the object pointed to be <[s]>. This
function is not affected by locale and all wchar_t values are treated function is not affected by locale and all wchar_t values are treated
identically. The null wide-character and wchar_t values not identically. The null wide character and wchar_t values not
corresponding to valid characters are not treated specially. corresponding to valid characters are not treated specially.
If <[n]> is zero, <[s]> must be a valid pointer and the function If <[n]> is zero, <[s]> must be a valid pointer and the function
@ -25,7 +25,7 @@ DESCRIPTION
RETURNS RETURNS
The <<wmemchr>> function returns a pointer to the located The <<wmemchr>> function returns a pointer to the located
wide-character, or a null pointer if the wide-character does not occur wide character, or a null pointer if the wide character does not occur
in the object. in the object.
PORTABILITY PORTABILITY

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wmemcmp>>---compare wide-characters in memory <<wmemcmp>>---compare wide characters in memory
ANSI_SYNOPSIS ANSI_SYNOPSIS
#include <wchar.h> #include <wchar.h>
@ -13,10 +13,10 @@ TRAD_SYNOPSIS
size_t <[n]>; size_t <[n]>;
DESCRIPTION DESCRIPTION
The <<wmemcmp>> function compares the first <[n]> wide-characters of the The <<wmemcmp>> function compares the first <[n]> wide characters of the
object pointed to by <[s1]> to the first <[n]> wide-characters of the object pointed to by <[s1]> to the first <[n]> wide characters of the
object pointed to by <[s2]>. This function is not affected by locale object pointed to by <[s2]>. This function is not affected by locale
and all wchar_t values are treated identically. The null wide-character and all wchar_t values are treated identically. The null wide character
and wchar_t values not corresponding to valid characters are not treated and wchar_t values not corresponding to valid characters are not treated
specially. specially.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wmemcpy>>---copy wide-characters in memory <<wmemcpy>>---copy wide characters in memory
ANSI_SYNOPSIS ANSI_SYNOPSIS
#include <wchar.h> #include <wchar.h>
@ -13,14 +13,14 @@ TRAD_SYNOPSIS
size_t <[n]>; size_t <[n]>;
DESCRIPTION DESCRIPTION
The <<wmemcpy>> function copies <[n]> wide-characters from the object The <<wmemcpy>> function copies <[n]> wide characters from the object
pointed to by <[s]> to the object pointed to be <[d]>. This function pointed to by <[s]> to the object pointed to be <[d]>. This function
is not affected by locale and all wchar_t values are treated is not affected by locale and all wchar_t values are treated
identically. The null wide-character and wchar_t values not identically. The null wide character and wchar_t values not
corresponding to valid characters are not treated specially. corresponding to valid characters are not treated specially.
If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the
function copies zero wide-characters. function copies zero wide characters.
RETURNS RETURNS
The <<wmemcpy>> function returns the value of <[d]>. The <<wmemcpy>> function returns the value of <[d]>.

View File

@ -13,20 +13,20 @@ TRAD_SYNOPSIS
size_t <[n]>; size_t <[n]>;
DESCRIPTION DESCRIPTION
The <<wmemmove>> function copies <[n]> wide-characters from the object The <<wmemmove>> function copies <[n]> wide characters from the object
pointed to by <[s]> to the object pointed to by <[d]>. Copying takes pointed to by <[s]> to the object pointed to by <[d]>. Copying takes
place as if the <[n]> wide-characters from the object pointed to by place as if the <[n]> wide characters from the object pointed to by
<[s]> are first copied into a temporary array of <[n]> wide-characters <[s]> are first copied into a temporary array of <[n]> wide characters
that does not overlap the objects pointed to by <[d]> or <[s]>, and then that does not overlap the objects pointed to by <[d]> or <[s]>, and then
the <[n]> wide-characters from the temporary array are copied into the the <[n]> wide characters from the temporary array are copied into the
object pointed to by <[d]>. object pointed to by <[d]>.
This function is not affected by locale and all wchar_t values are This function is not affected by locale and all wchar_t values are
treated identically. The null wide-character and wchar_t values not treated identically. The null wide character and wchar_t values not
corresponding to valid characters are not treated specially. corresponding to valid characters are not treated specially.
If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the
function copies zero wide-characters. function copies zero wide characters.
RETURNS RETURNS
The <<wmemmove>> function returns the value of <[d]>. The <<wmemmove>> function returns the value of <[d]>.

View File

@ -1,6 +1,6 @@
/* /*
FUNCTION FUNCTION
<<wmemset>>---set wide-characters in memory <<wmemset>>---set wide characters in memory
ANSI_SYNOPSIS ANSI_SYNOPSIS
#include <wchar.h> #include <wchar.h>
@ -14,16 +14,16 @@ TRAD_SYNOPSIS
DESCRIPTION DESCRIPTION
The <<wmemset>> function copies the value of <[c]> into each of the The <<wmemset>> function copies the value of <[c]> into each of the
first <[n]> wide-characters of the object pointed to by <[s]>. This first <[n]> wide characters of the object pointed to by <[s]>. This
function is not affected by locale and all wchar_t values are treated function is not affected by locale and all wchar_t values are treated
identically. The null wide-character and wchar_t values not identically. The null wide character and wchar_t values not
corresponding to valid characters are not treated specially. corresponding to valid characters are not treated specially.
If <[n]> is zero, <[s]> must be a valid pointer and the function If <[n]> is zero, <[s]> must be a valid pointer and the function
copies zero wide-characters. copies zero wide characters.
RETURNS RETURNS
The <<wmemset>> functions returns the value of <[s]>. The <<wmemset>> function returns the value of <[s]>.
PORTABILITY PORTABILITY
<<wmemset>> is ISO/IEC 9899/AMD1:1995 (ISO C). <<wmemset>> is ISO/IEC 9899/AMD1:1995 (ISO C).