This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
POSIX.pod: Add some caveats about strcoll(), strxfrm()
authorKarl Williamson <khw@cpan.org>
Fri, 8 Apr 2016 19:46:24 +0000 (13:46 -0600)
committerKarl Williamson <khw@cpan.org>
Mon, 9 May 2016 17:19:05 +0000 (11:19 -0600)
ext/POSIX/lib/POSIX.pod

index 1d263a7..840f04b 100644 (file)
@@ -1671,6 +1671,10 @@ for collating (comparing) strings transformed using
 the C<strxfrm()> function.  Not really needed since
 Perl can do this transparently, see L<perllocale>.
 
 the C<strxfrm()> function.  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.
+
 =item C<strcpy>
 
 Not implemented.  C<strcpy()> is C-specific, use C<=> instead, see L<perlop>.
 =item C<strcpy>
 
 Not implemented.  C<strcpy()> is C-specific, use C<=> instead, see L<perlop>.
@@ -1843,6 +1847,10 @@ Used in conjunction with the C<strcoll()> function, see L</strcoll>.
 Not really needed since Perl can do this transparently, see
 L<perllocale>.
 
 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.
+
 =item C<sysconf>
 
 Retrieves values of system configurable variables.
 =item C<sysconf>
 
 Retrieves values of system configurable variables.