cpan/Encode/Encode.pm

352 same data, the UTF8 flag for $octets is I<always> off.  When you
353 encode anything, the UTF8 flag on the result is always off, even when it
354 contains a completely valid UTF-8 string. See L</"The UTF8 flag"> below.
382 UTF8 flag for $string is on.  See L</"The UTF8 flag">
466 but only #2 turns the UTF8 flag on.  #1 is equivalent to:
470 See L</"The UTF8 flag"> below.
490 B<WARNING>: L<This function can produce invalid UTF-8!|/UTF-8 vs. utf8 vs. UTF8>
504 B<WARNING>: L<This function accepts invalid UTF-8!|/UTF-8 vs. utf8 vs. UTF8>
781 =head1 The UTF8 flag
786 I<the UTF8 flag>. To explain why we made it so, I quote from page 402 of
816 UTF8 flag is one of them.  You can think of there being two fundamentally
818 byte-oriented mode  for when the internal UTF8 flag is off, and the other a
819 character-oriented mode for when the internal UTF8 flag is on.
821 This UTF8 flag is not visible in Perl scripts, exactly for the same reason
836 [INTERNAL] Tests whether the UTF8 flag is turned on in the I<STRING>.
844 B<CAVEAT>: If I<STRING> has UTF8 flag set, it does B<NOT> mean that
853 [INTERNAL] Turns the I<STRING>'s internal UTF8 flag B<on>.  The I<STRING>
856 well-formed UTF-8.  Returns the previous state of the UTF8 flag (so please
866 [INTERNAL] Turns the I<STRING>'s internal UTF8 flag B<off>.  Do not use
867 frivolously.  Returns the previous state of the UTF8 flag, or C<undef> if
874 =head1 UTF-8 vs. utf8 vs. UTF8
941   find_encoding("UTF8")->name  # is 'utf8'.
943 Perl's internal UTF8 flag is called "UTF8", without a hyphen. It indicates