summaryrefslogtreecommitdiff
path: root/pod/perlfunc.pod
diff options
context:
space:
mode:
authorJarkko Hietaniemi <jhi@iki.fi>2003-06-14 08:56:11 +0000
committerJarkko Hietaniemi <jhi@iki.fi>2003-06-14 08:56:11 +0000
commit974da8e5aded27d81bcf7d5c0c5998c377065269 (patch)
tree012373ee4f09ffe96e2c399b107998657fcb1c52 /pod/perlfunc.pod
parent1ae0ae1779f56be3f5008214f23d0e0a7f3dce42 (diff)
downloadperl-974da8e5aded27d81bcf7d5c0c5998c377065269.tar.gz
Slight tweaks on the length() and chr() entries,
passing-by rewrapping on the rmdir entry. p4raw-id: //depot/perl@19776
Diffstat (limited to 'pod/perlfunc.pod')
-rw-r--r--pod/perlfunc.pod20
1 files changed, 14 insertions, 6 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index e10ca607c9..ac20efcb43 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -732,10 +732,14 @@ chr(0x263a) is a Unicode smiley face. Note that characters from 127
to 255 (inclusive) are by default not encoded in Unicode for backward
compatibility reasons (but see L<encoding>).
+If NUMBER is omitted, uses C<$_>.
+
For the reverse, use L</ord>.
-See L<perlunicode> and L<encoding> for more about Unicode.
-If NUMBER is omitted, uses C<$_>.
+Note that under the C<bytes> pragma the NUMBER is masked to
+the low eight bits.
+
+See L<perlunicode> and L<encoding> for more about Unicode.
=item chroot FILENAME
@@ -2428,11 +2432,15 @@ If EXPR is omitted, uses C<$_>.
=item length
-Returns the length in characters of the value of EXPR. If EXPR is
+Returns the length in I<characters> of the value of EXPR. If EXPR is
omitted, returns length of C<$_>. Note that this cannot be used on
an entire array or hash to find out how many elements these have.
For that, use C<scalar @array> and C<scalar keys %hash> respectively.
+Note the I<characters>: if the EXPR is in Unicode, you will get the
+number of characters, not the number of bytes. To get the length
+in bytes, use C<do { use bytes; length(EXPR) }>, see L<bytes>.
+
=item link OLDFILE,NEWFILE
Creates a new filename linked to the old filename. Returns true for
@@ -4198,9 +4206,9 @@ last occurrence at or before that position.
=item rmdir
-Deletes the directory specified by FILENAME if that directory is empty. If it
-succeeds it returns true, otherwise it returns false and sets C<$!> (errno). If
-FILENAME is omitted, uses C<$_>.
+Deletes the directory specified by FILENAME if that directory is
+empty. If it succeeds it returns true, otherwise it returns false and
+sets C<$!> (errno). If FILENAME is omitted, uses C<$_>.
=item s///