summaryrefslogtreecommitdiff
path: root/systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod
diff options
context:
space:
mode:
Diffstat (limited to 'systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod')
-rw-r--r--systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod56
1 files changed, 38 insertions, 18 deletions
diff --git a/systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod b/systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod
index 4f85f35c8c..d3720da9b5 100644
--- a/systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod
+++ b/systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod
@@ -10,9 +10,9 @@ POSIX - Perl interface to IEEE Std 1003.1
printf "EINTR is %d\n", EINTR;
- $sess_id = POSIX::setsid();
+ my $sess_id = POSIX::setsid();
- $fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
+ my $fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
# note: that's a filedescriptor, *NOT* a filehandle
=head1 DESCRIPTION
@@ -501,7 +501,7 @@ than the explicit two operations [C99]. Added in Perl v5.22.
Maximum of C<x> and C<y>, except when either is C<NaN>, returns the other [C99].
Added in Perl v5.22.
- my $min = POSIX::fmax($x, $y);
+ my $max = POSIX::fmax($x, $y);
=item C<fmin>
@@ -825,11 +825,12 @@ to use instead. See L<perlrecharclass/POSIX Character Classes>.
Returns true if the argument is C<NaN> (not-a-number) [C99]. Added in
Perl v5.22.
-Note that you cannot test for "C<NaN>-ness" with
+Note that you can also test for "C<NaN>-ness" with
+L<equality operators|perlop/"Equality Operators"> (C<==> or C<!=>), as in
- $x == $x
+ print "x is not a NaN\n" if $x == $x;
-since the C<NaN> is not equivalent to anything, B<including itself>.
+since the C<NaN> is not equal to anything, B<including itself>.
See also L</nan>, L</NaN>, L</isinf>, and L</fpclassify>.
@@ -1014,6 +1015,18 @@ Here is how to query the database for the B<de> (Deutsch or German) locale.
The members whose names begin with C<int_p_> and C<int_n_> were added by
POSIX.1-2008 and are only available on systems that support them.
+A value of -1 returned for numeric entries indicates that the field is
+not applicable to the locale. This is rare except in the C and related
+locales, which don't have most monetary values defined. It can also
+happen, quirkily, in fields that are otherwise boolean to indicate that
+the value is kind of neither true nor false. This happens in C<p_cs_precedes>
+and C<int_p_cs_precedes> when the currency symbol neither precedes nor
+succeeds a positive value but is infixed, by replacing the radix
+character.
+
+Prior to Perl v5.37.7, empty string fields and numeric fields with value
+-1 were omittted from the returned hash.
+
=item C<localtime>
This is identical to Perl's builtin C<localtime()> function for
@@ -1133,9 +1146,10 @@ parameter is stored. The optional third parameter is ignored if it is
larger than the actual length of the second parameter string.
Use C<undef> as the second parameter to this function to get the effect
-of passing NULL as the second parameter to C<mbtowc>. This resets any
-shift state to its initial value. The return value is undefined if
-C<mbrtowc> was substituted, so you should never rely on it.
+of passing NULL as the second parameter to C<mbtowc>. This ignores the
+first parameter, and resets any shift state to its initial value. The
+return value is undefined if C<mbrtowc> was substituted, so you should
+never rely on it.
When the second parameter is a scalar containing a value that either is
a PV string or can be forced into one, the return value is the number of
@@ -1623,7 +1637,7 @@ will change only the real user identifier.
Detailed signal management. This uses C<POSIX::SigAction> objects for
the C<action> and C<oldaction> arguments (the oldaction can also be
just a hash reference). Consult your system's C<sigaction> manpage
-for details, see also C<POSIX::SigRt>.
+for details, see also L</POSIX::SigRt>.
Synopsis:
@@ -1826,7 +1840,7 @@ about these and the other arguments.
If you want your code to be portable, your format (C<fmt>) argument
should use only the conversion specifiers defined by the ANSI C
-standard (C89, to play safe). These are C<aAbBcdHIjmMpSUwWxXyYZ%>.
+standard (C99, to play safe). These are C<aAbBcdHIjmMpSUwWxXyYZ%>.
But even then, the B<results> of some of the conversion specifiers are
non-portable. For example, the specifiers C<aAbBcpZ> change according
to the locale settings of the user, and both how to set locales (the
@@ -1971,9 +1985,14 @@ Used with C<eq> or C<cmp> as an alternative to C<L</strcoll>>.
Not really needed since Perl can do this transparently, see
L<perllocale>.
-Beware that in a UTF-8 locale, anything you pass to this function must
-be in UTF-8; and when not in a UTF-8 locale, anything passed must not be
-UTF-8 encoded.
+Unlike the libc C<strxfrm>, this allows NUL characters in the input
+C<$src>.
+
+It doesn't make sense for a string to be encoded in one locale (say,
+ISO-8859-6, Arabic) and to collate it based on another (like ISO-8859-7,
+Greek). Perl assumes that the current C<LC_CTYPE> locale correctly
+represents the encoding of C<$src>, and ignores the value of
+C<LC_COLLATE>.
=item C<sysconf>
@@ -2196,9 +2215,10 @@ L</mblen> and L</mbtowc> may be used to roll your own decoding/encoding
of other types of multi-byte locales.
Use C<undef> as the first parameter to this function to get the effect
-of passing NULL as the first parameter to C<wctomb>. This resets any
-shift state to its initial value. The return value is undefined if
-C<wcrtomb> was substituted, so you should never rely on it.
+of passing NULL as the first parameter to C<wctomb>. This ignores the
+second parameter, and resets any shift state to its initial value. The
+return value is undefined if C<wcrtomb> was substituted, so you should
+never rely on it.
When the first parameter is a scalar, the code point contained in the
scalar second parameter is converted into a multi-byte string and stored
@@ -2739,7 +2759,7 @@ C<S_IWUSR> C<S_IXGRP> C<S_IXOTH> C<S_IXUSR>
=item Macros
-C<S_ISBLK> C<S_ISCHR> C<S_ISDIR> C<S_ISFIFO> C<S_ISREG>
+C<S_ISBLK> C<S_ISCHR> C<S_ISDIR> C<S_ISFIFO> C<S_ISLNK> C<S_ISREG> C<S_ISSOCK>
=back