| CARVIEW |
CONTENTS
#NAME
source::encoding -- Declare Perl source code encoding
#SYNOPSIS
use source::encoding 'ascii';
use source::encoding 'utf8';
no source::encoding;#DESCRIPTION
These days, Perl code either generally contains only ASCII characters with \x{} and similar escapes to represent non-ASCII, or use utf8 is used to indicate that the source code itself contains characters encoded as UTF-8.
That means that a character in the source code not meeting these criteria is often a typographical error. This pragma is used to tell Perl to raise an error when this happens.
use source::encoding 'utf8' is a synonym for use utf8. They may be used interchangeably.
use source::encoding 'ascii' turns off any UTF-8 expectations, and raises a fatal error if any character within its scope in the input source code is not ASCII (or ASCII-equivalent on EBCDIC systems).
no source::encoding turns off any UTF-8/ASCII expectations for the remainder of its scope. The meaning of non-ASCII characters is then undefined.
use source::encoding 'ascii' is automatically enabled within the lexical scope of a use v5.41.0 or higher.
#SEE ALSO
Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.
The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.