PerlIO::encoding(3perl)

PerlIO::encoding3perl

Encoding layer

Usage

  use PerlIO::encoding;
  open($f, "<:encoding(foo)", "infoo");
  open($f, ">:encoding(bar)", "outbar");
  use Encode qw(:fallbacks);
  $PerlIO::encoding::fallback = FB_PERLQQ;

Overview

This PerlIO layer opens a filehandle with a transparent encoding filter.

On input, it converts the bytes expected to be in the specified character set and encoding to Perl string data (Unicode and Perl's internal Unicode encoding, UTF-8). On output, it converts Perl string data into the specified character set and encoding.

When the layer is pushed, the current value of $PerlIO::encoding::fallback is saved and used as the CHECK argument when calling the Encode methods encode() and decode().

Releases

12 releases since Debian 3.1 (Sarge); the text changed 11 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11
  10. 12
  11. 13
  12. Arch

From perl 5.44.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.