feature - Perl pragma to enable new features

NAME feature - Perl pragma to enable new features SYNOPSIS use feature qw(switch say); given ($foo ... New syntactic constructs, or new semantic meanings to older constructs, can be enabled by use feature

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

perldelta - what is new for perl v5.12.4

NAME perl5124delta - what is new for perl v5.12.4 DESCRIPTION This document describes differences ... Platform Specific Notes Linux Support Ubuntu 11.04's new multi-arch library layout.

perlmodlib - constructing new Perl modules and finding existing ones

Try to design the new module to be easy to extend and reuse. ... ->new(); ?

CPANPLUS::Selfupdate - CPANPLUS::Selfupdate

( $backend_object ); Sets up a new selfupdate object. ... Called automatically when a new backend object is created.

Dumpvalue - provides screen dump of Perl data.

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

TAP::Parser::Scheduler - Schedule tests during parallel testing

VERSION Version 3.17 SYNOPSIS use TAP::Parser::Scheduler; DESCRIPTION METHODS Class Methods new ... my $sched = TAP::Parser::Scheduler->new; Returns a new TAP::Parser::Scheduler object.

perlreapi - perl regular expression plugin interface

It's up to the engine to make sure this is used as the new value (or reject it). ... pattern instead of compiling a new one.

Encode::Alias - alias definitions to encodings

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

Search::Dict - search for key in dictionary file

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

Devel::PPPort - Perl/Pollution/Portability

newRV_inc newRV_noinc newSV_type newSVpvn newSVpvn_flags newSVpvn_share newSVpvn_utf8 newSVpvs newSVpvs_flags ... newATTRSUB newXS newXSproto new_collate new_ctype new_numeric op_dump perl_parse pmop_dump re_intuit_string

SelectSaver - save and restore selected file handle

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

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::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.

Tie::Handle - base class definitions for tied handles

NAME Tie::Handle - base class definitions for tied handles SYNOPSIS package NewHandle; require Tie ... 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.

threads - Perl interpreter-based threads

5.8, thread programming has been available using a model called interpreter threads which provides a new ... $old_size = threads->set_stack_size($new_size); Sets a new default per-thread stack size, and returns

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

perlunitut - Perl Unicode Tutorial

This means that programmers need new habits. ... Your new toolkit Add to your standard heading the following line: use Encode qw(encode decode); Or

Test::Harness - Run Perl standard test scripts with statistics

If you're writing new code consider using TAP::Harness directly instead.

perlmroapi - Perl method resolution plugin interface

NAME perlmroapi - Perl method resolution plugin interface DESCRIPTION As of Perl 5.10.1 there is a 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.

XS::APItest::KeywordRPN - write arithmetic expressions in RPN

calcrpn $triangle { $n $n 1 + * 2 / } DESCRIPTION This module supplies plugged-in keywords, using the new

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

version - Perl extension for Version Objects

Version 0.77 introduces the new 'parse' and 'declare' methods to standardize usage. ... and wish to switch to a dotted-decimal $VERSION, then you need to make a one-time conversion to the new

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 ... strings operating under byte semantics and strings with Unicode character data are concatenated, the new

B - The Perl Compiler Backend

The B module is of use to those who want to write new compiler backends. ... B::FM For 5.11.0 and later, B::RV is abolished, and IVs can be used to store references, and a new

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

Math::BigRat - Arbitrary big rational numbers

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

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.

version::Internals - Perl extension for Version Objects

: $v1 = version->new(12.3); $v2 = version->new($v1); or as an object method: $v1 = version->new(12.3 ... NOTE: if you create a new object using an existing object like this: $v2 = $v1->new(); the new object

TAP::Object - Base class that provides common functionality to all TAP::* modules

METHODS Class Methods new Create a new object. ... Any arguments passed to new will be passed on to the "_initialize" method. Returns a new object.

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

Archive::Tar::File - a subclass for in-memory extracted file from Archive::Tar

Archive::Tar::File->new( data => $path, $data, $opt ) Returns a new Archive::Tar::File object from data ... $bool = $file->rename( $new_name ) Rename the current file to $new_name.

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.

perlapi - autogenerated documentation for the perl public API


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 { #

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.

Math::BigInt - Arbitrary size integer/float math package

new() $x = Math::BigInt->new($str,$A,$P,$R); Creates a new BigInt object from a scalar or another BigInt ... batan2() my $x = Math::BigInt->new(1); my $y = Math::BigInt->new(1); print $y->batan2($x), "\n"; Calculate

Math::BigFloat - Arbitrary size floating point math package

->new( 1 )->batan2( 1 ,100); # batan(1) my $atan2 = Math::BigFloat->new( 1 )->batan2( 8 ,100); # ... batan2() my $y = Math::BigFloat->new(2); my $x = Math::BigFloat->new(3); print $y->batan2($x), "\n";

TAP::Harness - Run test scripts with statistics

], ) my $harness = TAP::Harness->new( \%args ); The constructor returns a new TAP::Harness object. ... my $formatter = TAP::Formatter::Console->new; my $ser_harness = TAP::Harness->new( { formatter => $

perlce - Perl for WinCE

XS The following Win32-Methods are built-in: newXS("Win32::GetCwd", w32_GetCwd, file); newXS("Win32 ... , file); newXS("Win32::IsWinCE", w32_IsWinCE, file); newXS("Win32::CopyFile", w32_CopyFile, file); newXS

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.

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

CGI::Cookie - Interface to Netscape Cookies

Cookie - Interface to Netscape Cookies SYNOPSIS use CGI qw/:standard/; use CGI::Cookie; # Create new ... cookies and send them $cookie1 = new CGI::Cookie(-name=>'ID',-value=>123456); $cookie2 = new CGI::Cookie

TAP::Parser::IteratorFactory - Internal TAP::Parser Iterator

METHODS Class Methods new Creates a new factory class. ... make_process_iterator Make a new process iterator and return it.

Archive::Extract - A generic archive extracting mechanism

See the new() method for details. ... See the new() method for details.

Digest - Modules that calculate message digests

Digest->new("SHA-1"); $sha256 = Digest->new("SHA-256"); $sha384 = Digest->new("SHA-384"); $sha512 = Digest ... $ctx = Digest->new(XXX => $arg,...) $ctx = Digest::XXX->new($arg,...)

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.

TAP::Parser - Parse TAP output

my $parser = TAP::Parser->new(\%args); Returns a new TAP::Parser object. ... See "new" for more details.

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::Fast - CGI Interface for Fast CGI

The rest of the time your script waits in the call to new(). ... When the server requests that your script be terminated, new() will return undef.

Object::Accessor - interface to create per object accessors

METHODS $object = Object::Accessor->new( [ARGS] ); Creates a new (and empty) Object::Accessor object ... Any arguments given to new are passed straight to mk_accessors.

Module::Pluggable - automatically give your module the ability to have plugins

In general this will probably be 'new' but it can be whatever you want. ... $self->search_path( add => "New::Path" ); # add $self->search_path( new => "New::Path" ); # replace

File::GlobMapper - Extend File Glob to Allow Input and Output Files

= $old; $new =~ s#(.*)\.tar\.gz$#$1.tgz# ; rename $old => $new or die "Cannot rename ... '$old' to '$new': $!

Module::Build::Cookbook - Examples of Module::Build Usage

(): my $build = Module::Build->new ( ... ... To do this, use the install_path parameter to the new() method: my $build = Module::Build->new (

Net::SMTP - Simple Mail Transfer Protocol Client

A new Net::SMTP object must be created with the new method. ... Use "Debug => 1" option under new() to see if disabled.

CPANPLUS::Configure - CPANPLUS::Configure

METHODS $Configure = CPANPLUS::Configure->new( load_configs => BOOL ) This method returns a new object ... be examined again to see if there are new config files that could be read.

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.

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

TAP::Formatter::Base - Harness output delegate for default console output

Class Methods new my %args = ( verbose => 1, ) my $harness = TAP::Formatter::Console->new( \%args ... open_test Called to create a new test session.

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;

perlxstut - Tutorial for writing XSUBs

new features. ... rh = (HV *)sv_2mortal((SV *)newHV()); hv_store(rh, "f_bavail", 8, newSVnv(buf.f_bavail),

perlintern - autogenerated documentation of purely internal Perl functions

newGIVWHENOP newGP newMADPROP newMADsv newTOKEN new_constant new_he ... new_logop new_warnings_bitfield next_symbol nextargv nextchar no_bareword_allowed

Thread::Semaphore - Thread-safe semaphores

describes Thread::Semaphore version 2.09 SYNOPSIS use Thread::Semaphore; my $s = Thread::Semaphore->new ... METHODS ->new() ->new(NUMBER) new creates a new semaphore, and initializes its count to the specified

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

ExtUtils::Installed - Inventory management of installed modules

management of installed modules SYNOPSIS use ExtUtils::Installed; my ($inst) = ExtUtils::Installed->new ... See the 'default' option to new() for details. new() This takes optional named parameters.

Module::Build::Bundling - How to bundle Module::Build with a distribution

This ensures that all necessary features are available as well as any new bug fixes. ... This is done using the new inc::latest module.

FileHandle - supply object methods for filehandles

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

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

(string) return ref to new object from ref to decimal string _zero() return a new object ... with value 0 _one() return a new object with value 1 _two() return a new object with

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.

TAP::Parser::YAMLish::Writer - Write YAMLish data

one => 1, two => 2, three => [ 1, 2, 3 ], }; my $yw = TAP::Parser::YAMLish::Writer->new ... METHODS Class Methods new my $writer = TAP::Parser::YAMLish::Writer->new; The constructor new creates

CPANPLUS::Module::Fake - CPANPLUS::Module::Fake

NAME CPANPLUS::Module::Fake SYNOPSIS my $obj = CPANPLUS::Module::Fake->new( module => ... It can take more options (same as CPANPLUS::Module->new but the above are required.

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, 0

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.

Log::Message - A generic message storing mechanism;

mechanism; SYNOPSIS use Log::Message private => 0, config => '/our/cf_file'; my $log = Log::Message->new ... The default is to return the newest ones first Methods new This creates a new Log::Message object

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.

TAP::Parser::ResultFactory - Factory for creating TAP::Parser output objects

METHODS Class Methods new Creates a new factory class. ... TAP::Parser::Result->new is never called, $tokens are reblessed.

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.

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 ] 0 This is the constructor for a new Net::POP3 object.

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::SharedMem - SysV Shared Memory IPC object class

METHODS new ( KEY , SIZE , FLAGS ) Creates a new shared memory segment associated with KEY. ... On creation of a new shared memory segment 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?

Module::Build::Authoring - Authoring Module::Build modules

something like the following code will typically be used: use Module::Build; my $build = Module::Build->new ... get away with something as short as this for its Build.PL script: use Module::Build; Module::Build->new

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.



Digest::SHA - Perl extension for SHA-1/224/256/384/512

OOP style new($alg) Returns a new Digest::SHA object. ... Invoking new as an instance method will not create a new object; instead, it will simply reset the object

Win32API::File - Low-level access to Win32 system API calls for files/dirs.

"n" Stands for "New file only". ... MoveFileW MoveFileW( $swOldName, $swNewName ) $swOldName and $swNewName are Unicode.

TAP::Parser::Multiplexer - Multiplex multiple TAP::Parsers

VERSION Version 3.17 SYNOPSIS use TAP::Parser::Multiplexer; my $mux = TAP::Parser::Multiplexer->new ... METHODS Class Methods new my $mux = TAP::Parser::Multiplexer->new; Returns a new TAP::Parser::Multiplexer

Pod::Simple::Search - find POD documents in directory trees

documents in directory trees SYNOPSIS use Pod::Simple::Search; my $name2path = Pod::Simple::Search->new ... CONSTRUCTOR This class provides the one constructor, called new.

overload - Package for overloading Perl operations

Second, we create a new tied hash each time the hash syntax is used. ... After this change one can do my $a = symbolic->new(3); my $b = symbolic->new(4); my $c = sqrt($a**2

Module::Build::API - API Reference for Module Authors

new() [version 0.03] Creates a new Module::Build object. ... Arguments to the new() method are listed below.

TAP::Parser::Source - Stream output from some source

source VERSION Version 3.17 SYNOPSIS use TAP::Parser::Source; my $source = TAP::Parser::Source->new ... METHODS Class Methods new my $source = TAP::Parser::Source->new; Returns a new TAP::Parser::Source

CPANPLUS::Backend::RV - CPANPLUS::Backend::RV

METHODS new( ok => BOOL, args => DATA, rv => DATA, [function => $method_name] ) Creates a new CPANPLUS ... If not, new() will try to deduce the name from caller() information.

perlthrtut - Tutorial on threads in Perl

new() is a synonym for create(). ... When a new Perl thread is created, all the data associated with the current thread is copied to the new

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 constructor for IO::Dir objects.

App::Prove::State::Result - Individual test suite results.

a new App::Prove::State::Result instance. ... Will return a new App::Prove::State::Result::Test instance if the name is not found.

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::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

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().

TAP::Parser::Source::Perl - Stream Perl output

VERSION Version 3.17 SYNOPSIS use TAP::Parser::Source::Perl; my $perl = TAP::Parser::Source::Perl->new ... METHODS Class Methods new my $perl = TAP::Parser::Source::Perl->new; Returns a new TAP::Parser::Source

CPANPLUS::Module::Author::Fake - CPANPLUS::Module::Author::Fake

NAME CPANPLUS::Module::Author::Fake SYNOPSIS my $auth = CPANPLUS::Module::Author::Fake->new( ... METHODS new( _id => DIGIT ) Creates a dummy author object.

TAP::Parser::Scheduler::Spinner - A no-op job.

METHODS Class Methods new my $job = TAP::Parser::Scheduler::Spinner->new; Returns a new TAP::Parser

TAP::Formatter::Session - Abstract base class for harness output delegate

my %args = ( formatter => $self, ) my $harness = TAP::Formatter::Console::Session->new( \%args ) ... ; The constructor returns a new TAP::Formatter::Console::Session object.

perllexwarn - Perl Lexical Warnings

instead"); new(@_); } sub new ... 1; The function open has been deprecated, so code has been included ... ->new(); $a->doit(1); When this code is run only the Derived object, $b, will generate a warning.

TAP::Parser::Scheduler::Job - A single testing job.

METHODS Class Methods new my $job = TAP::Parser::Scheduler::Job->new( $name, $desc ); Returns ... a new TAP::Parser::Scheduler::Job object.

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.

Unless code at a given scope declares that it wants the new behavior, that new behavior should be disabled ... To that end, we're going to try out a new process for maint-5.12.

Safe - Compile and execute code in restricted compartments

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

Thread::Queue - Thread-safe queues

QUEUE CREATION ->new() Creates a new empty queue. ... ->new(LIST) Creates a new queue pre-populated with the provided list of items.

TAP::Formatter::Color - Run Perl test scripts with color

SYNOPSIS use TAP::Formatter::Color; my $harness = TAP::Formatter::Color->new( \%args ); $harness->runtests ... (@tests); METHODS Class Methods new The constructor returns a new TAP::Formatter::Color object.

TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator

METHODS Class Methods new The constructor new creates and returns an empty TAP::Parser::YAMLish::Reader ... my $reader = TAP::Parser::YAMLish::Reader->new; Instance Methods read my $got = $reader->read($stream

TAP::Parser::Aggregator - Aggregate TAP::Parser results

VERSION Version 3.17 SYNOPSIS use TAP::Parser::Aggregator; my $aggregate = TAP::Parser::Aggregator->new ... METHODS Class Methods new my $aggregate = TAP::Parser::Aggregator->new; Returns a new TAP::Parser

perlcommunity - a brief overview of the Perl community

literature), provides current Perl news, articles, and resources for Perl developers as well ... use Perl; provides a slashdot-style Perl news website covering all things Perl

perlrepository - Using the Perl source repository

git config It is also possible to keep origin as a git remote, and add a new ... In general, you should update an existing test file rather than create a new one.

TAP::Parser::Result - Base class for TAP::Parser output objects

.}; my $result = TAP::Parser::Result->new( $token ); DESCRIPTION This is a simple base class used by ... ::Parser::Result->new($token); Returns an instance the appropriate class for the test token passed in

Archive::Tar - module for manipulations of tar archives

Object Methods Archive::Tar->new( [$file, $compressed] ) Returns a new Tar object. ... $tar->rename( $file, $new_name ) Rename the file of the in-memory archive to $new_name.

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

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

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.

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

You can also add new ones using "add_callback". #addr The address of the OP, in hexadecimal. ... It has one minor drawback though; it doesn't register the style under a new name.

IO::Compress::Bzip2 - Write bzip2 files/buffers

newStream([OPTS]) Usage is $z->newStream( [OPTS] ) Closes the current compressed data stream and starts ... a new one.

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

CGI - Handle Common Gateway Interface requests and responses

CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): $query = CGI->new; This will parse the input ( ... '}, "Open a new frame"); <a href="fred.html",target="_new">Open a new frame</a> You may

App::Prove - Implements the prove command.

SYNOPSIS use App::Prove; my $app = App::Prove->new; $app->process_args(@ARGV); $app->run; METHODS ... Class Methods new Create a new App::Prove.

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)) {

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

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

Compile and link C code for Perl modules SYNOPSIS use ExtUtils::CBuilder; my $b = ExtUtils::CBuilder->new ... METHODS new Returns a new ExtUtils::CBuilder object.

Compress::Raw::Bzip2 - Low-Level Interface to bzip2 compression library

Interface to bzip2 compression library SYNOPSIS use Compress::Raw::Bzip2 ; my ($bz, $status) = new ... a new compression object.

CPANPLUS::Backend - CPANPLUS::Backend

METHODS $cb = CPANPLUS::Backend->new( [CONFIGURE_OBJ] ) This method returns a new CPANPLUS::Backend ... This will then be re-loaded into memory when a new session starts.

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.

perlhack - How to hack at the Perl internals

So, we call newBINOP to create a new binary operator. ... Exporting your new function The new shiny result of either genuine new functionality or your arduous

TAP::Parser::Grammar - A grammar for the Test Anything Protocol.

METHODS Class Methods new my $grammar = TAP::Parser::Grammar->new({ stream => $stream, parser ... the basic TAP parsing loop looks similar to the following: my @tokens; my $grammar = TAP::Grammar->new

ExtUtils::Install - install files from here to there

Note that the new argument style and use of the %result hash is recommended. ... Input is the contents of the module, output the new module contents.

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.

Pod::Simple - framework for parsing Pod

MAIN METHODS $parser = SomeClass->new(); This returns a new parser object, where SomeClass is a ... *INPUT_FH ); SomeClass->filter( \$document_content ); This is a shortcut method for creating a new

Test::Builder - Backend for building test libraries

Construction new my $Test = Test::Builder->new; Returns a Test::Builder object representing the ... probably want new.

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.

POSIX - Perl interface to IEEE Std 1003.1

POSIX::SigSet new Create a new SigSet object. ... Create a new Termios object.

Pod::Simple::XHTML - Pod::Simple::XHTML -- format Pod as validating XHTML

format Pod as validating XHTML SYNOPSIS use Pod::Simple::XHTML; my $parser = Pod::Simple::XHTML->new ... In your subclass's new method, after calling SUPER::new you'd call: $new->accept_targets_as_text( 'foo

IO::Compress::Deflate - Write RFC 1950 files/buffers

newStream([OPTS]) Usage is $z->newStream( [OPTS] ) Closes the current compressed data stream and starts ... a new one.

IO::Compress::RawDeflate - Write RFC 1951 files/buffers

newStream([OPTS]) Usage is $z->newStream( [OPTS] ) Closes the current compressed data stream and starts ... a new one.

Compress::Raw::Zlib - Low-Level Interface to zlib compression library

Low-Level Interface to zlib compression library SYNOPSIS use Compress::Raw::Zlib ; ($d, $status) = new ... >total_out() ; $d->msg() ; $d->get_Strategy(); $d->get_Level(); $d->get_BufSize(); ($i, $status) = new

Unicode::Collate - Unicode Collation Algorithm

Constructor and Tailoring The new method returns a collator object. ... , a collator via Unicode::Collate->new(variable => "non-ignorable", level => 3).

perlgpl - the GNU General Public License, version 1

source code or can get it if you want it, that you can change the software or use pieces of it in new ... new problems or concerns.

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

version of Perl to a new location, and copy the installed files to this new location. ... dll to the "new" perl????.dll.

ExtUtils::XSSymSet - keep sets of symbol names palatable to the VMS linker

- keep sets of symbol names palatable to the VMS linker SYNOPSIS use ExtUtils::XSSymSet; $set = new ... new([$maxlen[,$silent]]) Creates an empty ExtUtils::XSSymset set of symbols.

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

new_ok my $obj = new_ok( $class ); my $obj = new_ok( $class => \@args ); my $obj = new_ok( $class = ... This function only works on new() and it assumes new() will return just a single object which isa $class

IO::Zlib - IO:: style interface to Compress::Zlib

Zlib SYNOPSIS With any version of Perl 5 you can use the basic OO interface: use IO::Zlib; $fh = new ... CONSTRUCTOR new ( [ARGS] ) Creates an IO::Zlib object.

Test::Simple - Basic utilities for writing tests.

my $btaste = Film->new({ Title => 'Bad Taste', Director => 'Peter Jackson ... NumExplodingSheep => 1 }); ok( defined($btaste) && ref $btaste eq 'Film, 'new

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

Tie::StdHandle - base class definitions for tied handles

NAME Tie::StdHandle - base class definitions for tied handles SYNOPSIS package NewHandle; require ... a needed method sub TIEHANDLE { ... } # Overrides inherited method package main; tie *FH, 'NewHandle

Net::libnetFAQ - libnet Frequently Asked Questions

$ftp = Net::FTP->new(''); $ftp->login('username','password'); # set transfer ... Turn on Debug (See below) and you will see what is happening $ftp = Net::FTP->new($host, Debug => 1)

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.

File::Copy - Copy files or filehandles

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

perlpragma - how to write a user pragma

pragma that functions much like use integer; You'd like this code use MyMaths; my $l = MyMaths->new ... (1.2); my $r = MyMaths->new(3.4); print "A: ", $l + $r, "\n"; use myint; print "B: ", $l + $r

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.

Pod::Simple::PullParser - Pod::Simple::PullParser -- a pull-parser interface to parsing Pod

Simple::PullParser -- a pull-parser interface to parsing Pod SYNOPSIS my $parser = SomePodProcessor->new ... ; $parser->set_source( "whatever.pod" ); $parser->run; Or: my $parser = SomePodProcessor->new; $parser

TAP::Parser::Iterator::Stream - Internal TAP::Parser Iterator

TAP::Parser::Iterator::Stream; open( TEST, 'test.tap' ); my $it = TAP::Parser::Iterator::Stream->new ... METHODS Class Methods new Create an iterator. Expects one argument containing a filehandle.

TAP::Parser::Iterator::Array - Internal TAP::Parser array Iterator

:Parser::Iterator::Array; my @data = ('foo', 'bar', baz'); my $it = TAP::Parser::Iterator::Array->new ... METHODS Class Methods new Create an iterator.

VMS::DCLsym - Perl extension to manipulate DCL symbols

DCL symbols SYNOPSIS tie %allsyms, VMS::DCLsym; tie %cgisyms, VMS::DCLsym, 'GLOBAL'; $handle = new ... Reading an element retrieves the current value of the symbol, assigning to it defines a new symbol (or

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

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

IO::Compress::Gzip - Write RFC 1952 files/buffers

newStream([OPTS]) Usage is $z->newStream( [OPTS] ) Closes the current compressed data stream and starts ... a new one.

CPANPLUS::Module::Author - CPANPLUS::Module::Author

NAME CPANPLUS::Module::Author SYNOPSIS my $author = CPANPLUS::Module::Author->new( ... METHODS $auth = CPANPLUS::Module::Author->new( author => AUTHOR_NAME, cpanid => CPAN_ID, _id => INTERNALS_ID

Benchmark - benchmark running times of Perl code

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

Encode - character encodings

(newName => ENCODING); After that, newName can be used as an alias for ENCODING. ... Therefore as of Encode version 2.21, a new method mime_name() is added.

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.

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

TAP::Parser::Iterator::Process - Internal TAP::Parser Iterator

, setup => sub { ... }, teardown => sub { ... }, ); my $it = TAP::Parser::Iterator::Process->new ... METHODS Class Methods new Create an iterator.

IO::Compress::Zip - Write zip files/buffers

newStream([OPTS]) Usage is $z->newStream( [OPTS] ) Closes the current compressed data stream and starts ... a new one.

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

They should not be used in new code. ... new Create a temporary file object.

autodie::exception - Exceptions from autodying functions.

new my $error = autodie::exception->new( args => \@_, function => "CORE::open", errno => ... , context => 'scalar', return => undef, ); Creates a new autodie::exception object.

Log::Message::Config - Configuration options for Log::Message

. # For the options you can pass, see the C<Log::Message new()> method. ... if none provided, set to '0', private = 1 # do not be verbose verbose = 0 # default tag to set on new

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

; exit if $pid; die "Can't start a new session: $!" ... (Actually, some of the new Socket conversion functions croak() on bad arguments.)

App::Prove::State - State storage for the prove command.

SYNOPSIS # Re-run failed tests $ prove --state=fail,save -rbv METHODS Class Methods new Accepts ... new Run the tests in newest to oldest order. old Run the tests in oldest to newest order.

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.

Module::Build::ModuleInfo - Gather package and POD information from a perl module file

NAME ModuleInfo - Gather package and POD information from a perl module file DESCRIPTION new_from_file ... new_from_module($module, collect_pod => 1, inc => \@dirs) Construct a ModuleInfo object given a module

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

Module::Build::ConfigData - Configuration for Module::Build

; @names = Module::Build::ConfigData->feature_names; Module::Build::ConfigData->set_config(foo => $new_value ... ); Module::Build::ConfigData->set_feature(bar => $new_value); Module::Build::ConfigData->write; # Save

Log::Message::Item - Message objects for Log::Message

You should probably not create new items by yourself, but use the storing mechanism provided by Log:: ... This may be useful for comparing since the ID is incremented each time a new item is created.

base qw(Pod::Simple::Methody); sub start_L { print Dumper($_[1]{'section'} ) } __PACKAGE__->new ... Pod::Simple::Methody); sub start_L { print Dumper( '' . $_[1]{'section'} ) } __PACKAGE__->new

ExtUtils::MakeMaker - Create a module Makefile

not the newest, you might accidentally get one of these older versions even after installing a brand new ... Static Linking of a new Perl Binary An extension that is built with the above steps is ready to use

perldos - Perl under DOS, W31, W95.

here: 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.

perlrebackslash - Perl Regular Expression Backslash Sequences and Escapes

\K This is new in perl 5.10.0. ... \N This is a new experimental feature in perl 5.12.0.

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

perlref - Perl references and nested data structures

Constructors are often named new(). ... Its disadvantage is that it won't create a new filehandle for you.

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


This example illustrates a new() call with all required arguments: CPANPLUS::Module->new( module ... author_object, _id => INTERNALS_OBJECT_ID, ); Every accessor is also a valid option to pass to new

perltodo - Perl TO-DO List

Documentation New Tests See Porting/how_to_write_a_perldelta.pod for details. ... Gisle would welcome new tests for perlbench.

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

B::Showlex - Show lexical variables used in functions or files

PL_sv_undef 1: NULL (0x9da4234) 2: NULL (0x9db0f2c) 3: NULL (0x9db0f44) 4: NULL (0x9da4264) -e syntax OK New-style ... PVNV (0xa0c4f40) "$j" = NULL (0xa0c4f34) 3: PVNV (0xa0c4f58) "$k" = NULL (0xa0c4f4c) -e syntax OK New

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.

IO::Uncompress::Bunzip2 - Read bzip2 files/buffers

$status = bunzip2 $input => $output [,OPTS] or die "bunzip2 failed: $Bunzip2Error\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

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.

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.


NAME CPANPLUS::Dist::MM SYNOPSIS $mm = CPANPLUS::Dist::MM->new( module => $modobj ); $mm->create ... Called automatically whenever you create a new CPANPLUS::Dist object.

CPANPLUS::Dist::Build - CPANPLUS plugin to install packages that use Build.PL

Build - CPANPLUS plugin to install packages that use Build.PL SYNOPSIS my $build = CPANPLUS::Dist->new ... Called automatically whenever you create a new CPANPLUS::Dist object.

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.

B::Lint - Perl lint

The B::Lint->register_plugin( MyPlugin => \@new_checks ) method adds the list of @new_checks to the list

Shell - run shell commands transparently within perl

passwd'); @pslines = ps('-ww'), cp("/etc/passwd", "/tmp/passwd"); # object oriented my $sh = Shell->new ...> To: From: Larry Wall <> Subject: a new

IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop file/buffer

anyuncompress $input => $output [,OPTS] or die "anyuncompress failed: $AnyUncompressError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

IO::Uncompress::RawInflate - Read RFC 1951 files/buffers

= rawinflate $input => $output [,OPTS] or die "rawinflate failed: $RawInflateError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

IO::Uncompress::Inflate - Read RFC 1950 files/buffers

$status = inflate $input => $output [,OPTS] or die "inflate failed: $InflateError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

IO::Uncompress::Unzip - Read zip files/buffers

; my $status = unzip $input => $output [,OPTS] or die "unzip failed: $UnzipError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

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

Pod::Simple::HTMLBatch - convert several Pod files to several HTML files

use of this class is like so: use Pod::Simple::HTMLBatch; my $batchconv = Pod::Simple::HTMLBatch->new ... pod from happydocs into the current directory) MAIN METHODS $batchconv = Pod::Simple::HTMLBatch->new

Hash::Util::FieldHash - Support for Inside-Out Classes

When a new thread is created, all references are replaced with new ones, including all objects. ... in use will be replaced with new ones.

Module::Build::Compat - Compatibility with ExtUtils::MakeMaker

with ExtUtils::MakeMaker SYNOPSIS # In a Build.PL : use Module::Build; my $build = Module::Build->new ... typically controlled by passing the desired style as the create_makefile_pl parameter to Module::Build's new

IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer

= anyinflate $input => $output [,OPTS] or die "anyinflate failed: $AnyInflateError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

IO::Uncompress::Gunzip - Read RFC 1952 files/buffers

my $status = gunzip $input => $output [,OPTS] or die "gunzip failed: $GunzipError\n"; my $z = new ... Returns 1 if a new stream was found, 0 if none was found, and -1 if an error was encountered.

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 ... The recognized options to new() are as follows. All options take a single argument.

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.

pod::a2p - Awk to Perl translator

current differences are: Old awk always has a line loop, even if there are no line actions, whereas new ... statement print sprintf(some_args), extra_args; old awk considers extra_args to be arguments to sprintf; new

TAP::Formatter::File - Harness output delegate for file output

SYNOPSIS use TAP::Formatter::File; my $harness = TAP::Formatter::File->new( \%args ); open_test See

TAP::Formatter::Console - Harness output delegate for default console output

SYNOPSIS use TAP::Formatter::Console; my $harness = TAP::Formatter::Console->new( \%args ); open_test

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.

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...).

Digest::base - Digest base class

A minimal subclass needs to implement the following methods by itself: new clone add digest The arguments

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

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

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.

TAP::Base - Base class that provides common functionality to TAP::Parser and TAP::Harness

my $thing = TAP::Whatever->new(); $thing->callback( event => sub { # do something interesting

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.

CPANPLUS::Internals::Source - CPANPLUS::Internals::Source

If the index is missing, and it's a file:// uri, it will generate a new local index for you. ... If the index is missing, and it's a file:// uri, it will generate a new local index for you.

Test::Builder::Tester - test testsuites that have been built with Test::Builder

So to check Test::Builder->new->diag("foo\n","bar\n"); You would do test_diag("foo","bar") without ... Bugs (and requests for new features) can be reported to the author though the CPAN RT system: http://


NAME CPANPLUS::Config SYNOPSIS ### conf object via CPANPLUS::Backend; $cb = CPANPLUS::Backend->new ... ; $conf = $cb->configure_object; ### or as a standalone object $conf = CPANPLUS::Configure->new;

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

DirHandle - supply object methods for directory handles

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

Pod::Perldoc::BaseTo - Base for Pod::Perldoc formatters

is_pageable write_with_binmode output_extension _perldoc_elem The concrete formatter must implement new

Module::Build::Platform::MacOS - Builder class for MacOS platforms

Overridden Methods new() MacPerl doesn't define $Config{sitelib} or $Config{sitearch} for some reason

perlfunc - Perl builtin functions

$hasargs is true if a new instance of @_ was set up for the frame. ... \n" unless chdir '/usr/spool/news'; chdir '/usr/spool/news' or die "Can't cd to spool: $!

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

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

Module::Pluggable::Object - automatically give your module the ability to have plugins

Pluggable - package MyClass; use Module::Pluggable::Object; my $finder = Module::Pluggable::Object->new


use CPANPLUS::Shell qw[Classic] # load CPANPLUS::Shell::Classic; my $ui = CPANPLUS::Shell->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

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. ... which have similar arguments as Zero(): PoisonWith(dst, n, t, b) scribble memory with byte b PoisonNew

libnetcfg - configure libnet

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

CPANPLUS::Shell::Default::Plugins::CustomSource - CPANPLUS::Shell::Default::Plugins::CustomSource

cs ### add a new custom source CPAN Terminal> /cs --add file:///path/to/releases ### list all your

perlmpeix - Perl/iX for HP e3000 MPE

What's New in Perl for MPE/iX January 12, 2006 Updated for perl-5.8.8 and perl-5.9.3 by Ken Hirsch ... Check here for the latest news, implemented functionality, known bugs, to-do list, etc.

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

App::Prove::State::Result::Test - Individual test results.

SYNOPSIS # Re-run failed tests $ prove --state=fail,save -rbv METHODS Class Methods new Instance

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

CORE - Pseudo-namespace for Perl's core routines

at compile time: BEGIN { *CORE::GLOBAL::hex = sub { # ... your code here }; } The new

File::Fetch - A generic file fetching mechanism

fetching mechanism SYNOPSIS use File::Fetch; ### build a File::Fetch object ### my $ff = File::Fetch->new ... METHODS $ff = File::Fetch->new( uri => '' ); Parses the uri and creates

Time::Piece - Object Oriented time objects

There is also a new() constructor provided, which is the same as localtime(), except when passed a Time ... Creates a new # Time::Piece object Local Locales Both wdayname (day) and monname

prove - Run tests through a TAP harness.

Useful to make sure that no new problems have been introduced. ... new Run the tests in newest to oldest order based on the modification times of the test scripts.

Module::Build - Build and install Perl modules

If you are a module author, this is useful to run before creating a new release. ... The defaults can be overridden by specifying new values on the command line.

perlsymbian - Perl version 5 on Symbian OS

New() and Copy() are unfortunately used by both Symbian and Perl code so you'll have to play cpp games ... PerlBase.h undefines the Perl definitions and redefines them as PerlNew() and PerlCopy().

Time::Seconds - a simple API to convert seconds to other date values

: print ONE_WEEK->minutes; METHODS The following methods are available: my $val = Time::Seconds->new

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.

IO::Poll - Object interface to system poll call

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

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

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

Fcntl - load the C Fcntl.h defines

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

TAP::Parser::Iterator - Internal base class for TAP::Parser Iterators

METHODS Class Methods new Create an iterator. Provided by TAP::Object.

ODBM_File - Tied access to odbm files

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

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

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.

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

If you perform a new installation, then (a newer) Perl will be installed automatically. ... Insert the new formula into the Formula/Value box.

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).

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

mro - Method Resolution Order

"SEE ALSO" section), and then later adopted as the preferred MRO (Method Resolution Order) for the new-style ... The only known case where pure perl code can confuse the method cache is when you manually install a new

SDBM_File - Tied access to sdbm files

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

NDBM_File - Tied access to ndbm files

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

CPANPLUS::Internals::Fetch - CPANPLUS::Internals::Fetch

force forces a new download, even if the file already exists.

Pod::Simple::HTML - convert Pod to HTML

perl -MPod::Simple::HTML -e Pod::Simple::HTML::go Thing.pod Thing.html CALLING FROM PERL TODO make a new

Test::Builder::Module - Base class for test modules

You should not get it via Test::Builder->new as was previously recommended.

Pod::Simple::PullParserEndToken - Pod::Simple::PullParserEndToken -- end-tokens from Pod::Simple::PullParser

construct an object of this class for yourself, but if you want to, call Pod::Simple::PullParserEndToken->new

Compress::Zlib - Interface to zlib compression library

See "GZIP INTERFACE" With the creation of the IO::Compress and IO::Uncompress modules no new features ... If you are writing new code, your first port of call should be one of the new IO::Compress or IO::Uncompress

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

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

Pod::Simple::SimpleTree - Pod::Simple::SimpleTree -- parse Pod into a simple parse tree

% perl -MPod::Simple::SimpleTree -MData::Dumper -e \ "print Dumper(Pod::Simple::SimpleTree->new->

VMS::Stdio - standard I/O functions via VMS extensions

remove &rewind &setdef &sync &tmpnam &vmsopen &vmssysopen &waitfh &writeof ); setdef("new ... interface will be removed in a future release of this extension, so please update your code to use the new

perlbug - how to submit bug reports on Perl

You may want to start with perldoc perltrap for pointers to common traps that new (and experienced) Perl ... Feel free to update the ticket about your bug on if a new version of Perl is released

perlthanks - how to submit bug reports on Perl

You may want to start with perldoc perltrap for pointers to common traps that new (and experienced) Perl ... Feel free to update the ticket about your bug on if a new version of Perl is released

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, $

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

Add a new debug statement while running in the shell and then issue a reload cpan and see the new debugging ... Bundle/, install the new perl with the Configure option prefix, e.g. .

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

warnings - Perl pragma to control optional warnings

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

Pod::Simple::PullParserStartToken - Pod::Simple::PullParserStartToken -- start-tokens from Pod::Simple::PullParser

construct an object of this class for yourself, but if you want to, call Pod::Simple::PullParserStartToken->new

Pod::Simple::PullParserTextToken - Pod::Simple::PullParserTextToken -- text-tokens from Pod::Simple::PullParser

construct an object of this class for yourself, but if you want to, call Pod::Simple::PullParserTextToken->new

perlboot - Beginner's Object-Oriented Tutorial

Invoking a barnyard Let's take that new arrow invocation and put it back in the barnyard example: sub ... , with various ways of interpreting the arguments to new.

CPANPLUS::Internals - CPANPLUS::Internals

the id METHODS $internals = CPANPLUS::Internals->_init( _conf => CONFIG_OBJ ) _init creates a new

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.

perlperf - Perl Performance and Optimization Techniques

under control of the benchmarking or profiling modules, from the first step above, and check that the new ... code against the same logfile, as above, to check the new time. $> time .

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.

CPANPLUS::Hacking - CPANPLUS::Hacking

you should either delete your current config file and reconfigure, or patch your config file from the new

perlepoc - Perl for EPOC

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

perlsyn - Perl syntax

Extension modules can also hook into the Perl parser to define new kinds of compound statement. ... It's safer because if code gets added between the inner and outer loops later on, the new code won't

Fatal - Replace functions with equivalents which succeed or die

sub juggle { . . . } Fatal->import('juggle'); BEST PRACTICE Fatal has been obsoleted by the new autodie

corelist - a commandline frontend to Module::CoreList

(If you have the version module, you can also use new-style version numbers, like 5.8.8.)

ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About MakeMaker

While developing your module you might write a new file, not add it to the MANIFEST, then run a distclean ... and be sad because your new work was deleted.

inc::latest - use modules bundled in inc/ if they are newer than installed ones

function creates a specially-named directory in $dir and copies all .pm files from the modlist to the new

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

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

cpan - easily interact with CPAN from the command line

This is useful for checking the configuration as well as using the dump as a starting point for a new

CPANPLUS::Shell::Default - CPANPLUS::Shell::Default

# always done via CPANPLUS::Shell my $ui = CPANPLUS::Shell->new

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. See also perldebguts.

perl - The Perl language interpreter

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

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

Pod::Simple::Subclassing - Pod::Simple::Subclassing -- write a formatter as a Pod::Simple subclass

</head1> For example, a directive consisting of this: =head1 Options to C<new> et al. ... will produce this event structure: <head1 start_line="543"> Options to <C> new </C> et

find2perl - translate find command lines to Perl code

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

Text::Wrap - line wrapping to form simple paragraphs

If you just want to preserve existing newlines but add new breaks with something else, set $Text::Wrap

CPANPLUS::Dist::Base - Base class for custom distribution classes

$bool = $dist->init This method is called just after the new dist object is set up and before the prepare

File::Path - Create or remove directory trees

If you are migrating a codebase to use the new interface, you will have to list everything explicitly ... The new semantics are now only available with make_path and remove_tree.

App::Cpan - easily interact with CPAN from the command line

This is useful for checking the configuration as well as using the dump as a starting point for a new

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

UNIVERSAL - base class for ALL classes (blessed references)

Please don't do this in new code.

Term::Cap - Perl termcap interface

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

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

Sys::Syslog - Perl interface to the UNIX syslog(3) calls

LOG_MAIL - mail subsystem LOG_NETINFO - NetInfo subsystem (Mac OS X); falls back to LOG_DAEMON LOG_NEWS ... - USENET news subsystem LOG_NTP - NTP subsystem (FreeBSD, NetBSD); falls back to LOG_DAEMON LOG_RAS

Devel::DProf - a Perl code profiler

New $over_* values show the measured overhead of making $over_tests calls to the profiler These values

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.

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.

Module::CoreList - what modules shipped with versions of perl

%Module::CoreList::families New, in 1.96, a hash that clusters known perl releases by their major versions

perlnetware - Perl for NetWare

(Typically under the c:\perl folder) BUILD NEW EXTENSIONS To build extensions other than standard extensions

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.

perlglossary - Perl Glossary

attribute A new feature that allows the declaration of variables and subroutines with modifiers as ... scalar storage locations, plus four references (in the first four scalar locations) pointing to four new

perldoc - Look up Perl documentation in Pod format.

See POD2::IT (or POD2::FR) in order to see how to create and integrate new localized POD2::* pod documentation

cpan2dist - The CPANPLUS distribution creator

Some because they are part of core-perl and you dont want a new package.

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

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

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.

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

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

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

perluniprops - Index of Unicode Version 5.2.0 properties in Perl

} (Single: \p{InNewTaiLue}; NOT \p{New_Tai_Lue} NOR \p{Is_New_Tai_Lue}) ... } (= \p{Script=New_Tai_Lue}) (NOT \p{Block=New_Tai_Lue}) (83) \p{Tamil}

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 =

perlstyle - Perl style guide

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

DBM_Filter - DBM_Filter -- Filter DBM keys/values

So what's new?

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

The good news is that you very probably don't need to ever use the ODBM_File extension since more advanced

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.

AutoLoader - load subroutines only on demand

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

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

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

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

PerlIO - On demand loader for PerlIO layers and root of PerlIO::* name space

the first CRLF layer you can find, and if you can't find one, here would be a good spot to place a new

Term::UI - Term::ReadLine UI made easy

::ReadLine UI made easy SYNOPSIS use Term::UI; use Term::ReadLine; my $term = Term::ReadLine->new

perlreref - Perl Regular Expressions Reference

+ 0 or 1 time (same as {0,1}) The possessive forms (new in Perl 5.10) prevent backtracking:

perlrun - how to execute the Perl interpreter

Note that because -i renames or deletes the original file before creating a new file of the same name ... be used as a temporary development aid while securing legacy code: for real production code and for new

Opcode - Disable named opcodes when compiling perl code

Usually, to create new filehandles other ops such as open would need to be enabled, if you don't take

threads::shared - Perl extension for sharing data structures between threads

bar'}})) { my $val = $foo{'bar'}{$key}; ... } View existing bug reports at, and submit any 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

perldiag - various Perl diagnostics

You must put parentheses around the filehandle, or use the new "or" operator instead of "||". ... This useless construct is now deprecated, so := can be reclaimed as a new operator in the future.

CPAN::FirstTime - Utility for CPAN::Config file Initialization

It determines after how many days downloads new indexes.

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

perlwin32 - Perl under Windows

To use the Perl you just installed you will need to add a new entry to your PATH environment variable ... makefile then the installation structure is a little more complicated and you will need to add two new

perlop - Perl operators and precedence

. $_ = <<'EOL'; $url = URI::URL->new( "" ); 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

perlaix - Perl version 5 on IBM AIX (UNIX) systems

It is highly recommended to use the new interface.

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

perlrecharclass - Perl Regular Expression Character Classes

\N \N is new in 5.12, and is experimental.

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.

perlre - Perl regular expressions

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

perlreguts - Description of the Perl regular expression engine.

# branch's tail to the tail of the sequence # (NEW

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

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

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

perlhist - the Perl history records

5.6.1 2001-Apr-08 Rafael 5.6.2-RC1 2003-Nov-08 5.6.2 2003-Nov-15 Fix new

Config - access Perl configuration information

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