From 990e18f721a7d2ee48d50ea4262bd5d109e9f89c Mon Sep 17 00:00:00 2001 From: Audrey Tang Date: Wed, 10 Dec 2003 04:39:16 +0800 Subject: Implicit upgrading docs Message-ID: <20031209123915.GA1454@not.autrijus.org> p4raw-id: //depot/perl@21873 --- ext/Encode/encoding.pm | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'ext/Encode/encoding.pm') diff --git a/ext/Encode/encoding.pm b/ext/Encode/encoding.pm index f203cb3d7e..93662524fa 100644 --- a/ext/Encode/encoding.pm +++ b/ext/Encode/encoding.pm @@ -192,6 +192,25 @@ not "\x{99F1}\x{99DD} is the symbol of perl.\n". You can override this by giving extra arguments; see below. +=head2 Implicit upgrading for byte strings + +By default, if strings operating under byte semantics and strings +with Unicode character data are concatenated, the new string will +be created by decoding the byte strings as I. + +The B pragma changes this to use the specified encoding +instead. For example: + + use encoding 'utf8'; + my $string = chr(20000); # a Unicode string + utf8::encode($string); # now it's a UTF-8 encoded byte string + # concatenate with another Unicode string + print length($string . chr(20000)); + +Will print C<2>, because C<$string> is upgraded as UTF-8. Without +C, it will print C<4> instead, since C<$string> +is three octets when interpreted as Latin-1. + =head1 FEATURES THAT REQUIRE 5.8.1 Some of the features offered by this pragma requires perl 5.8.1. Most -- cgit v1.2.1