Reference

perltoc(1p)

perltoc - perl documentation table of contents This page provides a brief table of contents for the rest of the Perl documentation set. It is meant to be scanned quickly or grepped through to locate the proper section you're looking for.
perl - Practical Extraction and Report Language

Many usability enhancements, Simplified grammar, Lexical scoping, Arbitrarily nested data structures, Modularity and reusability, Object-oriented programming, Embeddable and Extensible, POSIX compliant, Package constructors and destructors, Multiple simultaneous DBM implementations, Subroutine definitions may now be autoloaded, Regular expression enhancements, Innumerable Unbundled Modules, Compilability







perlfaq - frequently asked questions about Perl ($Date: 1998/07/20 23:12:17 $)
perlfaq: Structural overview of the FAQ, the perlfaq1 manpage: General Questions About Perl, the perlfaq2 manpage: Obtaining and Learning about Perl, the perlfaq3 manpage: Programming Tools, the perlfaq4 manpage: Data Manipulation, the perlfaq5 manpage: Files and Formats, the perlfaq6 manpage: Regexps, the perlfaq7 manpage: General Perl Language Issues, the perlfaq8 manpage: System Interaction, the perlfaq9 manpage: Networking







24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, Initial Release: 11/March/97
perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date: 1998/06/14 22:15:25 $)
















perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.24 $, $Date: 1998/07/20 23:40:28 $)











References, Tutorials *Learning Perl [2nd edition] by Randal L. Schwartz and Tom Christiansen, Task-Oriented, Special Topics


MacPerl, Perl5-Porters, NTPerl, Perl-Packrats






perlfaq3 - Programming Tools ($Revision: 1.28 $, $Date: 1998/07/16 22:08:49 $)
































perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 1998/07/16 22:49:55 $)



































1. There must be no space after the << part, 2. There (probably) should be a semicolon at the end, 3. You can't (easily) have any space in front of the tag


a) If @in is sorted, and you want @out to be sorted:(this assumes all true values in the array), b) If you don't know whether @in is sorted:, c) Like (b), but @in contains only small integers:, d) A way to do (b) without any loops or greps:, e) Like (d), but @in contains only small positive integers:




































perlfaq5 - Files and Formats ($Revision: 1.24 $, $Date: 1998/07/05 15:07:20 $)



































perlfaq6 - Regexps ($Revision: 1.22 $, $Date: 1998/07/16 14:01:07 $)

Comments Outside the Regexp, Comments Inside the Regexp, Different Delimiters






















perlfaq7 - Perl Language Issues ($Revision: 1.21 $, $Date: 1998/06/22 15:20:07 $)














Passing Variables and Functions, Passing Filehandles, Passing Regexps, Passing Methods













perlfaq8 - System Interaction ($Revision: 1.25 $, $Date: 1998/07/05 15:07:20 $)



Keyboard, Screen, Mouse






lockfiles, open mode, end of line, flushing output, non-blocking input

STDIN, STDOUT, and STDERR are shared, Signals, Zombies





















Unix
















perlfaq9 - Networking ($Revision: 1.20 $, $Date: 1998/06/22 18:31:09 $)


























perldelta - what's new for perl5.005






Core sources now require ANSI C compiler, All Perl global variables must now be referenced with an explicit prefix, Enabling threads has source compatibility issues







Many new and improved optimizations, Many bug fixes, New regular expression constructs, New operator for precompiled regular expressions, Other improvements, Incompatible changes




































B, Data::Dumper, Errno, File::Spec, ExtUtils::Installed, ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, Thread, attrs, fields, re
CGI, POSIX, DB_File, MakeMaker, CPAN, Cwd, Benchmark


Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index while coercing array into hash, Bareword "%s" refers to nonexistent package, Can't call method "%s" on an undefined value, Can't coerce array into hash, Can't goto subroutine from an eval-string, Can't localize pseudo-hash element, Can't use %%! because Errno.pm is not available, Cannot find an opnumber for "%s", Character class syntax [. .] is reserved for future extensions, Character class syntax [: :] is reserved for future extensions, Character class syntax [= =] is reserved for future extensions, %s: Eval-group in insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: Eval-group not allowed at run time, Explicit blessing to '' (assuming package main), Illegal hex digit ignored, No such array field, No such field "%s" in variable %s of type %s, Out of memory during ridiculously large request, Range iterator outside integer range, Recursive inheritance detected while looking for method '%s' in package '%s', Reference found where even-sized list expected, Undefined value assigned to typeglob, Use of reserved word "%s" is deprecated, perl: warning: Setting locale failed
Can't mktemp(), Can't write to temp file for -e: %s, Cannot open temporary file



perldata - Perl data types







perlsyn - Perl syntax











perlop - Perl operators and precedence


























unary &, unary *, (TYPE)

?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, 'STRING', qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, y/SEARCHLIST/REPLACEMENTLIST/cds
Finding the end, Removal of backslashes before delimiters, Interpolation, <<'EOF', m'', s''', tr///, y///, '', q//, "", ``, qq//, qx//, <file*glob>, ?RE?, /RE/, m/RE/, s/RE/foo/,, Interpolation of regular expressions, Optimization of regular expressions






perlre - Perl regular expressions
i, m, s, x
(?#text), (?:pattern), (?imsx-imsx:pattern), (?=pattern), (?!pattern), (?<=pattern), (?<!pattern), (?{ code }), (?>pattern), (?(condition)yes-pattern⎪no-pattern), (?(condition)yes-pattern), (?imsx-imsx)






perlrun - how to execute the Perl interpreter


OS/2, MS-DOS, Win95/NT, Macintosh

-0[digits], -a, -c, -d, -d:foo, -Dletters, -Dnumber, -e commandline, -Fpattern, -h, -i[extension], -Idirectory, -l[octnum], -m[-]module, -M[-]module, -M[-]'module ...', -[mM][-]module=arg[,arg]..., -n, -p, -P, -s, -S, -T, -u, -U, -v, -V, -V:name, -w, -x directory
HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL (specific to WIN32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
perlfunc - Perl builtin functions

Functions for SCALARs or strings, Regular expressions and pattern matching, Numeric functions, Functions for real @ARRAYs, Functions for list data, Functions for real %HASHes, Input and output functions, Functions for fixed length data or records, Functions for filehandles, files, or directories, Keywords related to the control flow of your perl program, Keywords related to scoping, Miscellaneous functions, Functions for processes and process groups, Keywords related to perl modules, Keywords related to classes and object-orientedness, Low-level socket functions, System V interprocess communication functions, Fetching user and group info, Fetching network info, Time-related functions, Functions new in perl5, Functions obsoleted in perl5
-X FILEHANDLE, -X EXPR, -X, abs VALUE, abs, accept NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, defined EXPR, defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MODE, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo, ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK, substr EXPR,OFFSET,LEN,REPLACEMENT, substr EXPR,OFFSET,LEN, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, tell FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module LIST, use Module, use Module VERSION LIST, use VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
perlvar - Perl predefined variables

$ARG, $_, $<digits>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', $LAST_PAREN_MATCH, $+, $MULTILINE_MATCHING, $*, input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $⎪, output_field_separator HANDLE EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR, $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR, $FORMAT_LINES_LEFT, $-, format_name HANDLE EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^, format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS, $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $], $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^R, $^S, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, %ENV $ENV{expr}, %SIG $SIG{expr}

perlsub - Perl subroutines






1. You need to give a global variable a temporary value, especially $_, 2. You need to create a local file or directory handle or a local function, 3. You want to temporarily change just one element of an array or hash






perlmod - Perl modules (packages and symbol tables)







perlmodlib - constructing new Perl modules and finding existing ones


use autouse MODULE => qw(sub1 sub2 sub3), blib, diagnostics, integer, less, lib, locale, ops, overload, re, sigtrap, strict, subs, vmsish, vars
AnyDBM_File, AutoLoader, AutoSplit, Benchmark, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB_File, Devel::SelfStubber, DirHandle, DynaLoader, English, Env, Exporter, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Liblist, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, File::Compare, File::Copy, File::Find, File::Path, File::stat, FileCache, FileHandle, FindBin, GDBM_File, Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File, IO::Handle, IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2, IPC::Open3, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, Opcode, Pod::Text, POSIX, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent

Language Extensions and Documentation Tools, Development Support, Operating System Interfaces, Networking, Device Control (modems) and InterProcess Communication, Data Types and Data Type Utilities, Database Interfaces, User Interfaces, Interfaces to / Emulations of Other Programming Languages, File Names, File Systems and File Locking (see also File Handles), String Processing, Language Text Processing, Parsing, and Searching, Option, Argument, Parameter, and Configuration File Processing, Internationalization and Locale, Authentication, Security, and Encryption, World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities, Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing, and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and exceptions etc), File Handle and Input/Output Stream Utilities, Miscellaneous Modules, Africa, Asia, Australasia, Europe, North America, South America

Do similar modules already exist in some form?, Try to design the new module to be easy to extend and reuse, Some simple style guidelines, Select what to export, Select a name for the module, Have you got it right?, README and other Additional Files, A description of the module/package/extension etc, A copyright notice - see below, Prerequisites - what else you may need to have, How to build it - possible changes to Makefile.PL etc, How to install it, Recent changes in this release, especially incompatibilities, Changes / enhancements you plan to make in the future, Adding a Copyright Notice, Give the module a version/issue/release number, How to release and distribute a module, Take care when changing a released module
There is no requirement to convert anything, Consider the implications, Make the most of the opportunity, The pl2pm utility will get you started, Adds the standard Module prologue lines, Converts package specifiers from ' to ::, Converts die(...) to croak(...), Several other minor changes
Complete applications rarely belong in the Perl Module Library, Many applications contain some Perl code that could be reused, Break-out the reusable code into one or more separate module files, Take the opportunity to reconsider and redesign the interfaces, In some cases the 'application' can then be reduced to a small

perlmodinstall - Installing CPAN Modules

DECOMPRESS the file, UNPACK the file into a directory, BUILD the module (sometimes unnecessary), INSTALL the module



perlform - Perl formats






perllocale - Perl locale handling (internationalization and localization)



















Comparison operators (lt, le, ge, gt and cmp):, Case-mapping interpolation (with \l, \L, \u or \U), Matching operator (m//):, Substitution operator (s///):, In-memory formatting function (sprintf()):, Output formatting functions (printf() and write()):, Case-mapping functions (lc(), lcfirst(), uc(), ucfirst()):, POSIX locale-dependent functions (localeconv(), strcoll(),strftime(), strxfrm()):, POSIX character class tests (isalnum(), isalpha(), isdigit(),isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()):
PERL_BADLANG, LC_ALL, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC, LC_TIME, LANG












perlref - Perl references and nested data structures









perldsc - Perl Data Structures Cookbook
arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, more elaborate constructs





























perllol, perlLoL - Manipulating Lists of Lists in Perl







perltoot - Tom's object-oriented tutorial for perl

































perlobj - Perl objects





isa(CLASS), can(METHOD), VERSION( [NEED] )





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


TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, DESTROY this
USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY this, NEXTKEY this, lastkey, DESTROY this
TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this




perlbot - Bag'o Object Tricks (the BOT)












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
















Proto, PeerAddr, PeerPort


Proto, LocalPort, Listen, Reuse






perldebug - Perl debugging


h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n [expr], <CR>, c [line⎪sub], l, l min+incr, l min-max, l line, l subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern], t, t expr, b [line] [condition], b subname [condition], b postpone subname [condition], b load filename, b compile subname, d [line], D, a [line] command, A, W [expr], W, O [opt[=val]] [opt"val"] [opt?].., recallCommand, ShellBang, pager, tkRunning, signalLevel, warnLevel, dieLevel, AutoTrace, LineInfo, inhibit_exit, PrintRet, ornaments, frame, maxTraceLen, arrayDepth, hashDepth, compactDump, veryCompact, globPrint, DumpDBFiles, DumpPackages, DumpReused, quote, HighBit, undefPrint, UsageOnly, TTY, noTTY, ReadLine, NonStop, < [ command ], << command, > command, >> command, { [ command ], {{ command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R, ⎪dbcmd, ⎪⎪dbcmd, command, m expr, m package
Prompt, Multiline commands, Stack backtrace, Listing, Frame listing










buckets SMALLEST(APPROX)..GREATEST(APPROX), Free/Used, Total sbrk(): SBRKed/SBRKs:CONTINUOUS, pad: 0, heads: 2192, chain: 0, tail: 6144
717, 002, 054, 602, 702, 704
!!!, !!, !


anchored STRING at POS, floating STRING at POS1..POS2, matching floating/anchored, minlen, stclass TYPE, noscan, isall, GPOS, plus, implicit, with eval, anchored(TYPE)


perldiag - various Perl diagnostics

perlsec - Perl security







perltrap - Perl traps for the unwary






Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical Traps, General data type traps, Context Traps - scalar, list contexts, Precedence Traps, General Regular Expression Traps using s///, etc, Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, Discontinuance, Discontinuance, Deprecation, Discontinuance
Parsing, Parsing, Parsing, Parsing
Numerical, Numerical, Numerical
(Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), (Constants), (Scalars), (Variable Suicide)
(list context), (scalar context), (scalar context), (list, builtin)
Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, Precedence
Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression
(Signals), (Sort Subroutine), warn() won't let you specify a filehandle
(SysV), (SysV)
Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, Interpolation
DBM, DBM
require/do trap using returned value, split on empty string with LIMIT specified
perlport - Writing portable Perl
Not all Perl programs have to be portable, The vast majority of Perl is portable











Mailing list: [email protected], Testing results: http://www.connect.net/gbarr/cpan-test/


The djgpp environment for DOS, http://www.delorie.com/djgpp/, The EMX environment for DOS, OS/2, etc. [email protected],http://www.juge.com/bbs/Hobb.19.html, Build instructions for Win32, the perlwin32 manpage, The ActiveState Pages, http://www.activestate.com/
The MacPerl Pages, http://www.ptf.com/macperl/, The MacPerl mailing list, [email protected]
the perlvms.pod manpage, vmsperl list, [email protected], vmsperl on the web, http://www.sidhe.org/vmsperl/index.html
perl-mvs list, AS/400 Perl information at http://as400.rochester.ibm.com
Atari, Guido Flohr's page http://stud.uni-sb.de/~gufl0000/, HP 300 MPE/iX http://www.cccd.edu/~markb/perlix.html, Novell Netware

-X FILEHANDLE, -X EXPR, -X, binmode FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, system LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, wait, waitpid PID,FLAGS


perlstyle - Perl style guide

perlpod - plain old documentation









perlbook - Perl book information

perlembed - how to embed perl in your C program

Use C from Perl?, Use a Unix program from Perl?, Use Perl from Perl?, Use C from C?, Use Perl from C?














perlapio - perl's IO abstraction interface.

PerlIO *, PerlIO_stdin(), PerlIO_stdout(), PerlIO_stderr(), PerlIO_open(path, mode), PerlIO_fdopen(fd,mode), PerlIO_printf(f,fmt,...), PerlIO_vprintf(f,fmt,a), PerlIO_stdoutf(fmt,...), PerlIO_read(f,buf,count), PerlIO_write(f,buf,count), PerlIO_close(f), PerlIO_puts(f,s), PerlIO_putc(f,c), PerlIO_ungetc(f,c), PerlIO_getc(f), PerlIO_eof(f), PerlIO_error(f), PerlIO_fileno(f), PerlIO_clearerr(f), PerlIO_flush(f), PerlIO_tell(f), PerlIO_seek(f,o,w), PerlIO_getpos(f,p), PerlIO_setpos(f,p), PerlIO_rewind(f), PerlIO_tmpfile()
PerlIO_importFILE(f,flags), PerlIO_exportFILE(f,flags), PerlIO_findFILE(f), PerlIO_releaseFILE(p,f), PerlIO_setlinebuf(f), PerlIO_has_cntptr(f), PerlIO_get_ptr(f), PerlIO_get_cnt(f), PerlIO_canset_cnt(f), PerlIO_fast_gets(f), PerlIO_set_ptrcnt(f,p,c), PerlIO_set_cnt(f,c), PerlIO_has_base(f), PerlIO_get_base(f), PerlIO_get_bufsiz(f)
perlxs - XS language reference manual










































perlxstut, perlXStut - Tutorial for XSUBs























perlguts - Perl's Internal Functions




















SAVEINT(int i), SAVEIV(IV i), SAVEI32(I32 i), SAVELONG(long i), SAVESPTR(s), SAVEPPTR(p), SAVEFREESV(SV *sv), SAVEFREEOP(OP *op), SAVEFREEPV(p), SAVECLEARSV(SV *sv), SAVEDELETE(HV *hv, char *key, I32 length), SAVEDESTRUCTOR(f,p), SAVESTACK_POS(), SV* save_scalar(GV *gv), AV* save_ary(GV *gv), HV* save_hash(GV *gv), void save_item(SV *item), void save_list(SV **sarg, I32 maxsarg), SV* save_svref(SV **sptr), void save_aptr(AV **aptr), void save_hptr(HV **hptr)















av_clear, av_extend, av_fetch, AvFILL, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH, PL_DBsingle, PL_DBsub, PL_DBtrace, dMARK, dORIGMARK, PL_dowarn, dSP, dXSARGS, dXSI32, do_binmode, ENTER, EXTEND, fbm_compile, fbm_instr, FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V, G_NOARGS, G_SCALAR, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, G_VOID, gv_stashpv, gv_stashsv, GvSV, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delayfree_ent, hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_free_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, HvNAME, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_len, mg_magical, mg_set, Move, PL_na, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv, perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv, perl_free, perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse, perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, RETVAL, safefree, safemalloc, saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless, sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf, sv_catpvf_mg, sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, SvCUR, SvCUR_set, sv_dec, sv_derived_from, sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW, sv_grow, sv_inc, sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp, sv_isa, sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy, sv_newmortal, SvNIOK, SvNIOK_off, SvNIOKp, PL_sv_no, SvNOK, SvNOK_off, SvNOK_on, SvNOK_only, SvNOKp, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOK_off, SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPVX, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpv_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf, sv_setpvf_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, SvSetSV, SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SVt_IV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE, SvTYPE, svtype, PL_sv_undef, sv_unref, SvUPGRADE, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), SvUV, SvUVX, PL_sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV, XST_mNO, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero

perlcall - Perl calling conventions from C
An Error Handler, An Event Driven Program
perl_call_sv, perl_call_pv, perl_call_method, perl_call_argv
























1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of callbacks - hard wired limit, 3. Use a parameter to map to the Perl callback





perlhist - the Perl history records








attrs - set/get attributes of a subroutine

method, locked
re - Perl pragma to alter regular expression behaviour


autouse - postpone load of modules until a function is used





base - Establish IS-A relationship with base class at compile time



blib - Use MakeMaker's uninstalled version of a package




constant - Perl pragma to declare constants







diagnostics - Perl compiler pragma to force verbose warning diagnostics








fields - compile-time class fields



integer - Perl pragma to compute arithmetic in integer instead of double


less - perl pragma to request less of something from the compiler


lib - manipulate @INC at compile time







locale - Perl pragma to use and avoid POSIX locales for built-in operations


overload - Package for overloading perl operations




FALSE, TRUE, undef

Arithmetic operations, Comparison operations, Bit operations, Increment and decrement, Transcendental functions, Boolean, string and numeric conversion, Special
Strings as values of use overload directive, Overloading of an operation is inherited by derived classes


undef, TRUE, defined, but FALSE
Example
Assignment forms of arithmetic operations, Conversion operations, Increment and decrement, abs($a), Unary minus, Negation, Concatenation, Comparison operations, Copy operator


overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
integer, float, binary, q, qr




sigtrap - Perl pragma to enable simple signal handling



stack-trace, die, handler your-handler
normal-signals, error-signals, old-interface-signals
untrapped, any, signal, number

strict - Perl pragma to restrict unsafe constructs

strict refs, strict vars, strict subs
subs - Perl pragma to predeclare sub names


vars - Perl pragma to predeclare global variable names


AnyDBM_File - provide framework for multiple DBMs


[0], [1], [2], [3]

AutoLoader - load subroutines only on demand









AutoSplit - split a package for autoloading

$keep, $check, $modtime


B - The Perl Compiler




REFCNT, FLAGS
IV, IVX, needs64bits, packiv
NV, NVX
RV
PV
MAGIC, SvSTASH
MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
TARGOFF, TARGLEN, TYPE, TARG
USEFUL, PREVIOUS, RARE, TABLE
NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILEGV, GvREFCNT, FLAGS
LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
FILL, MAX, OFF, ARRAY, AvFLAGS
STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY
FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY

next, sibling, ppaddr, desc, targ, type, seq, flags, private
first
last
other
true, false
children
pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
sv
gv
pv
redoop, nextop, lastop
label, stash, filegv, cop_seq, arybase, line
main_cv, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names, byteload_fh(FILEHANDLE)

B::Asmdata - Autogenerated data about Perl ops, used to generate bytecode



B::Assembler - Assemble Perl bytecode



B::Bblock - Walk basic blocks



B::Bytecode - Perl compiler's bytecode backend


-ofilename, --, -f, -fcompress-nullops, -fomit-sequence-numbers, -fbypass-nullops, -fstrip-syntax-tree, -On, -D, -Do, -Db, -Da, -DC, -S, -m


B::C - Perl compiler's C backend


-ofilename, -v, --, -uPackname, -D, -Do, -Dc, -DA, -DC, -DM, -f, -fcog, -fno-cog, -On



B::CC - Perl compiler's optimized C translation backend


-ofilename, -v, --, -uPackname, -mModulename, -D, -Dr, -DO, -Ds, -Dp, -Dq, -Dl, -Dt, -f, -ffreetmps-each-bblock, -ffreetmps-each-loop, -fomit-taint, -On








B::Debug - Walk Perl syntax tree, printing debug info about ops



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


-p, -uPACKAGE, -l, -sLETTERS, C


B::Disassembler - Disassemble Perl bytecode



B::Lint - Perl lint


context, implicit-read and implicit-write, dollar-underscore, private-names, undefined-subs, regexp-variables, all, none
-u Package


B::O, O - Generic interface to Perl Compiler backends





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



B::Stackobj - Helper module for CC backend



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



B::Xref - Generates cross reference reports for Perl programs


-oFILENAME, -r, -D[tO]


Benchmark - benchmark running times of code


new, debug
timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] )
clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )





CGI - Simple Common Gateway Interface Class




1. Use another name for the argument, if one is available. Forexample, -value is an alias for -values, 2. Change the capitalization, e.g. -Values, 3. Put quotes around the argument name, e.g. '-values'












:cgi, :form, :html2, :html3, :netscape, :html, :standard, :all
-any, -compile, -nph, -autoload, -no_debug, -private_tempfiles



Parameters:, 4, 5, 6..


-absolute, -relative, -full, -path (-path_info), -query (-query_string)







application/x-www-form-urlencoded, multipart/form-data
Parameters


Parameters

Parameters:
Parameters:
Parameters:
Parameters:
Parameters:


Parameters:
Parameters:, 3.The third option (-align, optional) is an alignment type, and may be TOP, BOTTOM or MIDDLE

1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, -name, -value, -path, -domain, -expires, -secure
1. Create a <Frameset> document, 2. Specify the destination for the document in the HTTP header, 3. Specify the destination for the document in the <FORM> tag



accept(), raw_cookie(), user_agent(), path_info(), path_translated(), remote_host(), script_name()Return the script name as a partial URL, for self-refering scripts, referer(), auth_type (), server_name (), virtual_host (), server_software (), remote_user (), user_name (), request_method()
In the use statement, By calling the nph() method:, By using -nph parameters in the header() and redirect() statements:
multipart_init() multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
$CGI::POST_MAX, $CGI::DISABLE_UPLOADS, 1. On a script-by-script basis, 2. Globally for all scripts


Matt Heffron ([email protected]), James Taylor ([email protected]), Scott Anguish <[email protected]>, Mike Jewell ([email protected]), Timothy Shimmin ([email protected]), Joergen Haegg ([email protected]), Laurent Delfosse ([email protected]), Richard Resnick ([email protected]), Craig Bishop ([email protected]), Tony Curtis ([email protected]), Tim Bunce ([email protected]), Tom Christiansen ([email protected]), Andreas Koenig ([email protected]), Tim MacKenzie ([email protected]), Kevin B. Hendricks ([email protected]), Stephen Dahmen ([email protected]), Ed Jordan ([email protected]), David Alan Pisoni ([email protected]), Doug MacEachern ([email protected]), Robin Houston ([email protected]), ...and many many more..



CGI::Apache - Make things work with CGI.pm against Perl-Apache API






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








CGI::Cookie - Interface to Netscape Cookies


1. expiration date, 2. domain, 3. path, 4. secure flag



name(), value(), domain(), path(), expires()



CGI::Fast - CGI Interface for Fast CGI










CGI::Push - Simple Interface to Server Push


-next_page, -last_page, -type, -delay, -cookie, -target, -expires







CGI::Switch - Try more than one constructors and return the first object available




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


Searching for authors, bundles, distribution files and modules, make, test, install, clean modules or distributions, readme, look module or distribution, Signals




expand($type,@things), Programming Examples







o conf <scalar option>, o conf <scalar option> <value>, o conf <list option>, o conf <list option> [shift⎪pop], o conf <list option> [unshift⎪push⎪splice] <list>






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


CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS module



Carp, carp - warn of errors (from perspective of caller)



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



Scalar ('$' or '*$'), Array ('@' or '*@'), Hash ('%' or '*%'), Class ('Class_Name' or '*Class_Name')
Example 1, Example 2

Cwd, getcwd - get pathname of current working directory


DB_File - Perl5 access to Berkeley DB version 1.x

DB_HASH, DB_BTREE, DB_RECNO















$X->push(list) ;, $value = $X->pop ;, $X->shift, $X->unshift(list) ;, $X->length

$status = $X->get($key, $value [, $flags]) ;, $status = $X->put($key, $value [, $flags]) ;, $status = $X->del($key [, $flags]) ;, $status = $X->fd ;, $status = $X->seq($key, $value, $flags) ;, $status = $X->sync([$flags]) ;















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


PACKAGE->new(ARRAYREF [, ARRAYREF]), $OBJ->Dump or PACKAGE->Dump(ARRAYREF [, ARRAYREF]), $OBJ->Dumpxs or PACKAGE->Dumpxs(ARRAYREF [, ARRAYREF]), $OBJ->Seen([HASHREF]), $OBJ->Values([ARRAYREF]), $OBJ->Names([ARRAYREF]), $OBJ->Reset
Dumper(LIST), DumperX(LIST)
$Data::Dumper::Indent or $OBJ->Indent([NEWVAL]), $Data::Dumper::Purity or $OBJ->Purity([NEWVAL]), $Data::Dumper::Pad or $OBJ->Pad([NEWVAL]), $Data::Dumper::Varname or $OBJ->Varname([NEWVAL]), $Data::Dumper::Useqq or $OBJ->Useqq([NEWVAL]), $Data::Dumper::Terse or $OBJ->Terse([NEWVAL]), $Data::Dumper::Freezer or $OBJ->Freezer([NEWVAL]), $Data::Dumper::Toaster or $OBJ->Toaster([NEWVAL]), $Data::Dumper::Deepcopy or $OBJ->Deepcopy([NEWVAL]), $Data::Dumper::Quotekeys or $OBJ->Quotekeys([NEWVAL]), $Data::Dumper::Bless or $OBJ->Bless([NEWVAL])
Dumper





Devel::SelfStubber - generate stubs for a SelfLoading module


DirHandle - supply object methods for directory handles


English - use nice English (or awk) names for ugly punctuation variables


Env - perl module that imports environment variables



Exporter - Implements default import method for modules








ExtUtils::Command - utilities to replace common UNIX commands in Makefiles etc.

cat, eqtime src dst, rm_f files..., rm_f files..., touch files .., mv source... destination, cp source... destination, chmod mode files.., mkpath directory.., test_f file



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



xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)



ExtUtils::Install - install files from here to there


ExtUtils::Installed - Inventory management of installed modules



new(), modules(), files(), directories(), directory_tree(), validate(), packlist(), version()


ExtUtils::Liblist - determine libraries to use and how to use them

For static extensions, For dynamic extensions, For dynamic extensions







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


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



canonpath, catdir, catfile, curdir, rootdir, updir
c_o (o), cflags (o), clean (o), const_cccmd (o), const_config (o), const_loadlibs (o), constants (o), depend (o), dir_target (o), dist (o), dist_basics (o), dist_ci (o), dist_core (o), dist_dir (o), dist_test (o), dlsyms (o), dynamic (o), dynamic_bs (o), dynamic_lib (o), exescan, extliblist, file_name_is_absolute, find_perl
fixin, force (o), guess_name, has_link_code, init_dirscan, init_main, init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir, macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command, maybe_command_in_dirs, needs_linking (o), nicetext, parse_version, parse_abstract, pasthru (o), path, perl_script, perldepend (o), ppd, perm_rw (o), perm_rwx (o), pm_to_blib, post_constants (o), post_initialize (o), postamble (o), prefixify, processPL (o), realclean (o), replace_manpage_separator, static (o), static_lib (o), staticmake (o), subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o), writedoc, xs_c (o), xs_o (o), perl_archive, export_list

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


eliminate_macros, fixpath, catdir, catfile, wraplist, curdir (override), rootdir (override), updir (override)
guess_name (override), find_perl (override), path (override), maybe_command (override), maybe_command_in_dirs (override), perl_script (override), file_name_is_absolute (override), replace_manpage_separator, init_others (override), constants (override), cflags (override), const_cccmd (override), pm_to_blib (override), tool_autosplit (override), tool_sxubpp (override), xsubpp_version (override), tools_other (override), dist (override), c_o (override), xs_c (override), xs_o (override), top_targets (override), dlsyms (override), dynamic_lib (override), dynamic_bs (override), static_lib (override), manifypods (override), processPL (override), installbin (override), subdir_x (override), clean (override), realclean (override), dist_basics (override), dist_core (override), dist_dir (override), dist_test (override), install (override), perldepend (override), makefile (override), test (override), test_via_harness (override), test_via_script (override), makeaperl (override), nicetext (override)
ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker

catfile, constants (o), static_lib (o), dynamic_bs (o), dynamic_lib (o), canonpath, perl_script, pm_to_blib, test_via_harness (o), tool_autosplit (override), tools_other (o), xs_o (o), top_targets (o), manifypods (o), dist_ci (o), dist_core (o), pasthru (o)
ExtUtils::MakeMaker - create an extension Makefile












C, CCFLAGS, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITELIB, INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIBPERL_A, LIB, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, OBJECT, OPTIMIZE, PERL, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
clean, depend, dist, dynamic_lib, installpm, linkext, macro, realclean, tool_autosplit


make distcheck, make skipcheck, make distclean, make manifest, make distdir, make tardist, make dist, make uutardist, make shdist, make zipdist, make ci



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





Not in MANIFEST: file, No such file: file, MANIFEST: $!, Added to MANIFEST: file


ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader


ExtUtils::Mksymlists - write linker options files for dynamic extension

NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE


ExtUtils::Packlist - manage .packlist files



new(), read(), write(), validate(), packlist_file()


ExtUtils::testlib - add blib/* directories to @INC


Fatal - replace functions with equivalents which succeed or die



Fcntl - load the C Fcntl.h defines




File::Basename, fileparse - split a pathname into pieces

fileparse_set_fstype, fileparse
basename, dirname
File::CheckTree, validate - run many filetest checks on a tree


File::Compare - Compare files or filehandles




File::Copy - Copy files or filehandles


rmscopy($from,$to[,$date_flag])


File::DosGlob - DOS like globbing and then some







File::Find, find - traverse a file tree



File::Path - create or remove a series of directories




File::Spec - portably perform operations on file names




File::Spec::Mac - File::Spec for MacOS


canonpath, catdir, catfile, curdir, rootdir, updir, file_name_is_absolute, path

File::Spec::OS2 - methods for OS/2 file specs


File::Spec::Unix - methods used by File::Spec


canonpath, catdir, catfile, curdir, rootdir, updir, no_upwards, file_name_is_absolute, path, join, nativename

File::Spec::VMS - methods for VMS file specs


catdir, catfile, curdir (override), rootdir (override), updir (override), path (override), file_name_is_absolute (override)
File::Spec::Win32 - methods for Win32 file specs

catfile, canonpath
File::stat - by-name interface to Perl's built-in stat() functions




FileCache - keep more files open than the system permits



FileHandle - supply object methods for filehandles

$fh->print, $fh->printf, $fh->getline, $fh->getlines

FindBin - Locate directory of original perl script







GDBM_File - Perl5 access to the gdbm library.





Getopt::Long, GetOptions - extended processing of command line options

!, +, :s, :i, :f







default, auto_abbrev, getopt_compat, require_order, permute, bundling (default: reset), bundling_override (default: reset), ignore_case (default: set), ignore_case_always (default: reset), pass_through (default: reset), prefix, prefix_pattern, debug (default: reset)
$Getopt::Long::VERSION, $Getopt::Long::error


Getopt::Std, getopt - Process single-character switches with switch clustering


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


IO - load various IO modules


IO::lib::IO::File, IO::File - supply object methods for filehandles


new ([ ARGS ] ), new_tmpfile
open( FILENAME [,MODE [,PERMS]] )


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


new (), new_from_fd ( FD, MODE )
$fh->fdopen ( FD, MODE ), $fh->opened, $fh->getline, $fh->getlines, $fh->ungetc ( ORD ), $fh->write ( BUF, LEN [, OFFSET }\] ), $fh->flush, $fh->error, $fh->clearerr, $fh->untaint




IO::lib::IO::Pipe, IO::pipe - supply object methods for pipes


new ( [READER, WRITER] )
reader ([ARGS]), writer ([ARGS]), handles ()



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




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


new ( [ HANDLES ] )
add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count (), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )



IO::lib::IO::Socket, IO::Socket - Object interface to socket communications


new ( [ARGS] )
accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype, protocol


sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost ()

hostpath(), peerpath()



IPC::Open2, open2 - open a process for both reading and writing




IPC::Open3, open3 - open a process for reading, writing, and error handling



IPC::SysV - SysV IPC constants

ftok( PATH, ID )



IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class


new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, FLAGS ] ), stat



IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object class


new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N , VALUE ), stat



Math::BigFloat - Arbitrary length float math package

number format, Error returns 'NaN', Division is computed to


Math::BigInt - Arbitrary size integer math package

Canonical notation, Input, Output




Math::Complex - complex numbers and associated mathematical functions










Math::Trig - trigonometric functions


tan





cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical




NDBM_File - Tied access to ndbm files


Net::Ping - check a remote host for reachability


Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, $timeout]);, $p->close();, pingecho($host [, $timeout]);


Net::hostent - by-name interface to Perl's built-in gethost*() functions





Net::netent - by-name interface to Perl's built-in getnet*() functions





Net::protoent - by-name interface to Perl's built-in getproto*() functions




Net::servent - by-name interface to Perl's built-in getserv*() functions





ODBM_File - Tied access to odbm files


Opcode - Disable named opcodes when compiling perl code




an operator name (opname), an operator tag name (optag), a negated opname or optag, an operator set (opset)
opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), opdump (PAT)


:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, :dangerous


Opcode::Safe, Safe - Compile and execute code in restricted compartments

a new namespace, an operator mask


permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), root (NAMESPACE), mask (MASK)
Memory, CPU, Snooping, Signals, State Changes

Opcode::ops, ops - Perl pragma to restrict unsafe operations when compiling



POSIX - Perl interface to IEEE Std 1003.1




_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr, strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, wctomb, write

new
new, addset, delset, emptyset, fillset, ismember
new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, setoflag, setospeed, Baud rate values, Terminal interface values, c_cc field values, c_cflag field values, c_iflag field values, c_lflag field values, c_oflag field values
Constants
Constants
Constants
Constants
Constants
Constants
Constants
Constants
Constants
Constants
Constants, Macros
Constants
Constants
Constants
Constants
Constants, Macros

Pod::Html - module to convert pod files to HTML


help, htmlroot, infile, outfile, podroot, podpath, libpods, netscape, nonetscape, index, noindex, recurse, norecurse, title, verbose





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




SDBM_File - Tied access to sdbm files


Search::Dict, look - search for key in dictionary file


SelectSaver - save and restore selected file handle


SelfLoader - load functions only on demand









Shell - run shell commands transparently within perl



Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C socket.h defines and structure manipulators

inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
Symbol - manipulate Perl symbols and their names


Sys::Hostname - Try every conceivable way to get hostname



Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl interface to the UNIX syslog(3) calls

openlog $ident, $logopt, $facility, syslog $priority, $format, @args, setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), closelog




Term::Cap - Perl termcap interface



Term::Complete - Perl word completion module

<tab>, ^D, ^U, <del>, <bs>



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


ReadLine, new, readline, addhistory, IN, $OUT, MinLine, findConsole, Attribs, Features
tkRunning, ornaments, newTTY


Test - provides a simple framework for writing test scripts


NORMAL TESTS, SKIPPED TESTS, TODO TESTS



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




All tests successful.\nFiles=%d, Tests=%d, %s, FAILED tests %s\n\tFailed %d/%d tests, %.2f%% okay., Test returned status %d (wstat %d), Failed 1 test, %.2f%% okay. %s, Failed %d/%d tests, %.2f%% okay. %s




Text::Abbrev, abbrev - create an abbreviation table from a list



Text::ParseWords - parse text into an array of tokens or array of arrays


0a simple word, 1multiple spaces are skipped because of our $delim, 2use of quotes to include a space in a word, 3use of a backslash to include a space in a word, 4use of a backslash to remove the special meaning of a double-quote, 5another simple word (note the lack of effect of the backslashed double-quote)

Text::Soundex - Implementation of the Soundex Algorithm as Described by Knuth





Text::Tabs -- expand and unexpand tabs per the unix expand(1) and unexpand(1)




Text::Wrap - line wrapping to form simple paragraphs





Thread - multithreading


new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;, Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE, cond_broadcast VARIABLE
join, eval, tid


Thread::Queue - thread-safe queues


new, enqueue LIST, dequeue, dequeue_nb, pending

Thread::Semaphore - thread-safe semaphores


new, new NUMBER, down, down NUMBER, up, up NUMBER
Thread::Signal - Start a thread which runs signal handlers reliably



Thread::Specific - thread-specific keys

Tie::Array - base class for tied arrays

TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this, DESTROY this, PUSH this, LIST, POP this, SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST


Tie::Handle - base class definitions for tied handles

TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, READLINE this, GETC this, DESTROY this

Tie::Hash, Tie::StdHash - base class definitions for tied hashes

TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this


Tie::RefHash - use references as hash keys






Tie::Scalar, Tie::StdScalar - base class definitions for tied scalars

TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this

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



Time::Local - efficiently compute time from local and GMT time


Time::gmtime - by-name interface to Perl's built-in gmtime() function




Time::localtime - by-name interface to Perl's built-in localtime() function




Time::tm - internal object used by Time::gmtime and Time::localtime



UNIVERSAL - base class for ALL classes (blessed references)

isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa ( VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
User::grent - by-name interface to Perl's built-in getgr*() functions




User::pwent - by-name interface to Perl's built-in getpw*() functions



Here should be listed all the extra programs' documentation, but they don't all have manual pages yet:








Larry Wall <[email protected]>, with the help of oodles of other folks.

History