X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlfaq.pod;h=4fc7b8a21f859cbe58e50fa7c9663a829facc674;hb=d7133549e15d907b18e0c1873e57e635dc9d6424;hp=d350f6038a15522f1312376f9b77335dcd7662b7;hpb=13a2d996abe42696bc5ca08abf08030d440c6148;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlfaq.pod b/pod/perlfaq.pod index d350f60..4fc7b8a 100644 --- a/pod/perlfaq.pod +++ b/pod/perlfaq.pod @@ -1,716 +1,1319 @@ =head1 NAME -perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 20:38:02 $) +perlfaq - frequently asked questions about Perl ($Date: 2002/03/11 21:32:23 $) =head1 DESCRIPTION -This document is structured into the following sections: +The perlfaq is structured into the following documents: -=over 4 -=item perlfaq: Structural overview of the FAQ. +=head2 perlfaq: Structural overview of the FAQ. This document. -=item L: General Questions About Perl +=head2 L: General Questions About Perl -Very general, high-level information about Perl. +Very general, high-level questions about Perl. =over 4 -=item * What is Perl? +=item * + +What is Perl? + +=item * + +Who supports Perl? Who develops it? Why is it free? + +=item * + +Which version of Perl should I use? + +=item * + +What are perl4 and perl5? + +=item * + +What is perl6? -=item * Who supports Perl? Who develops it? Why is it free? +=item * -=item * Which version of Perl should I use? +How stable is Perl? -=item * What are perl4 and perl5? +=item * -=item * What is perl6? +Is Perl difficult to learn? -=item * How stable is Perl? +=item * -=item * Is Perl difficult to learn? +How does Perl compare with other languages like Java, Python, REXX, Scheme, or Tcl? -=item * How does Perl compare with other languages like Java, Python, REXX, Scheme, or Tcl? +=item * -=item * Can I do [task] in Perl? +Can I do [task] in Perl? -=item * When shouldn't I program in Perl? +=item * -=item * What's the difference between "perl" and "Perl"? +When shouldn't I program in Perl? -=item * Is it a Perl program or a Perl script? +=item * -=item * What is a JAPH? +What's the difference between "perl" and "Perl"? -=item * Where can I get a list of Larry Wall witticisms? +=item * -=item * How can I convince my sysadmin/supervisor/employees to use (version 5/5.005/Perl) instead of some other language? +Is it a Perl program or a Perl script? + +=item * + +What is a JAPH? + +=item * + +Where can I get a list of Larry Wall witticisms? + +=item * + +How can I convince my sysadmin/supervisor/employees to use version 5/5.6.1/Perl instead of some other language? =back -=item L: Obtaining and Learning about Perl +=head2 L: Obtaining and Learning about Perl -Where to find source and documentation to Perl, support, +Where to find source and documentation for Perl, support, and related matters. =over 4 -=item * What machines support Perl? Where do I get it? +=item * + +What machines support Perl? Where do I get it? + +=item * + +How can I get a binary version of Perl? + +=item * -=item * How can I get a binary version of Perl? +I don't have a C compiler on my system. How can I compile perl? -=item * I don't have a C compiler on my system. How can I compile perl? +=item * -=item * I copied the Perl binary from one machine to another, but scripts don't work. +I copied the Perl binary from one machine to another, but scripts don't work. -=item * I grabbed the sources and tried to compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make it work? +=item * -=item * What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean? +I grabbed the sources and tried to compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make it work? -=item * Is there an ISO or ANSI certified version of Perl? +=item * -=item * Where can I get information on Perl? +What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean? -=item * What are the Perl newsgroups on USENET? Where do I post questions? +=item * -=item * Where should I post source code? +Is there an ISO or ANSI certified version of Perl? -=item * Perl Books +=item * -=item * Perl in Magazines +Where can I get information on Perl? -=item * Perl on the Net: FTP and WWW Access +=item * -=item * What mailing lists are there for perl? +What are the Perl newsgroups on Usenet? Where do I post questions? -=item * Archives of comp.lang.perl.misc +=item * -=item * Where can I buy a commercial version of Perl? +Where should I post source code? -=item * Where do I send bug reports? +=item * -=item * What is perl.com? +Perl Books + +=item * + +Perl in Magazines + +=item * + +Perl on the Net: FTP and WWW Access + +=item * + +What mailing lists are there for Perl? + +=item * + +Archives of comp.lang.perl.misc + +=item * + +Where can I buy a commercial version of Perl? + +=item * + +Where do I send bug reports? + +=item * + +What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? =back -=item L: Programming Tools +=head2 L: Programming Tools Programmer tools and programming support. =over 4 -=item * How do I do (anything)? +=item * + +How do I do (anything)? + +=item * + +How can I use Perl interactively? + +=item * + +Is there a Perl shell? -=item * How can I use Perl interactively? +=item * -=item * Is there a Perl shell? +How do I debug my Perl programs? -=item * How do I debug my Perl programs? +=item * -=item * How do I profile my Perl programs? +How do I profile my Perl programs? -=item * How do I cross-reference my Perl programs? +=item * -=item * Is there a pretty-printer (formatter) for Perl? +How do I cross-reference my Perl programs? -=item * Is there a ctags for Perl? +=item * -=item * Is there an IDE or Windows Perl Editor? +Is there a pretty-printer (formatter) for Perl? -=item * Where can I get Perl macros for vi? +=item * -=item * Where can I get perl-mode for emacs? +Is there a ctags for Perl? -=item * How can I use curses with Perl? +=item * -=item * How can I use X or Tk with Perl? +Is there an IDE or Windows Perl Editor? -=item * How can I generate simple menus without using CGI or Tk? +=item * -=item * What is undump? +Where can I get Perl macros for vi? -=item * How can I make my Perl program run faster? +=item * -=item * How can I make my Perl program take less memory? +Where can I get perl-mode for emacs? -=item * Is it unsafe to return a pointer to local data? +=item * -=item * How can I free an array or hash so my program shrinks? +How can I use curses with Perl? -=item * How can I make my CGI script more efficient? +=item * -=item * How can I hide the source for my Perl program? +How can I use X or Tk with Perl? -=item * How can I compile my Perl program into byte code or C? +=item * -=item * How can I compile Perl into Java? +How can I generate simple menus without using CGI or Tk? -=item * How can I get C<#!perl> to work on [MS-DOS,NT,...]? +=item * -=item * Can I write useful perl programs on the command line? +How can I make my Perl program run faster? -=item * Why don't perl one-liners work on my DOS/Mac/VMS system? +=item * -=item * Where can I learn about CGI or Web programming in Perl? +How can I make my Perl program take less memory? -=item * Where can I learn about object-oriented Perl programming? +=item * -=item * Where can I learn about linking C with Perl? [h2xs, xsubpp] +Is it unsafe to return a pointer to local data? -=item * I've read perlembed, perlguts, etc., but I can't embed perl in +=item * + +How can I free an array or hash so my program shrinks? + +=item * + +How can I make my CGI script more efficient? + +=item * + +How can I hide the source for my Perl program? + +=item * + +How can I compile my Perl program into byte code or C? + +=item * + +How can I compile Perl into Java? + +=item * + +How can I get C<#!perl> to work on [MS-DOS,NT,...]? + +=item * + +Can I write useful Perl programs on the command line? + +=item * + +Why don't Perl one-liners work on my DOS/Mac/VMS system? + +=item * + +Where can I learn about CGI or Web programming in Perl? + +=item * + +Where can I learn about object-oriented Perl programming? + +=item * + +Where can I learn about linking C with Perl? [h2xs, xsubpp] + +=item * + +I've read perlembed, perlguts, etc., but I can't embed perl in my C program; what am I doing wrong? -=item * When I tried to run my script, I got this message. What does it -mean? +=item * + +When I tried to run my script, I got this message. What does it mean? -=item * What's MakeMaker? +=item * + +What's MakeMaker? =back -=item L: Data Manipulation +=head2 L: Data Manipulation Manipulating numbers, dates, strings, arrays, hashes, and miscellaneous data issues. =over 4 -=item * Why am I getting long decimals (eg, 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)? +=item * + +Why am I getting long decimals (eg, 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)? + +=item * + +Why isn't my octal data interpreted correctly? + +=item * + +Does Perl have a round() function? What about ceil() and floor()? Trig functions? + +=item * + +How do I convert between numeric representations? + +=item * + +Why doesn't & work the way I want it to? + +=item * + +How do I multiply matrices? + +=item * + +How do I perform an operation on a series of integers? -=item * Why isn't my octal data interpreted correctly? +=item * -=item * Does Perl have a round() function? What about ceil() and floor()? Trig functions? +How can I output Roman numerals? -=item * How do I convert bits into ints? +=item * -=item * Why doesn't & work the way I want it to? +Why aren't my random numbers random? -=item * How do I multiply matrices? +=item * -=item * How do I perform an operation on a series of integers? +How do I get a random number between X and Y? -=item * How can I output Roman numerals? +=item * -=item * Why aren't my random numbers random? +How do I find the week-of-the-year/day-of-the-year? -=item * How do I find the week-of-the-year/day-of-the-year? +=item * -=item * How do I find the current century or millennium? +How do I find the current century or millennium? -=item * How can I compare two dates and find the difference? +=item * -=item * How can I take a string and turn it into epoch seconds? +How can I compare two dates and find the difference? -=item * How can I find the Julian Day? +=item * -=item * How do I find yesterday's date? +How can I take a string and turn it into epoch seconds? -=item * Does Perl have a year 2000 problem? Is Perl Y2K compliant? +=item * -=item * How do I validate input? +How can I find the Julian Day? -=item * How do I unescape a string? +=item * -=item * How do I remove consecutive pairs of characters? +How do I find yesterday's date? -=item * How do I expand function calls in a string? +=item * -=item * How do I find matching/nesting anything? +Does Perl have a Year 2000 problem? Is Perl Y2K compliant? -=item * How do I reverse a string? +=item * -=item * How do I expand tabs in a string? +How do I validate input? -=item * How do I reformat a paragraph? +=item * -=item * How can I access/change the first N letters of a string? +How do I unescape a string? -=item * How do I change the Nth occurrence of something? +=item * -=item * How can I count the number of occurrences of a substring within a string? +How do I remove consecutive pairs of characters? -=item * How do I capitalize all the words on one line? +=item * -=item * How can I split a [character] delimited string except when inside +How do I expand function calls in a string? + +=item * + +How do I find matching/nesting anything? + +=item * + +How do I reverse a string? + +=item * + +How do I expand tabs in a string? + +=item * + +How do I reformat a paragraph? + +=item * + +How can I access/change the first N letters of a string? + +=item * + +How do I change the Nth occurrence of something? + +=item * + +How can I count the number of occurrences of a substring within a string? + +=item * + +How do I capitalize all the words on one line? + +=item * + +How can I split a [character] delimited string except when inside [character]? (Comma-separated files) -=item * How do I strip blank space from the beginning/end of a string? +=item * + +How do I strip blank space from the beginning/end of a string? + +=item * + +How do I pad a string with blanks or pad a number with zeroes? + +=item * + +How do I extract selected columns from a string? + +=item * + +How do I find the soundex value of a string? + +=item * + +How can I expand variables in text strings? + +=item * + +What's wrong with always quoting "$vars"? + +=item * + +Why don't my <: Files and Formats +=head2 L: Files and Formats -I/O and the "f" issues: filehandles, flushing, formats and footers. +I/O and the "f" issues: filehandles, flushing, formats, and footers. =over 4 -=item * How do I flush/unbuffer an output filehandle? Why must I do this? +=item * + +How do I flush/unbuffer an output filehandle? Why must I do this? + +=item * + +How do I change one line in a file/delete a line in a file/insert a line in the middle of a file/append to the beginning of a file? + +=item * + +How do I count the number of lines in a file? + +=item * + +How do I make a temporary file name? + +=item * + +How can I manipulate fixed-record-length files? + +=item * + +How can I make a filehandle local to a subroutine? How do I pass filehandles between subroutines? How do I make an array of filehandles? + +=item * + +How can I use a filehandle indirectly? -=item * How do I change one line in a file/delete a line in a file/insert a line in the middle of a file/append to the beginning of a file? +=item * -=item * How do I count the number of lines in a file? +How can I set up a footer format to be used with write()? -=item * How do I make a temporary file name? +=item * -=item * How can I manipulate fixed-record-length files? +How can I write() into a string? -=item * How can I make a filehandle local to a subroutine? How do I pass filehandles between subroutines? How do I make an array of filehandles? +=item * -=item * How can I use a filehandle indirectly? +How can I output my numbers with commas added? -=item * How can I set up a footer format to be used with write()? +=item * -=item * How can I write() into a string? +How can I translate tildes (~) in a filename? -=item * How can I output my numbers with commas added? +=item * -=item * How can I translate tildes (~) in a filename? +How come when I open a file read-write it wipes it out? -=item * How come when I open a file read-write it wipes it out? +=item * -=item * Why do I sometimes get an "Argument list too long" when I use <*>? +Why do I sometimes get an "Argument list too long" when I use <*>? -=item * Is there a leak/bug in glob()? +=item * -=item * How can I open a file with a leading ">" or trailing blanks? +Is there a leak/bug in glob()? -=item * How can I reliably rename a file? +=item * -=item * How can I lock a file? +How can I open a file with a leading ">" or trailing blanks? -=item * Why can't I just open(FH, ">file.lock")? +=item * -=item * I still don't get locking. I just want to increment the number in the file. How can I do this? +How can I reliably rename a file? -=item * How do I randomly update a binary file? +=item * -=item * How do I get a file's timestamp in perl? +How can I lock a file? -=item * How do I set a file's timestamp in perl? +=item * -=item * How do I print to more than one file at once? +Why can't I just open(FH, ">file.lock")? -=item * How can I read in an entire file all at once? +=item * -=item * How can I read in a file by paragraphs? +I still don't get locking. I just want to increment the number in the file. How can I do this? -=item * How can I read a single character from a file? From the keyboard? +=item * -=item * How can I tell whether there's a character waiting on a filehandle? +All I want to do is append a small amount of text to the end of a file. Do I still have to use locking? -=item * How do I do a C in perl? +=item * -=item * How do I dup() a filehandle in Perl? +How do I randomly update a binary file? -=item * How do I close a file descriptor by number? +=item * -=item * Why can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe` work? +How do I get a file's timestamp in perl? -=item * Why doesn't glob("*.*") get all the files? +=item * -=item * Why does Perl let me delete read-only files? Why does C<-i> clobber protected files? Isn't this a bug in Perl? +How do I set a file's timestamp in perl? -=item * How do I select a random line from a file? +=item * -=item * Why do I get weird spaces when I print an array of lines? +How do I print to more than one file at once? + +=item * + +How can I read in an entire file all at once? + +=item * + +How can I read in a file by paragraphs? + +=item * + +How can I read a single character from a file? From the keyboard? + +=item * + +How can I tell whether there's a character waiting on a filehandle? + +=item * + +How do I do a C in perl? + +=item * + +How do I dup() a filehandle in Perl? + +=item * + +How do I close a file descriptor by number? + +=item * + +Why can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe` work? + +=item * + +Why doesn't glob("*.*") get all the files? + +=item * + +Why does Perl let me delete read-only files? Why does C<-i> clobber protected files? Isn't this a bug in Perl? + +=item * + +How do I select a random line from a file? + +=item * + +Why do I get weird spaces when I print an array of lines? =back -=item L: Regexps +=head2 L: Regular Expressions Pattern matching and regular expressions. =over 4 -=item * How can I hope to use regular expressions without creating illegible and unmaintainable code? +=item * + +How can I hope to use regular expressions without creating illegible and unmaintainable code? + +=item * + +I'm having trouble matching over more than one line. What's wrong? + +=item * + +How can I pull out lines between two patterns that are themselves on different lines? + +=item * + +I put a regular expression into $/ but it didn't work. What's wrong? + +=item * + +How do I substitute case insensitively on the LHS while preserving case on the RHS? + +=item * + +How can I make C<\w> match national character sets? + +=item * + +How can I match a locale-smart version of C? + +=item * -=item * I'm having trouble matching over more than one line. What's wrong? +How can I quote a variable to use in a regex? -=item * How can I pull out lines between two patterns that are themselves on different lines? +=item * -=item * I put a regular expression into $/ but it didn't work. What's wrong? +What is C really for? -=item * How do I substitute case insensitively on the LHS while preserving case on the RHS? +=item * -=item * How can I make C<\w> match national character sets? +How do I use a regular expression to strip C style comments from a file? -=item * How can I match a locale-smart version of C? +=item * -=item * How can I quote a variable to use in a regex? +Can I use Perl regular expressions to match balanced text? -=item * What is C really for? +=item * -=item * How do I use a regular expression to strip C style comments from a file? +What does it mean that regexes are greedy? How can I get around it? -=item * Can I use Perl regular expressions to match balanced text? +=item * -=item * What does it mean that regexes are greedy? How can I get around it? +How do I process each word on each line? -=item * How do I process each word on each line? +=item * -=item * How can I print out a word-frequency or line-frequency summary? +How can I print out a word-frequency or line-frequency summary? -=item * How can I do approximate matching? +=item * -=item * How do I efficiently match many regular expressions at once? +How can I do approximate matching? -=item * Why don't word-boundary searches with C<\b> work for me? +=item * -=item * Why does using $&, $`, or $' slow my program down? +How do I efficiently match many regular expressions at once? -=item * What good is C<\G> in a regular expression? +=item * -=item * Are Perl regexes DFAs or NFAs? Are they POSIX compliant? +Why don't word-boundary searches with C<\b> work for me? -=item * What's wrong with using grep or map in a void context? +=item * -=item * How can I match strings with multibyte characters? +Why does using $&, $`, or $' slow my program down? -=item * How do I match a pattern that is supplied by the user? +=item * + +What good is C<\G> in a regular expression? + +=item * + +Are Perl regexes DFAs or NFAs? Are they POSIX compliant? + +=item * + +What's wrong with using grep or map in a void context? + +=item * + +How can I match strings with multibyte characters? + +=item * + +How do I match a pattern that is supplied by the user? =back -=item L: General Perl Language Issues +=head2 L: General Perl Language Issues General Perl language issues that don't clearly fit into any of the other sections. =over 4 -=item * Can I get a BNF/yacc/RE for the Perl language? +=item * + +Can I get a BNF/yacc/RE for the Perl language? + +=item * + +What are all these $@%&* punctuation signs, and how do I know when to use them? + +=item * + +Do I always/never have to quote my strings or use semicolons and commas? + +=item * + +How do I skip some return values? + +=item * + +How do I temporarily block warnings? + +=item * -=item * What are all these $@%&* punctuation signs, and how do I know when to use them? +What's an extension? -=item * Do I always/never have to quote my strings or use semicolons and commas? +=item * -=item * How do I skip some return values? +Why do Perl operators have different precedence than C operators? -=item * How do I temporarily block warnings? +=item * -=item * What's an extension? +How do I declare/create a structure? -=item * Why do Perl operators have different precedence than C operators? +=item * -=item * How do I declare/create a structure? +How do I create a module? -=item * How do I create a module? +=item * -=item * How do I create a class? +How do I create a class? -=item * How can I tell if a variable is tainted? +=item * -=item * What's a closure? +How can I tell if a variable is tainted? -=item * What is variable suicide and how can I prevent it? +=item * -=item * How can I pass/return a {Function, FileHandle, Array, Hash, Method, Regex}? +What's a closure? -=item * How do I create a static variable? +=item * -=item * What's the difference between dynamic and lexical (static) scoping? Between local() and my()? +What is variable suicide and how can I prevent it? -=item * How can I access a dynamic variable while a similarly named lexical is in scope? +=item * -=item * What's the difference between deep and shallow binding? +How can I pass/return a {Function, FileHandle, Array, Hash, Method, Regex}? -=item * Why doesn't "my($foo) = ;" work right? +=item * -=item * How do I redefine a builtin function, operator, or method? +How do I create a static variable? -=item * What's the difference between calling a function as &foo and foo()? +=item * -=item * How do I create a switch or case statement? +What's the difference between dynamic and lexical (static) scoping? Between local() and my()? -=item * How can I catch accesses to undefined variables/functions/methods? +=item * -=item * Why can't a method included in this same file be found? +How can I access a dynamic variable while a similarly named lexical is in scope? -=item * How can I find out my current package? +=item * -=item * How can I comment out a large block of perl code? +What's the difference between deep and shallow binding? -=item * How do I clear a package? +=item * -=item * How can I use a variable as a variable name? +Why doesn't "my($foo) = ;" work right? + +=item * + +How do I redefine a builtin function, operator, or method? + +=item * + +What's the difference between calling a function as &foo and foo()? + +=item * + +How do I create a switch or case statement? + +=item * + +How can I catch accesses to undefined variables/functions/methods? + +=item * + +Why can't a method included in this same file be found? + +=item * + +How can I find out my current package? + +=item * + +How can I comment out a large block of perl code? + +=item * + +How do I clear a package? + +=item * + +How can I use a variable as a variable name? =back -=item L: System Interaction +=head2 L: System Interaction Interprocess communication (IPC), control over the user-interface (keyboard, screen and pointing devices). =over 4 -=item * How do I find out which operating system I'm running under? +=item * + +How do I find out which operating system I'm running under? -=item * How come exec() doesn't return? +=item * -=item * How do I do fancy stuff with the keyboard/screen/mouse? +How come exec() doesn't return? -=item * How do I print something out in color? +=item * -=item * How do I read just one key without waiting for a return key? +How do I do fancy stuff with the keyboard/screen/mouse? -=item * How do I check whether input is ready on the keyboard? +=item * -=item * How do I clear the screen? +How do I print something out in color? -=item * How do I get the screen size? +=item * -=item * How do I ask the user for a password? +How do I read just one key without waiting for a return key? -=item * How do I read and write the serial port? +=item * -=item * How do I decode encrypted password files? +How do I check whether input is ready on the keyboard? -=item * How do I start a process in the background? +=item * -=item * How do I trap control characters/signals? +How do I clear the screen? -=item * How do I modify the shadow password file on a Unix system? +=item * -=item * How do I set the time and date? +How do I get the screen size? -=item * How can I sleep() or alarm() for under a second? +=item * -=item * How can I measure time under a second? +How do I ask the user for a password? -=item * How can I do an atexit() or setjmp()/longjmp()? (Exception handling) +=item * -=item * Why doesn't my sockets program work under System V (Solaris)? What does the error message "Protocol not supported" mean? +How do I read and write the serial port? -=item * How can I call my system's unique C functions from Perl? +=item * -=item * Where do I get the include files to do ioctl() or syscall()? +How do I decode encrypted password files? -=item * Why do setuid perl scripts complain about kernel problems? +=item * -=item * How can I open a pipe both to and from a command? +How do I start a process in the background? -=item * Why can't I get the output of a command with system()? +=item * -=item * How can I capture STDERR from an external command? +How do I trap control characters/signals? -=item * Why doesn't open() return an error when a pipe open fails? +=item * -=item * What's wrong with using backticks in a void context? +How do I modify the shadow password file on a Unix system? -=item * How can I call backticks without shell processing? +=item * -=item * Why can't my script read from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)? +How do I set the time and date? -=item * How can I convert my shell script to perl? +=item * -=item * Can I use perl to run a telnet or ftp session? +How can I sleep() or alarm() for under a second? -=item * How can I write expect in Perl? +=item * -=item * Is there a way to hide perl's command line from programs such as "ps"? +How can I measure time under a second? -=item * I {changed directory, modified my environment} in a perl script. How come the change disappeared when I exited the script? How do I get my changes to be visible? +=item * -=item * How do I close a process's filehandle without waiting for it to complete? +How can I do an atexit() or setjmp()/longjmp()? (Exception handling) -=item * How do I fork a daemon process? +=item * -=item * How do I make my program run with sh and csh? +Why doesn't my sockets program work under System V (Solaris)? What does the error message "Protocol not supported" mean? -=item * How do I find out if I'm running interactively or not? +=item * -=item * How do I timeout a slow event? +How can I call my system's unique C functions from Perl? -=item * How do I set CPU limits? +=item * -=item * How do I avoid zombies on a Unix system? +Where do I get the include files to do ioctl() or syscall()? -=item * How do I use an SQL database? +=item * -=item * How do I make a system() exit on control-C? +Why do setuid perl scripts complain about kernel problems? -=item * How do I open a file without blocking? +=item * -=item * How do I install a module from CPAN? +How can I open a pipe both to and from a command? -=item * What's the difference between require and use? +=item * -=item * How do I keep my own module/library directory? +Why can't I get the output of a command with system()? -=item * How do I add the directory my program lives in to the module/library search path? +=item * -=item * How do I add a directory to my include path at runtime? +How can I capture STDERR from an external command? -=item * What is socket.ph and where do I get it? +=item * + +Why doesn't open() return an error when a pipe open fails? + +=item * + +What's wrong with using backticks in a void context? + +=item * + +How can I call backticks without shell processing? + +=item * + +Why can't my script read from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)? + +=item * + +How can I convert my shell script to perl? + +=item * + +Can I use perl to run a telnet or ftp session? + +=item * + +How can I write expect in Perl? + +=item * + +Is there a way to hide perl's command line from programs such as "ps"? + +=item * + +I {changed directory, modified my environment} in a perl script. How come the change disappeared when I exited the script? How do I get my changes to be visible? + +=item * + +How do I close a process's filehandle without waiting for it to complete? + +=item * + +How do I fork a daemon process? + +=item * + +How do I find out if I'm running interactively or not? + +=item * + +How do I timeout a slow event? + +=item * + +How do I set CPU limits? + +=item * + +How do I avoid zombies on a Unix system? + +=item * + +How do I use an SQL database? + +=item * + +How do I make a system() exit on control-C? + +=item * + +How do I open a file without blocking? + +=item * + +How do I install a module from CPAN? + +=item * + +What's the difference between require and use? + +=item * + +How do I keep my own module/library directory? + +=item * + +How do I add the directory my program lives in to the module/library search path? + +=item * + +How do I add a directory to my include path at runtime? + +=item * + +What is socket.ph and where do I get it? =back -=item L: Networking +=head2 L: Networking -Networking, the Internet, and a few on the web. +Networking, the internet, and a few on the web. =over 4 -=item * My CGI script runs from the command line but not the browser. (500 Server Error) +=item * -=item * How can I get better error messages from a CGI program? +What is the correct form of response from a CGI script? -=item * How do I remove HTML from a string? +=item * -=item * How do I extract URLs? +My CGI script runs from the command line but not the browser. (500 Server Error) -=item * How do I download a file from the user's machine? How do I open a file on another machine? +=item * -=item * How do I make a pop-up menu in HTML? +How can I get better error messages from a CGI program? -=item * How do I fetch an HTML file? +=item * -=item * How do I automate an HTML form submission? +How do I remove HTML from a string? -=item * How do I decode or create those %-encodings on the web? +=item * -=item * How do I redirect to another page? +How do I extract URLs? -=item * How do I put a password on my web pages? +=item * -=item * How do I edit my .htpasswd and .htgroup files with Perl? +How do I download a file from the user's machine? How do I open a file on another machine? -=item * How do I make sure users can't enter values into a form that cause my CGI script to do bad things? +=item * -=item * How do I parse a mail header? +How do I make a pop-up menu in HTML? -=item * How do I decode a CGI form? +=item * -=item * How do I check a valid mail address? +How do I fetch an HTML file? -=item * How do I decode a MIME/BASE64 string? +=item * -=item * How do I return the user's mail address? +How do I automate an HTML form submission? -=item * How do I send mail? +=item * -=item * How do I read mail? +How do I decode or create those %-encodings on the web? -=item * How do I find out my hostname/domainname/IP address? +=item * -=item * How do I fetch a news article or the active newsgroups? +How do I redirect to another page? -=item * How do I fetch/put an FTP file? +=item * -=item * How can I do RPC in Perl? +How do I put a password on my web pages? -=back +=item * + +How do I edit my .htpasswd and .htgroup files with Perl? + +=item * + +How do I make sure users can't enter values into a form that cause my CGI script to do bad things? + +=item * + +How do I parse a mail header? + +=item * + +How do I decode a CGI form? + +=item * + +How do I check a valid mail address? +=item * + +How do I decode a MIME/BASE64 string? + +=item * + +How do I return the user's mail address? + +=item * + +How do I send mail? + +=item * + +How do I use MIME to make an attachment to a mail message? + +=item * + +How do I read mail? + +=item * + +How do I find out my hostname/domainname/IP address? + +=item * + +How do I fetch a news article or the active newsgroups? + +=item * + +How do I fetch/put an FTP file? + +=item * + +How can I do RPC in Perl? =back -=head2 Where to get this document + +=head1 About the perlfaq documents + +=head2 Where to get the perlfaq This document is posted regularly to comp.lang.perl.announce and -several other related newsgroups. It is available in a variety of -formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory or on the web -at http://www.perl.com/perl/faq/ . +several other related newsgroups. It is available on many +web sites: http://www.perldoc.com/ and http://perlfaq.cpan.org/ . -=head2 How to contribute to this document +=head2 How to contribute to the perlfaq You may mail corrections, additions, and suggestions to -perlfaq-suggestions@perl.com . This alias should not be +perlfaq-workers@perl.org . This alias should not be used to I FAQs. It's for fixing the current FAQ. Send questions to the comp.lang.perl.misc newsgroup. @@ -718,7 +1321,7 @@ Send questions to the comp.lang.perl.misc newsgroup. Your questions will probably go unread, unless they're suggestions of new questions to add to the FAQ, in which case they should have gone -to the perlfaq-suggestions@perl.com instead. +to the perlfaq-workers@perl.org instead. You should have read section 2 of this faq. There you would have learned that comp.lang.perl.misc is the appropriate place to go for @@ -735,17 +1338,13 @@ Perl Porters. =head1 Author and Copyright Information -Copyright (c) 1997-1999 Tom Christiansen and Nathan Torkington. +Copyright (c) 1997-2002 Tom Christiansen and Nathan Torkington. All rights reserved. =head2 Bundled Distributions -When included as part of the Standard Version of Perl or as part of -its complete documentation whether printed or otherwise, this work -may be distributed only under the terms of Perl's Artistic License. -Any distribution of this file or derivatives thereof I -of that package requires that special arrangements be made with -copyright holder. +This documentation is free; you can redistribute it and/or modify it +under the same terms as Perl itself. Irrespective of its distribution, all code examples in these files are hereby placed into the public domain. You are permitted and @@ -779,7 +1378,7 @@ of perlfaq7 on variable names within variables. =item 7/January/99 -Small touchups here and there. Added all questions in this +Small touch ups here and there. Added all questions in this document as a sort of table of contents. =item 22/June/98