diff options
Diffstat (limited to 'systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod')
| -rw-r--r-- | systems/texlive/tlnet/tlpkg/tlperl/lib/POSIX.pod | 56 |
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 |