Страницы справочника OS X

Эта страница руководства для  версии 10.9 Mac OS X

Читать страницы руководства

eol(3)                               User Contributed Perl Documentation                              eol(3)



NAME
       PerlIO::eol - PerlIO layer for normalizing line endings

VERSION
       This document describes version 0.14 of PerlIO::eol, released December 18, 2006.

SYNOPSIS
           binmode STDIN, ":raw:eol(LF)";
           binmode STDOUT, ":raw:eol(CRLF)";
           open FH, "+<:raw:eol(LF-Native)", "file";

           binmode STDOUT, ":raw:eol(CRLF?)"; # warns on mixed newlines
           binmode STDOUT, ":raw:eol(CRLF!)"; # dies on mixed newlines

           use PerlIO::eol qw( eol_is_mixed );
           my $pos = eol_is_mixed( "mixed\nstring\r" );

DESCRIPTION
       This layer normalizes any of "CR", "LF", "CRLF" and "Native" into the designated line ending.  It
       works for both input and output handles.

       If you specify two different line endings joined by a "-", it will use the first one for reading and
       the second one for writing.  For example, the "LF-CRLF" encoding means that all input should be
       normalized to "LF", and all output should be normalized to "CRLF".

       By default, data with mixed newlines are normalized silently.  Append a "!"  to the line ending will
       raise a fatal exception when mixed newlines are spotted.  Append a "?" will raise a warning instead.

       It is advised to pop any potential ":crlf" or encoding layers before this layer; this is usually done
       using a ":raw" prefix.

       This module also optionally exports a "eol_is_mixed" function; it takes a string and returns the
       position of the first inconsistent line ending found in that string, or 0 if the line endings are
       consistent.

       The "CR", "LF", "CRLF" and "NATIVE" constants are also exported at request.

AUTHORS
       Audrey Tang <autrijus@autrijus.org>.

       Janitorial help by Gaal Yahas <gaal@forum2.org>.

       Inspired by PerlIO::nline by Ben Morrow, <PerlIO-eol@morrow.me.uk>.

COPYRIGHT
       Copyright 2004-2006 by Audrey Tang <audreyt@audreyt.org>.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.

       See <http://www.perl.com/perl/misc/Artistic.html>



perl v5.12.5                                     2006-12-15                                           eol(3)