perlio::eol(3) [osx man page]

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
string
" );

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.16.2							    2006-12-15								    eol(3)

Check Out this Related Man Page

dynamic(3pm)						User Contributed Perl Documentation					      dynamic(3pm)

NAME

       PerlIO::via::dynamic - dynamic PerlIO layers

SYNOPSIS

	open $fh, $fname;
	$p = PerlIO::via::dynamic->new
	 (translate =>
	   sub { $_[1] =~ s/$Filename[:ws-./\]*$/$Filename: $fname$/e},
	  untranslate =>
	   sub { $_[1] =~ s/$Filename[:ws-./\]*$/$Filename$/});
	$p->via ($fh);
	binmode $fh, $p->via; # deprecated

DESCRIPTION

       "PerlIO::via::dynamic" is used for creating dynamic PerlIO layers. It is useful when the behavior or the layer depends on variables. You
       should not use this module as via layer directly (ie :via(dynamic)).

       Use the constructor to create new layers, with two arguments: translate and untranslate. Then use "$p-"via ($fh)> to wrap the handle.  Once
       <$fh> is destroyed, the temporary namespace for the IO layer will be removed.

       Note that PerlIO::via::dynamic uses the scalar fields to reference to the object representing the dynamic namespace.

OPTIONS

       translate
	   A function that translate buffer upon write.

       untranslate
	   A function that translate buffer upon read.

       use_read
	   Use "READ" instead of "FILL" for the layer.	Useful when caller expect exact amount of data from read, and the "untranslate" function
	   might return different length.

	   By default "PerlIO::via::dynamic" creates line-based layer to make "translate" implementation easier.

AUTHORS

       Chia-liang Kao <clkao@clkao.org>

COPYRIGHT

       Copyright 2004 by Chia-liang Kao <clkao@clkao.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.8.8							    2006-03-06							      dynamic(3pm)

Linux and UNIX Man Pages

perlio::eol(3) [osx man page]

Check Out this Related Man Page