perlnewmod - preparing a new module for distribution

NAME perlnewmod - preparing a new module for distribution DESCRIPTION This document gives you some ... Check it's new There are a lot of modules on CPAN, and it's easy to miss one that's similar to what

perlmodlib - constructing new Perl modules and finding existing ones

Try to design the new module to be easy to extend and reuse. ... For example, does your application still work if you change: $obj = new YOURCLASS; into: $obj = new SUBCLASS

perldelta - what is new for perl v5.8.2

NAME perldelta - what is new for perl v5.8.2 DESCRIPTION This document describes differences between

Dumpvalue - provides screen dump of Perl data.

SYNOPSIS use Dumpvalue; my $dumper = new Dumpvalue; $dumper->set(globPrint => 1); $dumper->dumpValue ... ); $dumper->dumpvars('main'); my $dump = $dumper->stringify($some_value); DESCRIPTION Creation A new

Encode::Alias - alias definitions to encodings

=> ENCODING); DESCRIPTION Allows newName to be used as an alias for ENCODING. ... to make the new definition available

Devel::PPPort - Perl/Pollution/Portability

ppport.h Devel::PPPort::WriteFile('someheader.h') ; DESCRIPTION Perl has changed over time, gaining new ... (stash,name,sv) newRV_inc(sv) newRV_noinc(sv) newSVpvn(data,len) NOOP NV NVef NVff NVgf PERL_REVISION

Search::Dict - search for key in dictionary file

Returns the new file position, or -1 if an error occurs.

SelectSaver - save and restore selected file handle

SelectSaver - save and restore selected file handle SYNOPSIS use SelectSaver; { my $saver = new ... SelectSaver; # new handle may be selected, or not } # previous handle is selected DESCRIPTION A

Tie::Scalar - base class definitions for tied scalars

, 'NewScalar'; tie $new_std_scalar, 'NewStdScalar'; DESCRIPTION This module provides some skeletal ... Associates a new scalar instance with the specified class.

Pod::Plainer - Perl extension for converting Pod to old style Pod.

SYNOPSIS use Pod::Plainer; my $parser = Pod::Plainer -> new (); $parser -> parse_from_filehandle(\* ... This can be used to pre-process Pod before using tools which do not recognise the new style Pods.

Tie::Handle - base class definitions for tied handles

NAME Tie::Handle, Tie::StdHandle - base class definitions for tied handles SYNOPSIS package NewHandle ... Associates a new glob instance with the specified class.

Tie::Hash - base class definitions for tied hashes

, 'NewHash'; tie %new_std_hash, 'NewStdHash'; tie %new_extra_hash, 'NewExtraHash', sub {warn "Doing ... Associates a new hash instance with the specified class.

perlthrtut - tutorial on threads in Perl

->new(\&sub1); sub sub1 { print "In the thread\n"; } The new() method takes a reference to a ... create() is a synonym for new().

threads - Perl extension allowing use of interpreter based threads from perl

The new() method is an alias for create(). ... Like threads->new, async returns a thread object.

Encode::PerlIO - Encode::PerlIO -- a detailed document on Encode and PerlIO

If Perl is configured to use the new 'perlio' IO system then Encode provides a "layer" (see PerlIO) which ... iliad.utf8'); my @epic = <$iliad>; print $utf8 @epic; close($utf8); close($illiad); In addition, the new

perlfork - Perl's fork() emulation

and all its state, and run the cloned interpreter in a separate thread, beginning execution in the new ... This limitation can be easily worked around in new code by creating a pipe explicitly.

perlxs - XS language reference manual

then the C++ new function will be called to create a dynamic C++ object. ... color * color::new() The generated C++ code will call new.

perlintro - perlintro -- a brief introduction and overview of Perl

It is intended as a "bootstrap" guide for those who are new to the language, and provides just enough

AnyDBM_File - provide framework for multiple DBMs

This way old programs that used to use NDBM via dbmopen() can still do so, but new ones can reorder @ ... trivial to copy database formats: use POSIX; use NDBM_File; use DB_File; tie %newhash, 'DB_File', $new_filename

perlreftut - Mark's very short tutorial about references

USA: Chicago, New York, Washington. ... , and $aref2 is assigned a reference to the new array.

encoding - allows you to write your script in non-ascii or non-utf8

were still rare and many users instead chose to write scripts in legacy encodings, giving up a whole new

B - The Perl Compiler

The B module is of use to those who want to write new compiler backends.

perlbot - Bag'o Object Tricks (the BOT)

A subclass may want to override that data and replace it with new data. ... bless $self, $type; } package main; $a = Bar->new; $b = Foo->new; $a->enter; $b->enter; INHERITING

Pod::InputObjects - objects representing POD input paragraphs, commands, etc.

It has the following methods/attributes: Pod::Paragraph->new() my $pod_para1 = Pod::Paragraph->new( ... Pod::ParseTree->new() my $ptree1 = Pod::ParseTree->new; my $ptree2 = new Pod::ParseTree; my $ptree4

Pod::ParseUtils - helpers for POD parsing and conversion

The following methods are available: Pod::List->new() Create a new list object. ... The following methods are available: Pod::Cache->new() Create a new cache object.

Math::BigRat - arbitrarily big rationals

new() $x = Math::BigRat->new('1/3'); Create a new Math::BigRat object. ... # BigInt $x = Math::BigRat->new(Math::BigFloat->new('3.1')); # BigFloat $x = Math::BigRat->new(Math

fields - compile-time class fields

{ my $class = shift; my $self = fields::new($class); $self->SUPER::new(); ... The following functions are supported: new perl before 5.9.0: fields::new() creates and blesses

Class::Struct - declare struct-like datatypes as Perl classes

The new class is given a constructor method, new, for creating struct objects. ... Initializing with new struct always creates a constructor called new.

IO::Socket - Object interface to socket communications

(see the Symbol package). new optionally takes arguments, these arguments are in key-value pairs. new ... In a scalar context the new socket is returned, or undef upon failure.

ExtUtils::Packlist - manage .packlist files

The new() method returns a reference to a hash. ... If no file is specified, the .packlist specified to new() will be read.

IO::Select - OO interface to the select system call

CONSTRUCTOR new ( [ HANDLES ] ) The constructor creates a new object and optionally initialises ... $new = $lsn->accept; $sel->add($new); } else { #

perlothrtut - old tutorial on threads in Perl

The simplest, straightforward way to create a thread is with new(): use Thread; $thr = new Thread ... Thread::Semaphore; $GlobalVariable = 0; $thr1 = new Thread \&sample_sub, 1; $thr2 = new Thread \&

perltoot - Tom's object-oriented tutorial for perl

Person::new() is the function that both the Person->new() method and the Employee->new() method end up ... () Person::new("Person") Employee->new() Person::new("Employee") So don't use function

Math::BigInt - Arbitrary size integer math package

Currently, Math::BigInt::new() defaults to 0, while Math::BigInt::new('') results in 'NaN'. ... new $x = Math::BigInt->new($str,$A,$P,$R); Creates a new BigInt object from a scalar or another BigInt

perlapi - autogenerated documentation for the perl public API

SV* newRV_noinc(SV *sv) newSV Create a new null SV, or if len > 0, create a new empty SVt_PV ... SV* newSVnv(NV n) newSVpv Creates a new SV and copies a string into it.

Thread::Semaphore - thread-safe semaphores

NAME Thread::Semaphore - thread-safe semaphores SYNOPSIS use Thread::Semaphore; my $s = new Thread ... FUNCTIONS AND METHODS new new NUMBER new creates a new semaphore, and initializes its count to

IO::Pipe - supply object methods for pipes

NAME IO::Pipe - supply object methods for pipes SYNOPSIS use IO::Pipe; $pipe = new IO::Pipe; if( ... If no arguments are given then method handles is called on the new IO::Pipe object.

CGI::Cookie - Interface to Netscape Cookies

cookies and send them $cookie1 = new CGI::Cookie(-name=>'ID',-value=>123456); $cookie2 = new CGI::Cookie ... Creating New Cookies $c = new CGI::Cookie(-name => 'foo', -value => 'bar

perlxstut - Tutorial for writing XSUBs

new features. ... XPUSHs(sv_2mortal(newSVnv(buf.f_type))); XPUSHs(sv_2mortal(newSVnv(buf.f_fsid[0])));

Thread - manipulate threads in Perl (for old code only)

FUNCTIONS $thread = Thread->new(\&start_sub) $thread = Thread->new(\&start_sub, LIST) new starts ... Like Thread-&gt;new, async returns a thread object.

CGI::Fast - CGI Interface for Fast CGI

time there's a new request, CGI::Fast returns a CGI object to your loop. ... The rest of the time your script waits in the call to new().

IO::File - supply object methods for filehandles

NAME IO::File - supply object methods for filehandles SYNOPSIS use IO::File; $fh = new IO::File; ... CONSTRUCTOR new ( FILENAME [,MODE [,PERMS]] ) Creates an IO::File.

perlguts - Introduction to the Perl API

The seven routines are: SV* newSViv(IV); SV* newSVuv(UV); SV* newSVnv(double); SV* newSVpv(const ... char*, STRLEN); SV* newSVpvn(const char*, STRLEN); SV* newSVpvf(const char*, ...); SV* newSVsv(SV

Test::Tutorial - A tutorial about writing really basic tests

So we test new(). #! ... /usr/bin/perl -w use Test::Simple tests => 2; use Date::ICal; my $ical = Date::ICal->new;

Digest - Modules that calculate message digests

$ctx = Digest->new(XXX => $arg,...) $ctx = Digest::XXX->new($arg,...) ... If new() is called as an instance method (i.e.

perlobj - Perl objects

Here is a typical constructor: package Critter; sub new { bless {} } That word new isn't special. ... The new class is responsible for all cleanup later.

Net::SMTP - Simple Mail Transfer Protocol Client

A new Net::SMTP object must be created with the new method. ... Net::SMTP [ HOST, ] [ OPTIONS ] This is the constructor for a new Net::SMTP object.

IO::Socket::INET - Object interface for AF_INET domain sockets

CONSTRUCTOR new ( [ARGS] ) Creates an IO::Socket::INET object, which is a reference to a newly created ... symbol (see the Symbol package). new optionally takes arguments, these arguments are in key-value pairs

FileHandle - supply object methods for filehandles

NAME FileHandle - supply object methods for filehandles SYNOPSIS use FileHandle; $fh = new FileHandle ... FileHandle::new_from_fd creates a FileHandle like new does.

Net::NNTP - NNTP Client class

post ( [ MESSAGE ] ) Post a new article to the news server. ... postfh () Post a new article to the news server using a tied filehandle.

Term::ReadLine - Perl interface to various readline packages. If no real package is found, substitutes stubs instead of basic functions.

new returns the handle for subsequent calls to following functions. ... newTTY takes two arguments which are input filehandle and output filehandle.

Net::POP3 - Post Office Protocol 3 Client class (RFC1939)

A new Net::POP3 object must be created with the new method. ... CONSTRUCTOR new ( [ HOST, ] [ OPTIONS ] ) This is the constructor for a new Net::POP3 object.

Digest::MD5 - Perl interface to the MD5 Algorithm

The following methods are provided: $md5 = Digest::MD5->new The constructor returns a new Digest ... No new object is created in this case. $md5->reset This is just an alias for $md5->new.

Data::Dumper - stringified perl data structures, suitable for both printing and eval

Same rules apply for names as in new. ... package main; $foo = Foo->new; $fuz = Fuz->new; $boo = [ 1, [], "abcd", \*foo, {1 => 'a',

IPC::Msg - SysV Msg IPC object class

METHODS new ( KEY , FLAGS ) Creates a new message queue associated with KEY. ... On creation of a new message queue FLAGS is used to set the permissions.

perlintern - autogenerated documentation of purely internal Perl functions

void pad_leavemy() pad_new Create a new compiling padlist, saving and updating the various global ... depth, in which case don't bother creating a new one.

perlcall - Perl calling conventions from C

to the variable keepSub in one operation using newSVsv. ... \n") ; PUSHMARK(SP) ; XPUSHs(sv_2mortal(newSViv(fh))) ; XPUSHs(sv_2mortal(newSVpv(buffer

Tie::Array - base class for tied arrays

NAME Tie::Array - base class for tied arrays SYNOPSIS package Tie::NewArray; use Tie::Array; @ISA ... ; $object = tie @somearray,Tie::StdArray; $object = tie @somearray,Tie::NewStdArray; DESCRIPTION This

IPC::Semaphore - SysV Semaphore IPC object class

METHODS new ( KEY , NSEMS , FLAGS ) Create a new semaphore set associated with KEY. ... On creation of a new semaphore set FLAGS is used to set the permissions.

perllol - Manipulating Arrays of Arrays in Perl

That's all well and good for declaration of a fixed data structure, but what if you wanted to add new ... What about adding new columns?

overload - Package for overloading perl operations

Use this module like this: require symbolic; my $iter = new symbolic 2; # 16-gon my $side = new symbolic ... After this change one can do my $a = new symbolic 3; my $b = new symbolic 4; my $c = sqrt($a**2 + $b

Thread::Queue - thread-safe queues

NAME Thread::Queue - thread-safe queues SYNOPSIS use Thread::Queue; my $q = new Thread::Queue; $q- ... FUNCTIONS AND METHODS new The new function creates a new empty queue.

Pod::Parser - base class for creating POD filters and translators

new() my $parser = Pod::Parser->new(); This is the constructor for Pod::Parser and its subclasses. ... (); my $parser2 = new MyParser(); my $parser3 = $parser2->new(); where MyParser is some subclass of

IO::Handle - supply object methods for I/O handles

CONSTRUCTOR new () Creates a new IO::Handle object. ... new_from_fd ( FD, MODE ) Creates an IO::Handle like new does.

Pod::PlainText - Convert POD data to formatted ASCII text

See Pod::Parser for all the details; briefly, one creates a new parser with Pod::PlainText->new() and ... Please change to the new calling convention, though.

IO::Dir - supply object methods for directory handles

NAME IO::Dir - supply object methods for directory handles SYNOPSIS use IO::Dir; $d = IO::Dir->new ... new ( [ DIRNAME ] ) new is the constuctor for IO::Dir objects.

CGI::Push - Simple Interface to Server Push

Every time your subroutine is called, it generates a new page. ... USING CGI::Push CGI::Push adds one new method to the standard CGI suite, do_push().

Math::BigInt::Calc - Pure Perl module to support Math::BigInt

STORAGE METHODS The following functions MUST be defined in order to support the use by Math::BigInt: _new ... (string) return ref to new object from ref to decimal string _zero() return a new object with

Safe - Compile and execute code in restricted compartments

Each compartment has a new namespace The "root" of the namespace (i.e. ... Methods in class Safe To create a new compartment, use $cpt = new Safe; Optional argument is (NAMESPACE

CGI - Simple Common Gateway Interface Class

This feature is new in 2.63. ... '}, "Open a new frame"); <a href="fred.html",target="_new">Open a new frame</a> You may

perltooc - Tom's OO Tutorial for Class Data in Perl

package Some_Class; our($CData1, $CData2); # our() is new to perl5.6 sub new { my $ ... But if you store a new value to them, that new value is set on the current object.

perllexwarn - Perl Lexical Warnings

instead") ; new(@_) ; } sub new ... 1 ; The function open has been deprecated, so code has been ... use Original ; use Derived ; use warnings 'Derived'; my $a = new Original ; $a->doit(1) ; my $b = new

Pod::Text - Convert POD data to formatted ASCII text

See Pod::Parser for all the details; briefly, one creates a new parser with Pod::Text->new() and then ... Please change to the new calling convention, though.

Unicode::Collate - Unicode Collation Algorithm

Unicode Collation Algorithm SYNOPSIS use Unicode::Collate; #construct $Collator = Unicode::Collate->new ... Constructor and Tailoring The new method returns a collator object.

Net::Ping - check a remote host for reachability

NAME Net::Ping - check a remote host for reachability SYNOPSIS use Net::Ping; $p = Net::Ping->new ... Functions Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos ]]]]]); Create a new

perlhack - How to hack at the Perl internals

Does it potentially introduce new bugs? ... So, we call newBINOP to create a new binary operator.

perltie - how to hide an object class in a simple variable

$new_nicety = PRIO_MIN; } if ($new_nicety > PRIO_MAX) { carp sprintf "WARNING ... $new_nicety = PRIO_MAX; } unless (defined setpriority(PRIO_PROCESS, $$self, $new_nicety)) {

Pod::LaTeX - Convert Pod data to formatted Latex

Pod::LaTeX - Convert Pod data to formatted Latex SYNOPSIS use Pod::LaTeX; my $parser = Pod::LaTeX->new ... $parser->StartWithNewPage(1); $newpage = $parser->StartWithNewPage; Default is false.

I18N::Collate - compare 8-bit scalar data according to the current locale

current locale SYNOPSIS use I18N::Collate; setlocale(LC_COLLATE, 'locale-of-your-choice'); $s1 = new ... I18N::Collate "scalar_data_1"; $s2 = new I18N::Collate "scalar_data_2"; DESCRIPTION *** WARNING:

perlopentut - tutorial on opening things in Perl

That takes away the user's freedom to choose what permission new files will have. ... ; IO Layers In Perl 5.8.0 a new I/O framework called "PerlIO" was introduced.

perl5db - the perl debugger

debugger, we need to be able to get a new IN and OUT filehandle for the new debugger. ... create_IN_OUT($flags) Create a new pair of filehandles, pointing to a new TTY.

ExtUtils::Installed - Inventory management of installed modules

management of installed modules SYNOPSIS use ExtUtils::Installed; my ($inst) = ExtUtils::Installed->new ... FUNCTIONS new() This takes no parameters, and searches for all the installed .packlists on the system

Test::Harness::Straps - detailed analysis of test results

analysis of test results SYNOPSIS use Test::Harness::Straps; my $strap = Test::Harness::Straps->new ... Construction new my $strap = Test::Harness::Straps->new; Initialize a new strap.

File::Copy - Copy files or filehandles",\*STDOUT); move("/dev1/fileA","/dev2/fileB"); use POSIX; use File::Copy cp; $n = FileHandle->new ... Otherwise, it copies the file to the new location and deletes the original.

Net::Netrc - OO interface to users netrc file

The following tokens are recognized; they may be separated by spaces, tabs, or new-lines: machine ... new object.

Test::Harness::Iterator - Internal Test::Harness Iterator

SYNOPSIS use Test::Harness::Iterator; use Test::Harness::Iterator; my $it = Test::Harness::Iterator->new ... (\*TEST); my $it = Test::Harness::Iterator->new(\@array); my $line = $it->next; DESCRIPTION FOR INTERNAL

perldsc - Perl Data Structures Cookbook

reference with a new copy of the data. ... (keys %new_folks) { $HoH{flintstones}{$what} = $new_folks{$what}; } Access and Printing of a HASH

Test::Simple - Basic utilities for writing tests.

my $btaste = Film->new({ Title => 'Bad Taste', Director => 'Peter Jackson ... kitchen one night about the problems I was having writing some really complicated feature into the new

Pod::Man - Convert POD data to formatted *roff input

Pod::Man - Convert POD data to formatted *roff input SYNOPSIS use Pod::Man; my $parser = Pod::Man->new ... See Pod::Parser for all the details; briefly, one creates a new parser with Pod::Man->new() and then

Net::libnetFAQ - libnet Frequently Asked Questions

/your/path/to/perl # a module making life easier use Net::FTP; # for debuging: $ftp = Net::FTP->new ... $ftp = Net::FTP->new(''); $ftp->login('username','password'); # set transfer

POSIX - Perl interface to IEEE Std 1003.1

Create a new SigSet object. ... Create a new Termios object.

Encode::Encoder - Encode::Encoder -- Object Oriented Encoder

Oriented Encoder SYNOPSIS use Encode::Encoder; # Encode::encode("ISO-8859-1", $data); Encode::Encoder->new ... encoder() is an alias of Encode::Encoder->new(). This one is exported on demand.

perlsub - Perl subroutines

This is an efficiency mechanism that new users may wish to avoid. ... The prototype affects only interpretation of new-style calls to the function, where new-style is defined

B::Terse - Walk Perl syntax tree, printing terse info about ops

The B::SV method is largely compatible with the old one, though authors of new software might be advised ... As a kludge, the new version will always use the pad for the main program, but for OPs in subroutines

Win32 - Interfaces to some Win32 API Functions

Calling SetChildShowWindow(0) will make these new console windows invisible. ... The pid of the new process is stored in PID. This function is deprecated.

Benchmark - benchmark running times of Perl code

Example: use Benchmark; $t0 = new Benchmark; # ... your code here ... ... Make sub new dump its debugging output to STDERR, to be consistent with everything else.

perlipc - Perl interprocess communication (signals, fifos, pipes, safe subprocesses, sockets, and semaphores)

file, the reading program will block and your program will supply the new signature. ... (Actually, some of the new Socket conversion functions croak() on bad arguments.)

Math::BigFloat - Arbitrary size floating point math package

floating point math package SYNOPSIS use Math::BigFloat; # Number creation $x = Math::BigFloat->new ... The old code would return '+1.23', the new returns '1.23'.

Encode - character encodings

(newName => ENCODING); After that, newName can be used as an alias for ENCODING. ... Defining Encodings To define a new encoding, use: use Encode qw(define_encoding); define_encoding($

Net::FTP - FTP Client class

CONSTRUCTOR new (HOST [,OPTIONS]) This is the constructor for a new Net::FTP object. ... Returns the full pathname to the new directory.

perlgpl - the GNU General Public License, version 2

The Free Software Foundation may publish revised and/or new versions of the General Public License from ... new problems or concerns.

IO::Socket::UNIX - Object interface for AF_UNIX domain sockets

CONSTRUCTOR new ( [ARGS] ) Creates an IO::Socket::UNIX object, which is a reference to a newly created ... symbol (see the Symbol package). new optionally takes arguments, these arguments are in key-value pairs

ExtUtils::MakeMaker - Create a module Makefile

Static Linking of a new Perl Binary An extension that is built with the above steps is ready to use ... If you want to force the creation of a new perl, it is recommended, that you delete this Makefile.aperl

perltodo - Perl TO-DO List

Constructs to consider, at the very least: use utf8; package UnicodePackage; sub new { bless {}, shift ... Automate module testing on CPAN When a new Perl is being beta tested, porters have to manually grab

Shell - run shell commands transparently within perl> To: From: Larry Wall <> Subject: a new ... use Shell; my $sh = Shell->new; print $sh->ls; Casey AUTHOR Larry Wall Changes by

Tie::File - Access the lines of a disk file via a Perl array

recs...; my $r1 = pop @array; unshift @array, new recs...; my $r2 = shift @array; @old_recs = splice ... @array, 3, 7, new recs...; untie @array; # all finished DESCRIPTION Tie::File represents

perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.

OS2::_control87(new,mask) the same as _control87(3) of EMX. ... dll to the "new" perl????.dll.

perlembed - how to embed perl in your C program

) and newAV() and all their friends. ... Since perl 5.7.2 you can specify PL_exit_flags |= PERL_EXIT_DESTRUCT_END to get the new behaviour.

Test::Builder - Backend for building test libraries

Construction new my $Test = Test::Builder->new; Returns a Test::Builder object representing the ... No matter how many times you call new(), you're getting the same object.

perldos - Perl under DOS, W31, W95.* You need the following files to build perl (or add new ... the perl binary in your module directory before you run "make test", so that you are testing with the new

s2p - a stream editor

[1addr]q Branch to the end of the script and quit without starting a new cycle. ... p If the substitution was made, print the new value of the pattern space.

psed - a stream editor

[1addr]q Branch to the end of the script and quit without starting a new cycle. ... p If the substitution was made, print the new value of the pattern space.

Math::Complex - complex numbers and associated mathematical functions

Otherwise whatever you specify will be the new display style for this particular number. ... $j->display_format("polar"); There are two new display parameters.

perlmodstyle - Perl module style guide

Avoid starting a new top-level hierarchy, especially if a suitable hierarchy already exists under which ... according to data type (making polymorphic invocation of methods feasible) When it is likely that new

perlmachten - Perl version 5 on Power MachTen systems

which compiles to object code for linking with perl), you will have to replace your perl binary with a new ... version containing the new statically-linked object module.

NEXT - Provide a pseudo-class NEXT (et al) that allows method redispatch

Note that this is not the same thing as $self->SUPER::m(), which begins a new dispatch that is restricted ... Likewise, to create a class hierarchy in which every initializer inherited by a new object is invoked

perltrap - Perl traps for the unwary

Parsing Traps Traps that appear to stem from the new parser. ... @x = ('existing'); print push(@x, 'first new', 'second new'); # perl4 prints: second new # perl5 prints

Locale::Maketext::TPJ13 - Locale::Maketext::TPJ13 -- article about software localization

When you call: print $lang->maketext("You have [quant,_1,piece] of new mail. ... So, this: $lang->maketext("You have [quant,_1,piece] of new mail.

perlref - Perl references and nested data structures

Constructors are often named new() and called indirectly: $objref = new Doggie (Tail => 'short', Ears ... Its disadvantage is that it won't create a new filehandle for you.

File::Temp - return name and handle of a temporary file safely

File::Temp($template); $fname = $fh->filename; $tmp = new File::Temp( UNLINK => 0, SUFFIX => '.dat' ... new Create a temporary file object.

Memoize::Expire - Plug-in module for automatic expiration of memoized values (for news and updates) I maintain a mailing list on which I ... occasionally announce new versions of Memoize.

h2xs - convert .h C header files to Perl extensions

called without additional arguments; and will set the element to the supplied value (and return the new ... method to construct and return a new structure, initialised to zeroes.

Pod::Checker - check pod documents for syntax errors

SYNOPSIS use Pod::Checker; $syntax_okay = podchecker($filepath, $outputpath, %options); my $checker = new ... Pod::Checker->new( %options ) Return a reference to a new Pod::Checker object that inherits from Pod

perlboot - Beginner's Object-Oriented Tutorial

We can do that by drawing a new distinction, called an "instance". ... , with various ways of interpreting the arguments to new.

Test::More - yet another framework for writing test scripts

otherwise have to write my $obj = Some::Module->new; ok( defined $obj && $obj->isa('Some::Module') ... Test::Harness upgrades no_plan and todo depend on new Test::Harness features and fixes.

ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker

Defines how to write the Makefile to produce a static new perl. ... {lc $var}, it will attempt to replace it's $prefix with a $new_prefix.

B::Concise - Walk Perl syntax tree, printing concise info about ops

styles and new variables. ... If you have a new variable in your style, or you want to change the value of an existing variable, you

DB_File - Perl5 access to Berkeley DB version 1.x

$a = new DB_File::HASHINFO ; $a->{'bsize'} ; $a->{'cachesize'} ; $a->{'ffactor'}; $a->{'hash'} ; $a-> ... $i = 2 ; $H->put($i, "Newbie", R_IAFTER) ; # and a new record before record 1.

Devel::DProf - a Perl code profiler

New $over_* values show the measured overhead of making $over_tests calls to the profiler These values ... The lines starting with & introduce new subroutine id and show the package and the subroutine name of

Locale::Maketext - framework for localization

$lh->init(); This is called by ->new to initialize newly-constructed language handles. ... coderef, and then we return &$new_sub($lh, ...parameters...).

Memoize - Make functions faster by trading space for time

.); Options include: NORMALIZER => function INSTALL => new_name SCALAR_CACHE => 'MEMORY' SCALAR_CACHE ... See the Page at for news and upgrades.

perlfunc - Perl builtin functions

\n" unless chdir '/usr/spool/news'; chdir '/usr/spool/news' or die "Can't cd to spool: $! ... Returns the new number of elements in the array.

B::Deparse - Perl compiler backend to produce perl code

USING B::Deparse AS A MODULE Synopsis use B::Deparse; $deparse = B::Deparse->new("-p", "-sC"); $body ... new $deparse = B::Deparse->new(OPTIONS) Create an object to store the state of a deparsing operation

DynaLoader - Dynamically load C libraries into Perl code

This document serves as both a specification for anyone wishing to implement the DynaLoader for a new ... This is simply a direct call to newXSUB(). Returns a reference to the installed function.

perlmod - Perl modules (packages and symbol tables)

This also helps to differentiate new modules from old .pl and .ph files. ... It will be called in the context of the new thread, so all modifications are made in the new area.

ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass

ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass SYNOPSIS require ExtUtils::MM; my $mm = MM->new

CPAN - query, download and build perl modules from CPAN sites

If you're new to, you probably should investigate if CPANPLUS is the better choice for you. ... Bundle/, install the new perl with the Configure option prefix, e.g. .

DirHandle - supply object methods for directory handles

NAME DirHandle - supply object methods for directory handles SYNOPSIS use DirHandle; $d = new DirHandle

ExtUtils::Miniperl - write the C code for perlmain.c

of directories containing archive libraries that relate to perl modules and should be linked into a new

Pod::Select - extract selected sections of POD from input

or use Pod::Select; ## Create a parser object for selecting POD sections from the input $parser = new ... Private data fields are stored in the hash-object whose reference is returned by the new() constructor

perltru64 - Perl version 5 on Tru64 (formerly known as Digital UNIX formerly known as DEC OSF/1) systems

Threaded Perl on Tru64 If you want to use threads, you should primarily use the new Perl 5.8.0 threads ... The good news is that you very probably don't need to ever use the ODBM_File extension since more advanced

perlclib - Internal replacements for standard C library functions

Don't forget that with the new PerlIO layered I/O abstraction FILE* types may not even be available. ... and String Handling Instead Of: Use: t* p = malloc(n) New

Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing

Upon tying a new hash to this package, the developer must specify the size of the keys that will be used

libnetcfg - configure libnet

The default name of the new configuration file is "libnet.cfg", and by default it is written to the current

Pod::Text::Color - Convert POD data to formatted color ASCII text

data to formatted color ASCII text SYNOPSIS use Pod::Text::Color; my $parser = Pod::Text::Color->new

CGI::Carp - CGI routines for writing to the HTTPD (or other) error log

To enable this feature, export the new "warningsToBrowser" subroutine. ... you've done that, you can change the logged name of the program at any time by calling set_progname(new_program_name

Pod::Text::Termcap - Convert POD data to ASCII text with format escapes

ASCII text with format escapes SYNOPSIS use Pod::Text::Termcap; my $parser = Pod::Text::Termcap->new

Test - provides a simple framework for writing test scripts

QUICK START GUIDE To write a test for your new (and probably not even done) module, create a new file ... called t/test.t (in a new t directory).

Pod::Text::Overstrike - Convert POD data to formatted overstrike text

formatted overstrike text SYNOPSIS use Pod::Text::Overstrike; my $parser = Pod::Text::Overstrike->new

perldebug - Perl debugging

If you're new to the Perl debugger, you may prefer to read perldebtut, which is a tutorial introduction ... R Restart the debugger by exec()ing a new session.

Fcntl - load the C Fcntl.h defines

For new applications the newer versions of these constants are suggested (O_APPEND, O_ASYNC, O_CREAT,

IO::Poll - Object interface to system poll call

interface to system poll call SYNOPSIS use IO::Poll qw(POLLRDNORM POLLWRNORM POLLIN POLLHUP); $poll = new

IO::Seekable - supply seek based methods for I/O objects

confuse most perl IO operators except sysread and syswrite (see perlfunc for full details) Returns the new

NDBM_File - Tied access to ndbm files

The default permissions to use if a new file is created.

ODBM_File - Tied access to odbm files

The default permissions to use if a new file is created.

perlhpux - Perl version 5 on Hewlett-Packard Unix (HP-UX) systems

Itanium Processor Family and HP-UX HP-UX also runs on the new Itanium processor. ... Insert the new formula into the Formula/Value box.

SDBM_File - Tied access to sdbm files

The default permissions to use if a new file is created.

perlvms - VMS-specific documentation for Perl

extensions are incorporated directly into PerlShr.Exe, you'll have to rebuild Perl to incorporate a new ... Then, rebuild PerlShr.Exe to incorporate the new code.

piconv - piconv -- iconv(1), reinvented in perl

perlio The new perlIO layer is used. NI-S' favorite.

warnings - Perl pragma to control optional warnings

use warnings::register Creates a new warnings category with the same name as the package where the

Filter::Util::Call - Perl Source Filter Utility Module

this command: :/start/,/stop/s/from/to/ When used as a filter we want to invoke it like this: use NewSubst ... package NewSubst ; use Filter::Util::Call ; use Carp ; sub import { my ($self, $start, $stop, $

perlapio - perl's IO abstraction interface.

Perl prefers to dup the new low-level descriptor to the descriptor used by the existing PerlIO. ... The fact that such a FILE * has been 'exported' is recorded, (normally by pushing a new :stdio "layer

Carp - warn of errors (from perspective of caller)

The ability to override what @ISA says is new in 5.8. The trust in item 2 is transitive.

perlvar - Perl predefined variables

The methods each take an optional EXPR, which, if supplied, specifies the new value for the IO::Handle ... This is a new mechanism and the details may change.

Hash::Util - A selection of general-utility hash subroutines

Zero means the "traditional" random hash ordering, non-zero means the new even more random hash ordering

perllocale - Perl locale handling (internationalization and localization)

If you make the new settings permanent (read on), all programs you run see the changes. ... This module is now mildly obsolete and should be avoided in new applications.

ExtUtils::Install - install files from here to there

Input is the contents of the module, output the new module contents.

Test::Harness - run perl standard test scripts with statistics

HARNESS_FILELEAK_IN_DIR When set to the name of a directory, harness will check after each test whether new ... (Partially done with new skip test styles) Deal with VMS's "not \nok 4\n" mistake.

Switch - A switch statement for Perl

The module augments the standard Perl syntax with two new control statements: switch and case. ... Together these two new statements provide a fully generalized case mechanism: use Switch; # AND LATER

perl - Practical Extraction and Report Language

If you're new to Perl, you should start with perlintro, which is a general intro for beginners and provides ... perlmodinstall Perl modules: how to install from CPAN perlnewmod Perl modules: preparing a new

perlepoc - Perl for EPOC

Since the port to epocemx is quite new, please check the web for updates first.

Storable - persistence for Perl data structures

Internal version numbers are increased each time new data types (such as restricted hashes) are added ... Hence this Storable defaults to the new, correct behaviour.

perlsyn - Perl syntax

It's safer because if code gets added between the inner and outer loops later on, the new code won't ... While it's expecting the beginning of a new statement, if the compiler encounters a line that begins

perlmodinstall - Installing CPAN Modules

reason you have a statically-linked perl, and the module requires compilation, you'll need to build a new ... You can add new paths to the default @INC in the Preferences menu item in the MacPerl application ($ENV

find2perl - translate find command lines to Perl code

-ncpio FILE Adds current output to "new"-style cpio-format FILE.

perlmpeix - Perl/iX for HP e3000 MPE

What's New in Perl for MPE/iX June 1, 2000 Rebuilt to be compatible with mod_perl. ... Check here for the latest news, implemented functionality, known bugs, to-do list, etc.

I18N::LangTags - functions for dealing with RFC3066-style language tags

thing doesn't matter, nor does case) is_dialect_of('nn', 'no') is TRUE (because 'nn' (New ... Note that this function does not try to equate new (and never-used, and unusable) ISO639-2 three-letter

I18N::LangTags::List - I18N::LangTags::List -- tags and names for human languages

NOT New York Seneca! [{mis} : Miscellaneous languages] Don't use this. ... {new} : Newari {nia} : Nias [{nic} : Niger-Kordofanian (Other)] [{ssa} : Nilo-Saharan (Other

ExtUtils::Manifest - utilities to write and check a MANIFEST file

MANIFEST file is preserved, including any comments that are found in the existing MANIFEST file in the new

perlirix - Perl version 5 on Irix systems

Building with threads in Irix Run Configure with -Duseithreads which will configure Perl with the new

Term::Cap - Perl termcap interface

EXAMPLES use Term::Cap; # Get terminal output speed require POSIX; my $termios = new POSIX::Termios

ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications

xsi_body(@modules) This function returns a string of calls to newXS() that glue the module bootstrap

perlutil - utilities packaged with the Perl distribution

for converting other languages, the pl2pm utility will help you convert old-style Perl 4 libraries to new-style

AutoLoader - load subroutines only on demand

Any old modules which use AutoLoader should be changed to the new calling style.

Getopt::Long - Extended processing of command line options

This was the first Perl module that provided support for handling the new style of command line options ... Configuration options can be passed to the constructor: $p = new Getopt::Long::Parser config

perlsolaris - Perl version 5 on Solaris systems

for a different version of Solaris than you are running, then you will need to rebuild gcc for your new ... Versions newer than 2.7 are apparently new enough.

perlrun - how to execute the Perl interpreter

be used as a temporary development aid while securing legacy code: for real production code and for new ... This switch has been superseded in favor of the new Perl code generator backends to the compiler.

charnames - define character names for \N{named} string literal escapes

compatibility one can use the old names for certain C0 and C1 controls old new

perlnetware -

(Typically under the c:\perl folder) Build new extensions To build extensions other than standard extensions

perlsec - Perl security

Unicode Unicode is a new and complex technology and one may easily overlook certain security pitfalls ... One possible reason for wanting to emulate the old behaviour is that in the new behaviour consecutive

perldata - Perl data types

Another use for typeglobs is to pass filehandles into a function or to create new filehandles. ... In other words, *FH must be used to create new symbol table entries; *foo{THING} cannot.

perlstyle - Perl style guide

Use the new "and" and "or" operators to avoid having to parenthesize list operators so much, and to reduce

perlfilter - Source Filters

If the parser encounters a require or use statement in a source stream, a new and distinct stream is ... is parsed: cpp_test ---> cpp filter ---> parser (INACTIVE) ----> parser As you can see, a new

Locale::Country - ISO codes for country identification (ISO 3166)

alias_code Define a new code as an alias for an existing code: Locale::Country::alias_code( ALIAS =

ExtUtils::MM_VMS - methods to override UN*X behaviour in ExtUtils::MakeMaker

makeaperl (override) Undertake to build a new set of Perl images using VMS commands.

perlbs2000 - building and installing Perl for BS2000.

Using PerlIO and different encodings on ASCII and EBCDIC partitions Since version 5.8 Perl uses the new

enc2xs - enc2xs -- Perl Encode Module Generator

Quick Guide If you want to know as little about Perl as possible but need to add a new encoding, just

perldebguts - Guts of Perl debugging

They are just the first argument given to the perl memory allocation API named New(). ... Big allocations with this Id correspond to allocations of new arenas to keep HE. 602 Creates a GP

perlunicode - Unicode support in Perl

strings operating under byte semantics and strings with Unicode character data are concatenated, the new ... There is a new U specifier that converts between Unicode characters and code points.

perlform - Perl formats

format: $value =~ tr/\n\t\f/ /; The remaining whitespace character, \r, forces the printing of a new

perlport - Writing portable Perl

The good news is that at least some DBM module should be available, and AnyDBM_File will use whichever ... These CPAN testers are notified by mail of each new upload, and reply to the list with PASS, FAIL, NA

Opcode - Disable named opcodes when compiling perl code

To create new filehandles other ops such as open would need to be enabled.

perldiag - various Perl diagnostics

You must put parentheses around the filehandle, or use the new "or" operator instead of "||". ... Reference miscount in sv_replace() (W internal) The internal sv_replace() function was handed a new

Text::Balanced - Extract delimited text sequences from strings.

gen_extract_tagged (Note: This subroutine is only available under Perl5.005) gen_extract_tagged generates a new ... (whereas extract_tagged has to effectively rebuild its tag parser on every call); make use of the new

perluniintro - Perl Unicode introduction

All features that combine Unicode and I/O also require using the new PerlIO feature. ... NOTE: the :utf8 and :encoding features work only if your Perl has been built with the new PerlIO feature

perlop - Perl operators and precedence

. $_ = <<'EOL'; $url = new URI::URL "http://www/"; die if $url eq "xXx"; EOL LOOP: { ... is: chmod 0644, <*.c>; A (file)glob evaluates its (embedded) argument only when it is starting a new

perlre - Perl regular expressions

Suppose that we want to enable a new RE escape-sequence \Y| which matches at boundary between white-space ... } { $rules{$1} or invalid($re,$1) }sgex; return $re; } Now use customre enables the new

perlpodspec - Plain Old Documentation: format specification and notes

If you think that you want to add a new command to Pod (like, say, a "=biblio" command), consider whether ... items, "Neque", "Porro", and "Quisquam Est", followed by a paragraph explaining them all, and then a new

perlretut - Perl regular expressions tutorial

In Part 2, we will assume you are comfortable with the basics and concentrate on the new features. ... These are extensions to the traditional regular expression syntax that provide powerful new tools for

perlebcdic - Considerations for running Perl on EBCDIC platforms

Using Encode Starting from Perl 5.8 you can use the standard new module Encode to translate from EBCDIC ... Since version 5.8 Perl uses the new PerlIO I/O library.

perliol - C API for Perl's implementation of IO in Layers.

least the size of PerlIOl, PerlIO_pushed will allocate memory for the layer's data structures and link new

perlpacktut - tutorial on pack and unpack

required to work on older Perls you'll need to unpack( 'Z* Z* C') to get the length, then use it to make a new

Config - access Perl configuration information

This may be useful for making a test installation of a new version without disturbing the existing installation