Commit | Line | Data |
---|---|---|
cb1a09d0 AD |
1 | |
2 | =head1 NAME | |
3 | ||
4 | perltoc - perl documentation table of contents | |
5 | ||
6 | =head1 DESCRIPTION | |
7 | ||
8 | This page provides a brief table of contents for the rest of the Perl | |
28757baa | 9 | documentation set. It is meant to be scanned quickly or grepped |
402d0d99 | 10 | through to locate the proper section you're looking for. |
cb1a09d0 AD |
11 | |
12 | =head1 BASIC DOCUMENTATION | |
13 | ||
cb1a09d0 AD |
14 | =head2 perl - Practical Extraction and Report Language |
15 | ||
16 | =item SYNOPSIS | |
17 | ||
cb1a09d0 AD |
18 | =item DESCRIPTION |
19 | ||
14218588 GS |
20 | modularity and reusability using innumerable modules, embeddable and |
21 | extensible, roll-your-own magic variables (including multiple simultaneous | |
22 | DBM implementations), subroutines can now be overridden, autoloaded, and | |
23 | prototyped, arbitrarily nested data structures and anonymous functions, | |
24 | object-oriented programming, compilability into C code or Perl bytecode, | |
25 | support for light-weight processes (threads), support for | |
26 | internationalization, localization, and Unicode, lexical scoping, regular | |
27 | expression enhancements, enhanced debugger and interactive Perl | |
28 | environment, with integrated editor support, POSIX 1003.1 compliant library | |
29 | ||
30 | =item AVAILABILITY | |
cb1a09d0 AD |
31 | |
32 | =item ENVIRONMENT | |
33 | ||
cb1a09d0 AD |
34 | =item AUTHOR |
35 | ||
cb1a09d0 AD |
36 | =item FILES |
37 | ||
cb1a09d0 AD |
38 | =item SEE ALSO |
39 | ||
cb1a09d0 AD |
40 | =item DIAGNOSTICS |
41 | ||
cb1a09d0 AD |
42 | =item BUGS |
43 | ||
cb1a09d0 AD |
44 | =item NOTES |
45 | ||
14218588 GS |
46 | =head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 |
47 | 20:38:02 $) | |
68dc0745 | 48 | |
49 | =item DESCRIPTION | |
50 | ||
51 | perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions | |
14218588 GS |
52 | About Perl, What is Perl?, Who supports Perl? Who develops it? Why is it |
53 | free?, Which version of Perl should I use?, What are perl4 and perl5?, What | |
54 | is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl | |
55 | compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can | |
56 | I do [task] in Perl?, When shouldn't I program in Perl?, What's the | |
57 | difference between "perl" and "Perl"?, Is it a Perl program or a Perl | |
58 | script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?, | |
59 | How can I convince my sysadmin/supervisor/employees to use version | |
60 | (5/5.005/Perl instead of some other language)?, L<perlfaq2>: Obtaining and | |
61 | Learning about Perl, What machines support Perl? Where do I get it?, How | |
62 | can I get a binary version of Perl?, I don't have a C compiler on my | |
63 | system. How can I compile perl?, I copied the Perl binary from one machine | |
64 | to another, but scripts don't work, I grabbed the sources and tried to | |
65 | compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make | |
66 | it work?, What modules and extensions are available for Perl? What is | |
67 | CPAN? What does CPAN/src/... mean?, Is there an ISO or ANSI certified | |
68 | version of Perl?, Where can I get information on Perl?, What are the Perl | |
69 | newsgroups on USENET? Where do I post questions?, Where should I post | |
70 | source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW | |
71 | Access, What mailing lists are there for perl?, Archives of | |
72 | comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where | |
73 | do I send bug reports?, What is perl.com?, L<perlfaq3>: Programming Tools, | |
74 | How do I do (anything)?, How can I use Perl interactively?, Is there a Perl | |
75 | shell?, How do I debug my Perl programs?, How do I profile my Perl | |
76 | programs?, How do I cross-reference my Perl programs?, Is there a | |
77 | pretty-printer (formatter) for Perl?, Is there a ctags for Perl?, Is there | |
78 | an IDE or Windows Perl Editor?, Where can I get Perl macros for vi?, Where | |
79 | can I get perl-mode for emacs?, How can I use curses with Perl?, How can I | |
80 | use X or Tk with Perl?, How can I generate simple menus without using CGI | |
81 | or Tk?, What is undump?, How can I make my Perl program run faster?, How | |
82 | can I make my Perl program take less memory?, Is it unsafe to return a | |
83 | pointer to local data?, How can I free an array or hash so my program | |
84 | shrinks?, How can I make my CGI script more efficient?, How can I hide the | |
85 | source for my Perl program?, How can I compile my Perl program into byte | |
86 | code or C?, How can I compile Perl into Java?, How can I get C<#!perl> to | |
87 | work on [MS-DOS,NT,...]?, Can I write useful perl programs on the command | |
88 | line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can | |
89 | I learn about CGI or Web programming in Perl?, Where can I learn about | |
90 | object-oriented Perl programming?, Where can I learn about linking C with | |
91 | Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't | |
92 | embed perl inmy C program, what am I doing wrong?, When I tried to run my | |
93 | script, I got this message. What does itmean?, What's MakeMaker?, | |
94 | L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg, | |
95 | 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?, | |
96 | Why isn't my octal data interpreted correctly?, Does Perl have a round() | |
97 | function? What about ceil() and floor()? Trig functions?, How do I | |
98 | convert bits into ints?, Why doesn't & work the way I want it to?, How do I | |
99 | multiply matrices?, How do I perform an operation on a series of integers?, | |
100 | How can I output Roman numerals?, Why aren't my random numbers random?, How | |
101 | do I find the week-of-the-year/day-of-the-year?, How do I find the current | |
102 | century or millennium?, How can I compare two dates and find the | |
103 | difference?, How can I take a string and turn it into epoch seconds?, How | |
104 | can I find the Julian Day?, How do I find yesterday's date?, Does Perl have | |
105 | a year 2000 problem? Is Perl Y2K compliant?, How do I validate input?, How | |
106 | do I unescape a string?, How do I remove consecutive pairs of characters?, | |
107 | How do I expand function calls in a string?, How do I find matching/nesting | |
108 | anything?, How do I reverse a string?, How do I expand tabs in a string?, | |
109 | How do I reformat a paragraph?, How can I access/change the first N letters | |
110 | of a string?, How do I change the Nth occurrence of something?, How can I | |
111 | count the number of occurrences of a substring within a string?, How do I | |
112 | capitalize all the words on one line?, How can I split a [character] | |
113 | delimited string except when inside[character]? (Comma-separated files), | |
114 | How do I strip blank space from the beginning/end of a string?, How do I | |
115 | pad a string with blanks or pad a number with zeroes?, How do I extract | |
116 | selected columns from a string?, How do I find the soundex value of a | |
117 | string?, How can I expand variables in text strings?, What's wrong with | |
118 | always quoting "$vars"?, Why don't my E<lt>E<lt>HERE documents work?, What | |
119 | is the difference between a list and an array?, What is the difference | |
120 | between $array[1] and @array[1]?, How can I remove duplicate elements from | |
121 | a list or array?, How can I tell whether a list or array contains a certain | |
122 | element?, How do I compute the difference of two arrays? How do I compute | |
123 | the intersection of two arrays?, How do I test whether two arrays or hashes | |
124 | are equal?, How do I find the first array element for which a condition is | |
125 | true?, How do I handle linked lists?, How do I handle circular lists?, How | |
126 | do I shuffle an array randomly?, How do I process/modify each element of an | |
127 | array?, How do I select a random element from an array?, How do I permute N | |
128 | elements of a list?, How do I sort an array by (anything)?, How do I | |
129 | manipulate arrays of bits?, Why does defined() return true on empty arrays | |
130 | and hashes?, How do I process an entire hash?, What happens if I add or | |
131 | remove keys from a hash while iterating over it?, How do I look up a hash | |
132 | element by value?, How can I know how many entries are in a hash?, How do I | |
133 | sort a hash (optionally by value instead of key)?, How can I always keep my | |
134 | hash sorted?, What's the difference between "delete" and "undef" with | |
135 | hashes?, Why don't my tied hashes make the defined/exists distinction?, How | |
136 | do I reset an each() operation part-way through?, How can I get the unique | |
137 | keys from two hashes?, How can I store a multidimensional array in a DBM | |
138 | file?, How can I make my hash remember the order I put elements into it?, | |
139 | Why does passing a subroutine an undefined element in a hash create it?, | |
140 | How can I make the Perl equivalent of a C structure/C++ class/hash or array | |
141 | of hashes or arrays?, How can I use a reference as a hash key?, How do I | |
142 | handle binary data correctly?, How do I determine whether a scalar is a | |
143 | number/whole/integer/float?, How do I keep persistent data across program | |
144 | calls?, How do I print out or copy a recursive data structure?, How do I | |
145 | define methods for every class/object?, How do I verify a credit card | |
146 | checksum?, How do I pack arrays of doubles or floats for XS code?, | |
147 | L<perlfaq5>: Files and Formats, How do I flush/unbuffer an output | |
148 | filehandle? Why must I do this?, How do I change one line in a file/delete | |
149 | a line in a file/insert a line in the middle of a file/append to the | |
150 | beginning of a file?, How do I count the number of lines in a file?, How do | |
151 | I make a temporary file name?, How can I manipulate fixed-record-length | |
152 | files?, How can I make a filehandle local to a subroutine? How do I pass | |
153 | filehandles between subroutines? How do I make an array of filehandles?, | |
154 | How can I use a filehandle indirectly?, How can I set up a footer format to | |
155 | be used with write()?, How can I write() into a string?, How can I output | |
156 | my numbers with commas added?, How can I translate tildes (~) in a | |
157 | filename?, How come when I open a file read-write it wipes it out?, Why do | |
158 | I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?, Is | |
159 | there a leak/bug in glob()?, How can I open a file with a leading "E<gt>" | |
160 | or trailing blanks?, How can I reliably rename a file?, How can I lock a | |
161 | file?, Why can't I just open(FH, ">file.lock")?, I still don't get locking. | |
162 | I just want to increment the number in the file. How can I do this?, How | |
163 | do I randomly update a binary file?, How do I get a file's timestamp in | |
164 | perl?, How do I set a file's timestamp in perl?, How do I print to more | |
165 | than one file at once?, How can I read in an entire file all at once?, How | |
166 | can I read in a file by paragraphs?, How can I read a single character from | |
167 | a file? From the keyboard?, How can I tell whether there's a character | |
168 | waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup() | |
169 | a filehandle in Perl?, How do I close a file descriptor by number?, Why | |
170 | can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe` | |
171 | work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me | |
172 | delete read-only files? Why does C<-i> clobber protected files? Isn't | |
173 | this a bug in Perl?, How do I select a random line from a file?, Why do I | |
174 | get weird spaces when I print an array of lines?, L<perlfaq6>: Regexps, How | |
175 | can I hope to use regular expressions without creating illegible and | |
176 | unmaintainable code?, I'm having trouble matching over more than one line. | |
177 | What's wrong?, How can I pull out lines between two patterns that are | |
178 | themselves on different lines?, I put a regular expression into $/ but it | |
179 | didn't work. What's wrong?, How do I substitute case insensitively on the | |
180 | LHS, but preserving case on the RHS?, How can I make C<\w> match national | |
181 | character sets?, How can I match a locale-smart version of C</[a-zA-Z]/>?, | |
182 | How can I quote a variable to use in a regex?, What is C</o> really for?, | |
183 | How do I use a regular expression to strip C style comments from a file?, | |
184 | Can I use Perl regular expressions to match balanced text?, What does it | |
185 | mean that regexes are greedy? How can I get around it?, How do I process | |
186 | each word on each line?, How can I print out a word-frequency or | |
187 | line-frequency summary?, How can I do approximate matching?, How do I | |
188 | efficiently match many regular expressions at once?, Why don't | |
189 | word-boundary searches with C<\b> work for me?, Why does using $&, $`, or | |
190 | $' slow my program down?, What good is C<\G> in a regular expression?, Are | |
191 | Perl regexes DFAs or NFAs? Are they POSIX compliant?, What's wrong with | |
192 | using grep or map in a void context?, How can I match strings with | |
193 | multibyte characters?, How do I match a pattern that is supplied by the | |
194 | user?, L<perlfaq7>: General Perl Language Issues, Can I get a BNF/yacc/RE | |
195 | for the Perl language?, What are all these $@%&* punctuation signs, and how | |
196 | do I know when to use them?, Do I always/never have to quote my strings or | |
197 | use semicolons and commas?, How do I skip some return values?, How do I | |
198 | temporarily block warnings?, What's an extension?, Why do Perl operators | |
199 | have different precedence than C operators?, How do I declare/create a | |
200 | structure?, How do I create a module?, How do I create a class?, How can I | |
201 | tell if a variable is tainted?, What's a closure?, What is variable suicide | |
202 | and how can I prevent it?, How can I pass/return a {Function, FileHandle, | |
203 | Array, Hash, Method, Regex}?, How do I create a static variable?, What's | |
204 | the difference between dynamic and lexical (static) scoping? Between | |
205 | local() and my()?, How can I access a dynamic variable while a similarly | |
206 | named lexical is in scope?, What's the difference between deep and shallow | |
207 | binding?, Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?, How do I | |
208 | redefine a builtin function, operator, or method?, What's the difference | |
209 | between calling a function as &foo and foo()?, How do I create a switch or | |
210 | case statement?, How can I catch accesses to undefined | |
211 | variables/functions/methods?, Why can't a method included in this same file | |
212 | be found?, How can I find out my current package?, How can I comment out a | |
213 | large block of perl code?, How do I clear a package?, How can I use a | |
214 | variable as a variable name?, L<perlfaq8>: System Interaction, How do I | |
215 | find out which operating system I'm running under?, How come exec() doesn't | |
216 | return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I | |
217 | print something out in color?, How do I read just one key without waiting | |
218 | for a return key?, How do I check whether input is ready on the keyboard?, | |
219 | How do I clear the screen?, How do I get the screen size?, How do I ask the | |
220 | user for a password?, How do I read and write the serial port?, How do I | |
221 | decode encrypted password files?, How do I start a process in the | |
222 | background?, How do I trap control characters/signals?, How do I modify the | |
223 | shadow password file on a Unix system?, How do I set the time and date?, | |
224 | How can I sleep() or alarm() for under a second?, How can I measure time | |
225 | under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception | |
226 | handling), Why doesn't my sockets program work under System V (Solaris)? | |
227 | What does the error message "Protocol not supported" mean?, How can I call | |
228 | my system's unique C functions from Perl?, Where do I get the include files | |
229 | to do ioctl() or syscall()?, Why do setuid perl scripts complain about | |
230 | kernel problems?, How can I open a pipe both to and from a command?, Why | |
231 | can't I get the output of a command with system()?, How can I capture | |
232 | STDERR from an external command?, Why doesn't open() return an error when a | |
233 | pipe open fails?, What's wrong with using backticks in a void context?, How | |
234 | can I call backticks without shell processing?, Why can't my script read | |
235 | from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I | |
236 | convert my shell script to perl?, Can I use perl to run a telnet or ftp | |
237 | session?, How can I write expect in Perl?, Is there a way to hide perl's | |
238 | command line from programs such as "ps"?, I {changed directory, modified my | |
239 | environment} in a perl script. How come the change disappeared when I | |
240 | exited the script? How do I get my changes to be visible?, How do I close | |
241 | a process's filehandle without waiting for it to complete?, How do I fork a | |
242 | daemon process?, How do I make my program run with sh and csh?, How do I | |
243 | find out if I'm running interactively or not?, How do I timeout a slow | |
244 | event?, How do I set CPU limits?, How do I avoid zombies on a Unix system?, | |
245 | How do I use an SQL database?, How do I make a system() exit on control-C?, | |
246 | How do I open a file without blocking?, How do I install a module from | |
247 | CPAN?, What's the difference between require and use?, How do I keep my own | |
248 | module/library directory?, How do I add the directory my program lives in | |
249 | to the module/library search path?, How do I add a directory to my include | |
250 | path at runtime?, What is socket.ph and where do I get it?, L<perlfaq9>: | |
251 | Networking, My CGI script runs from the command line but not the browser. | |
252 | (500 Server Error), How can I get better error messages from a CGI | |
253 | program?, How do I remove HTML from a string?, How do I extract URLs?, How | |
254 | do I download a file from the user's machine? How do I open a file on | |
255 | another machine?, How do I make a pop-up menu in HTML?, How do I fetch an | |
256 | HTML file?, How do I automate an HTML form submission?, How do I decode or | |
257 | create those %-encodings on the web?, How do I redirect to another page?, | |
258 | How do I put a password on my web pages?, How do I edit my .htpasswd and | |
259 | .htgroup files with Perl?, How do I make sure users can't enter values into | |
260 | a form that cause my CGI script to do bad things?, How do I parse a mail | |
261 | header?, How do I decode a CGI form?, How do I check a valid mail address?, | |
262 | How do I decode a MIME/BASE64 string?, How do I return the user's mail | |
263 | address?, How do I send mail?, How do I read mail?, How do I find out my | |
264 | hostname/domainname/IP address?, How do I fetch a news article or the | |
265 | active newsgroups?, How do I fetch/put an FTP file?, How can I do RPC in | |
266 | Perl? | |
68dc0745 | 267 | |
268 | =over | |
269 | ||
270 | =item Where to get this document | |
271 | ||
272 | =item How to contribute to this document | |
273 | ||
274 | =item What will happen if you mail your Perl programming problems to the | |
275 | authors | |
276 | ||
277 | =back | |
278 | ||
279 | =item Credits | |
280 | ||
281 | =item Author and Copyright Information | |
282 | ||
283 | =over | |
284 | ||
fb9cefb4 | 285 | =item Bundled Distributions |
68dc0745 | 286 | |
287 | =item Disclaimer | |
288 | ||
289 | =back | |
290 | ||
291 | =item Changes | |
292 | ||
14218588 GS |
293 | 23/May/99, 13/April/99, 7/January/99, 22/June/98, 24/April/97, 23/April/97, |
294 | 25/March/97, 18/March/97, 17/March/97 Version, Initial Release: 11/March/97 | |
68dc0745 | 295 | |
14218588 GS |
296 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date: |
297 | 1999/05/23 16:08:30 $) | |
68dc0745 | 298 | |
299 | =item DESCRIPTION | |
300 | ||
301 | =over | |
302 | ||
303 | =item What is Perl? | |
304 | ||
305 | =item Who supports Perl? Who develops it? Why is it free? | |
306 | ||
307 | =item Which version of Perl should I use? | |
308 | ||
309 | =item What are perl4 and perl5? | |
310 | ||
14218588 GS |
311 | =item What is perl6? |
312 | ||
68dc0745 | 313 | =item How stable is Perl? |
314 | ||
315 | =item Is Perl difficult to learn? | |
316 | ||
317 | =item How does Perl compare with other languages like Java, Python, REXX, | |
318 | Scheme, or Tcl? | |
319 | ||
320 | =item Can I do [task] in Perl? | |
321 | ||
322 | =item When shouldn't I program in Perl? | |
323 | ||
324 | =item What's the difference between "perl" and "Perl"? | |
325 | ||
326 | =item Is it a Perl program or a Perl script? | |
327 | ||
328 | =item What is a JAPH? | |
329 | ||
330 | =item Where can I get a list of Larry Wall witticisms? | |
331 | ||
332 | =item How can I convince my sysadmin/supervisor/employees to use version | |
14218588 | 333 | (5/5.005/Perl instead of some other language)? |
68dc0745 | 334 | |
335 | =back | |
336 | ||
337 | =item AUTHOR AND COPYRIGHT | |
338 | ||
14218588 GS |
339 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.31 $, |
340 | $Date: 1999/04/14 03:46:19 $) | |
68dc0745 | 341 | |
342 | =item DESCRIPTION | |
343 | ||
344 | =over | |
345 | ||
346 | =item What machines support Perl? Where do I get it? | |
347 | ||
348 | =item How can I get a binary version of Perl? | |
349 | ||
3fe9a6f1 | 350 | =item I don't have a C compiler on my system. How can I compile perl? |
351 | ||
68dc0745 | 352 | =item I copied the Perl binary from one machine to another, but scripts |
353 | don't work. | |
354 | ||
355 | =item I grabbed the sources and tried to compile but gdbm/dynamic | |
356 | loading/malloc/linking/... failed. How do I make it work? | |
357 | ||
14218588 | 358 | =item What modules and extensions are available for Perl? What is CPAN? |
68dc0745 | 359 | What does CPAN/src/... mean? |
360 | ||
361 | =item Is there an ISO or ANSI certified version of Perl? | |
362 | ||
363 | =item Where can I get information on Perl? | |
364 | ||
365 | =item What are the Perl newsgroups on USENET? Where do I post questions? | |
366 | ||
367 | =item Where should I post source code? | |
368 | ||
369 | =item Perl Books | |
370 | ||
14218588 GS |
371 | References, Tutorials |
372 | *Learning Perl [2nd edition] | |
373 | by Randal L. Schwartz and Tom Christiansen | |
374 | with foreword by Larry Wall, Task-Oriented, Special Topics | |
193fb0af | 375 | |
68dc0745 | 376 | =item Perl in Magazines |
377 | ||
378 | =item Perl on the Net: FTP and WWW Access | |
379 | ||
380 | =item What mailing lists are there for perl? | |
381 | ||
68dc0745 | 382 | =item Archives of comp.lang.perl.misc |
383 | ||
68dc0745 | 384 | =item Where can I buy a commercial version of Perl? |
385 | ||
386 | =item Where do I send bug reports? | |
387 | ||
14218588 | 388 | =item What is perl.com? |
68dc0745 | 389 | |
390 | =back | |
391 | ||
392 | =item AUTHOR AND COPYRIGHT | |
393 | ||
14218588 GS |
394 | =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23 |
395 | 16:08:30 $) | |
68dc0745 | 396 | |
397 | =item DESCRIPTION | |
398 | ||
399 | =over | |
400 | ||
401 | =item How do I do (anything)? | |
402 | ||
403 | =item How can I use Perl interactively? | |
404 | ||
405 | =item Is there a Perl shell? | |
406 | ||
407 | =item How do I debug my Perl programs? | |
408 | ||
409 | =item How do I profile my Perl programs? | |
410 | ||
411 | =item How do I cross-reference my Perl programs? | |
412 | ||
413 | =item Is there a pretty-printer (formatter) for Perl? | |
414 | ||
415 | =item Is there a ctags for Perl? | |
416 | ||
14218588 GS |
417 | =item Is there an IDE or Windows Perl Editor? |
418 | ||
68dc0745 | 419 | =item Where can I get Perl macros for vi? |
420 | ||
421 | =item Where can I get perl-mode for emacs? | |
422 | ||
423 | =item How can I use curses with Perl? | |
424 | ||
425 | =item How can I use X or Tk with Perl? | |
426 | ||
427 | =item How can I generate simple menus without using CGI or Tk? | |
428 | ||
68dc0745 | 429 | =item What is undump? |
430 | ||
431 | =item How can I make my Perl program run faster? | |
432 | ||
433 | =item How can I make my Perl program take less memory? | |
434 | ||
435 | =item Is it unsafe to return a pointer to local data? | |
436 | ||
437 | =item How can I free an array or hash so my program shrinks? | |
438 | ||
439 | =item How can I make my CGI script more efficient? | |
440 | ||
441 | =item How can I hide the source for my Perl program? | |
442 | ||
54310121 | 443 | =item How can I compile my Perl program into byte code or C? |
68dc0745 | 444 | |
14218588 GS |
445 | =item How can I compile Perl into Java? |
446 | ||
fb9cefb4 | 447 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? |
68dc0745 | 448 | |
449 | =item Can I write useful perl programs on the command line? | |
450 | ||
46fc3d4c | 451 | =item Why don't perl one-liners work on my DOS/Mac/VMS system? |
68dc0745 | 452 | |
453 | =item Where can I learn about CGI or Web programming in Perl? | |
454 | ||
455 | =item Where can I learn about object-oriented Perl programming? | |
456 | ||
457 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] | |
458 | ||
459 | =item I've read perlembed, perlguts, etc., but I can't embed perl in | |
460 | my C program, what am I doing wrong? | |
461 | ||
462 | =item When I tried to run my script, I got this message. What does it | |
463 | mean? | |
464 | ||
465 | =item What's MakeMaker? | |
466 | ||
467 | =back | |
468 | ||
469 | =item AUTHOR AND COPYRIGHT | |
470 | ||
14218588 GS |
471 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23 |
472 | 20:37:49 $) | |
68dc0745 | 473 | |
474 | =item DESCRIPTION | |
475 | ||
476 | =item Data: Numbers | |
477 | ||
478 | =over | |
479 | ||
46fc3d4c | 480 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the |
481 | numbers I should be getting (eg, 19.95)? | |
482 | ||
68dc0745 | 483 | =item Why isn't my octal data interpreted correctly? |
484 | ||
14218588 | 485 | =item Does Perl have a round() function? What about ceil() and floor()? |
68dc0745 | 486 | Trig functions? |
487 | ||
488 | =item How do I convert bits into ints? | |
489 | ||
14218588 GS |
490 | =item Why doesn't & work the way I want it to? |
491 | ||
68dc0745 | 492 | =item How do I multiply matrices? |
493 | ||
494 | =item How do I perform an operation on a series of integers? | |
495 | ||
496 | =item How can I output Roman numerals? | |
497 | ||
498 | =item Why aren't my random numbers random? | |
499 | ||
500 | =back | |
501 | ||
502 | =item Data: Dates | |
503 | ||
504 | =over | |
505 | ||
506 | =item How do I find the week-of-the-year/day-of-the-year? | |
507 | ||
14218588 GS |
508 | =item How do I find the current century or millennium? |
509 | ||
fb9cefb4 | 510 | =item How can I compare two dates and find the difference? |
68dc0745 | 511 | |
512 | =item How can I take a string and turn it into epoch seconds? | |
513 | ||
514 | =item How can I find the Julian Day? | |
515 | ||
14218588 GS |
516 | =item How do I find yesterday's date? |
517 | ||
193fb0af | 518 | =item Does Perl have a year 2000 problem? Is Perl Y2K compliant? |
68dc0745 | 519 | |
520 | =back | |
521 | ||
522 | =item Data: Strings | |
523 | ||
524 | =over | |
525 | ||
526 | =item How do I validate input? | |
527 | ||
528 | =item How do I unescape a string? | |
529 | ||
530 | =item How do I remove consecutive pairs of characters? | |
531 | ||
532 | =item How do I expand function calls in a string? | |
533 | ||
534 | =item How do I find matching/nesting anything? | |
535 | ||
536 | =item How do I reverse a string? | |
537 | ||
538 | =item How do I expand tabs in a string? | |
539 | ||
540 | =item How do I reformat a paragraph? | |
541 | ||
542 | =item How can I access/change the first N letters of a string? | |
543 | ||
544 | =item How do I change the Nth occurrence of something? | |
545 | ||
546 | =item How can I count the number of occurrences of a substring within a | |
547 | string? | |
548 | ||
549 | =item How do I capitalize all the words on one line? | |
550 | ||
551 | =item How can I split a [character] delimited string except when inside | |
552 | [character]? (Comma-separated files) | |
553 | ||
554 | =item How do I strip blank space from the beginning/end of a string? | |
555 | ||
14218588 GS |
556 | =item How do I pad a string with blanks or pad a number with zeroes? |
557 | ||
68dc0745 | 558 | =item How do I extract selected columns from a string? |
559 | ||
560 | =item How do I find the soundex value of a string? | |
561 | ||
562 | =item How can I expand variables in text strings? | |
563 | ||
564 | =item What's wrong with always quoting "$vars"? | |
565 | ||
14218588 | 566 | =item Why don't my E<lt>E<lt>HERE documents work? |
68dc0745 | 567 | |
568 | 1. There must be no space after the << part, 2. There (probably) should be | |
569 | a semicolon at the end, 3. You can't (easily) have any space in front of | |
570 | the tag | |
571 | ||
572 | =back | |
573 | ||
574 | =item Data: Arrays | |
575 | ||
576 | =over | |
577 | ||
14218588 GS |
578 | =item What is the difference between a list and an array? |
579 | ||
68dc0745 | 580 | =item What is the difference between $array[1] and @array[1]? |
581 | ||
14218588 | 582 | =item How can I remove duplicate elements from a list or array? |
68dc0745 | 583 | |
193fb0af GS |
584 | a) If @in is sorted, and you want @out to be sorted:(this assumes all true |
585 | values in the array), b) If you don't know whether @in is sorted:, c) Like | |
586 | (b), but @in contains only small integers:, d) A way to do (b) without any | |
587 | loops or greps:, e) Like (d), but @in contains only small positive | |
588 | integers: | |
68dc0745 | 589 | |
193fb0af | 590 | =item How can I tell whether a list or array contains a certain element? |
68dc0745 | 591 | |
592 | =item How do I compute the difference of two arrays? How do I compute the | |
593 | intersection of two arrays? | |
594 | ||
14218588 GS |
595 | =item How do I test whether two arrays or hashes are equal? |
596 | ||
68dc0745 | 597 | =item How do I find the first array element for which a condition is true? |
598 | ||
599 | =item How do I handle linked lists? | |
600 | ||
601 | =item How do I handle circular lists? | |
602 | ||
603 | =item How do I shuffle an array randomly? | |
604 | ||
605 | =item How do I process/modify each element of an array? | |
606 | ||
607 | =item How do I select a random element from an array? | |
608 | ||
609 | =item How do I permute N elements of a list? | |
610 | ||
611 | =item How do I sort an array by (anything)? | |
612 | ||
613 | =item How do I manipulate arrays of bits? | |
614 | ||
615 | =item Why does defined() return true on empty arrays and hashes? | |
616 | ||
617 | =back | |
618 | ||
619 | =item Data: Hashes (Associative Arrays) | |
620 | ||
621 | =over | |
622 | ||
623 | =item How do I process an entire hash? | |
624 | ||
625 | =item What happens if I add or remove keys from a hash while iterating over | |
626 | it? | |
627 | ||
628 | =item How do I look up a hash element by value? | |
629 | ||
630 | =item How can I know how many entries are in a hash? | |
631 | ||
632 | =item How do I sort a hash (optionally by value instead of key)? | |
633 | ||
634 | =item How can I always keep my hash sorted? | |
635 | ||
636 | =item What's the difference between "delete" and "undef" with hashes? | |
637 | ||
638 | =item Why don't my tied hashes make the defined/exists distinction? | |
639 | ||
640 | =item How do I reset an each() operation part-way through? | |
641 | ||
642 | =item How can I get the unique keys from two hashes? | |
643 | ||
644 | =item How can I store a multidimensional array in a DBM file? | |
645 | ||
646 | =item How can I make my hash remember the order I put elements into it? | |
647 | ||
648 | =item Why does passing a subroutine an undefined element in a hash create | |
649 | it? | |
650 | ||
fc36a67e | 651 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or |
652 | array of hashes or arrays? | |
68dc0745 | 653 | |
654 | =item How can I use a reference as a hash key? | |
655 | ||
656 | =back | |
657 | ||
658 | =item Data: Misc | |
659 | ||
660 | =over | |
661 | ||
662 | =item How do I handle binary data correctly? | |
663 | ||
664 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
665 | ||
666 | =item How do I keep persistent data across program calls? | |
667 | ||
668 | =item How do I print out or copy a recursive data structure? | |
669 | ||
670 | =item How do I define methods for every class/object? | |
671 | ||
672 | =item How do I verify a credit card checksum? | |
673 | ||
14218588 GS |
674 | =item How do I pack arrays of doubles or floats for XS code? |
675 | ||
68dc0745 | 676 | =back |
677 | ||
678 | =item AUTHOR AND COPYRIGHT | |
679 | ||
14218588 GS |
680 | =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23 |
681 | 16:08:30 $) | |
68dc0745 | 682 | |
683 | =item DESCRIPTION | |
684 | ||
685 | =over | |
686 | ||
193fb0af | 687 | =item How do I flush/unbuffer an output filehandle? Why must I do this? |
68dc0745 | 688 | |
689 | =item How do I change one line in a file/delete a line in a file/insert a | |
690 | line in the middle of a file/append to the beginning of a file? | |
691 | ||
692 | =item How do I count the number of lines in a file? | |
693 | ||
694 | =item How do I make a temporary file name? | |
695 | ||
696 | =item How can I manipulate fixed-record-length files? | |
697 | ||
698 | =item How can I make a filehandle local to a subroutine? How do I pass | |
699 | filehandles between subroutines? How do I make an array of filehandles? | |
700 | ||
193fb0af GS |
701 | =item How can I use a filehandle indirectly? |
702 | ||
68dc0745 | 703 | =item How can I set up a footer format to be used with write()? |
704 | ||
705 | =item How can I write() into a string? | |
706 | ||
707 | =item How can I output my numbers with commas added? | |
708 | ||
709 | =item How can I translate tildes (~) in a filename? | |
710 | ||
193fb0af | 711 | =item How come when I open a file read-write it wipes it out? |
68dc0745 | 712 | |
14218588 GS |
713 | =item Why do I sometimes get an "Argument list too long" when I use |
714 | E<lt>*E<gt>? | |
68dc0745 | 715 | |
716 | =item Is there a leak/bug in glob()? | |
717 | ||
718 | =item How can I open a file with a leading "E<gt>" or trailing blanks? | |
719 | ||
720 | =item How can I reliably rename a file? | |
721 | ||
722 | =item How can I lock a file? | |
723 | ||
14218588 | 724 | =item Why can't I just open(FH, ">file.lock")? |
68dc0745 | 725 | |
fc36a67e | 726 | =item I still don't get locking. I just want to increment the number in |
727 | the file. How can I do this? | |
68dc0745 | 728 | |
729 | =item How do I randomly update a binary file? | |
730 | ||
731 | =item How do I get a file's timestamp in perl? | |
732 | ||
733 | =item How do I set a file's timestamp in perl? | |
734 | ||
735 | =item How do I print to more than one file at once? | |
736 | ||
14218588 GS |
737 | =item How can I read in an entire file all at once? |
738 | ||
68dc0745 | 739 | =item How can I read in a file by paragraphs? |
740 | ||
741 | =item How can I read a single character from a file? From the keyboard? | |
742 | ||
14218588 | 743 | =item How can I tell whether there's a character waiting on a filehandle? |
68dc0745 | 744 | |
68dc0745 | 745 | =item How do I do a C<tail -f> in perl? |
746 | ||
747 | =item How do I dup() a filehandle in Perl? | |
748 | ||
749 | =item How do I close a file descriptor by number? | |
750 | ||
46fc3d4c | 751 | =item Why can't I use "C:\temp\foo" in DOS paths? What doesn't |
68dc0745 | 752 | `C:\temp\foo.exe` work? |
753 | ||
754 | =item Why doesn't glob("*.*") get all the files? | |
755 | ||
756 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber | |
757 | protected files? Isn't this a bug in Perl? | |
758 | ||
759 | =item How do I select a random line from a file? | |
760 | ||
14218588 GS |
761 | =item Why do I get weird spaces when I print an array of lines? |
762 | ||
68dc0745 | 763 | =back |
764 | ||
765 | =item AUTHOR AND COPYRIGHT | |
766 | ||
14218588 | 767 | =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $) |
68dc0745 | 768 | |
769 | =item DESCRIPTION | |
770 | ||
771 | =over | |
772 | ||
773 | =item How can I hope to use regular expressions without creating illegible | |
54310121 | 774 | and unmaintainable code? |
68dc0745 | 775 | |
14218588 | 776 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters |
68dc0745 | 777 | |
778 | =item I'm having trouble matching over more than one line. What's wrong? | |
779 | ||
780 | =item How can I pull out lines between two patterns that are themselves on | |
781 | different lines? | |
782 | ||
783 | =item I put a regular expression into $/ but it didn't work. What's wrong? | |
784 | ||
785 | =item How do I substitute case insensitively on the LHS, but preserving | |
786 | case on the RHS? | |
787 | ||
193fb0af | 788 | =item How can I make C<\w> match national character sets? |
68dc0745 | 789 | |
790 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? | |
791 | ||
14218588 | 792 | =item How can I quote a variable to use in a regex? |
68dc0745 | 793 | |
794 | =item What is C</o> really for? | |
795 | ||
796 | =item How do I use a regular expression to strip C style comments from a | |
797 | file? | |
798 | ||
799 | =item Can I use Perl regular expressions to match balanced text? | |
800 | ||
14218588 | 801 | =item What does it mean that regexes are greedy? How can I get around it? |
68dc0745 | 802 | |
803 | =item How do I process each word on each line? | |
804 | ||
805 | =item How can I print out a word-frequency or line-frequency summary? | |
806 | ||
807 | =item How can I do approximate matching? | |
808 | ||
809 | =item How do I efficiently match many regular expressions at once? | |
810 | ||
811 | =item Why don't word-boundary searches with C<\b> work for me? | |
812 | ||
813 | =item Why does using $&, $`, or $' slow my program down? | |
814 | ||
815 | =item What good is C<\G> in a regular expression? | |
816 | ||
14218588 | 817 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? |
68dc0745 | 818 | |
819 | =item What's wrong with using grep or map in a void context? | |
820 | ||
54310121 | 821 | =item How can I match strings with multibyte characters? |
68dc0745 | 822 | |
14218588 GS |
823 | =item How do I match a pattern that is supplied by the user? |
824 | ||
68dc0745 | 825 | =back |
826 | ||
827 | =item AUTHOR AND COPYRIGHT | |
828 | ||
14218588 GS |
829 | =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date: |
830 | 1999/05/23 20:36:18 $) | |
68dc0745 | 831 | |
832 | =item DESCRIPTION | |
833 | ||
834 | =over | |
835 | ||
836 | =item Can I get a BNF/yacc/RE for the Perl language? | |
837 | ||
14218588 | 838 | =item What are all these $@%&* punctuation signs, and how do I know when to |
68dc0745 | 839 | use them? |
840 | ||
841 | =item Do I always/never have to quote my strings or use semicolons and | |
842 | commas? | |
843 | ||
844 | =item How do I skip some return values? | |
845 | ||
846 | =item How do I temporarily block warnings? | |
847 | ||
848 | =item What's an extension? | |
849 | ||
850 | =item Why do Perl operators have different precedence than C operators? | |
851 | ||
852 | =item How do I declare/create a structure? | |
853 | ||
854 | =item How do I create a module? | |
855 | ||
856 | =item How do I create a class? | |
857 | ||
858 | =item How can I tell if a variable is tainted? | |
859 | ||
860 | =item What's a closure? | |
861 | ||
46fc3d4c | 862 | =item What is variable suicide and how can I prevent it? |
863 | ||
68dc0745 | 864 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
14218588 | 865 | Regex}? |
68dc0745 | 866 | |
14218588 | 867 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
68dc0745 | 868 | Passing Methods |
869 | ||
870 | =item How do I create a static variable? | |
871 | ||
14218588 | 872 | =item What's the difference between dynamic and lexical (static) scoping? |
68dc0745 | 873 | Between local() and my()? |
874 | ||
875 | =item How can I access a dynamic variable while a similarly named lexical | |
876 | is in scope? | |
877 | ||
878 | =item What's the difference between deep and shallow binding? | |
879 | ||
14218588 | 880 | =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right? |
68dc0745 | 881 | |
54310121 | 882 | =item How do I redefine a builtin function, operator, or method? |
68dc0745 | 883 | |
884 | =item What's the difference between calling a function as &foo and foo()? | |
885 | ||
886 | =item How do I create a switch or case statement? | |
887 | ||
888 | =item How can I catch accesses to undefined variables/functions/methods? | |
889 | ||
890 | =item Why can't a method included in this same file be found? | |
891 | ||
892 | =item How can I find out my current package? | |
893 | ||
46fc3d4c | 894 | =item How can I comment out a large block of perl code? |
895 | ||
14218588 GS |
896 | =item How do I clear a package? |
897 | ||
898 | =item How can I use a variable as a variable name? | |
899 | ||
68dc0745 | 900 | =back |
901 | ||
902 | =item AUTHOR AND COPYRIGHT | |
903 | ||
14218588 GS |
904 | =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23 |
905 | 18:37:57 $) | |
68dc0745 | 906 | |
907 | =item DESCRIPTION | |
908 | ||
909 | =over | |
910 | ||
911 | =item How do I find out which operating system I'm running under? | |
912 | ||
913 | =item How come exec() doesn't return? | |
914 | ||
915 | =item How do I do fancy stuff with the keyboard/screen/mouse? | |
916 | ||
917 | Keyboard, Screen, Mouse | |
918 | ||
fb9cefb4 GS |
919 | =item How do I print something out in color? |
920 | ||
921 | =item How do I read just one key without waiting for a return key? | |
922 | ||
923 | =item How do I check whether input is ready on the keyboard? | |
924 | ||
925 | =item How do I clear the screen? | |
926 | ||
927 | =item How do I get the screen size? | |
928 | ||
68dc0745 | 929 | =item How do I ask the user for a password? |
930 | ||
931 | =item How do I read and write the serial port? | |
932 | ||
933 | lockfiles, open mode, end of line, flushing output, non-blocking input | |
934 | ||
935 | =item How do I decode encrypted password files? | |
936 | ||
937 | =item How do I start a process in the background? | |
938 | ||
fb9cefb4 | 939 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
68dc0745 | 940 | |
941 | =item How do I trap control characters/signals? | |
942 | ||
943 | =item How do I modify the shadow password file on a Unix system? | |
944 | ||
945 | =item How do I set the time and date? | |
946 | ||
947 | =item How can I sleep() or alarm() for under a second? | |
948 | ||
949 | =item How can I measure time under a second? | |
950 | ||
951 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) | |
952 | ||
953 | =item Why doesn't my sockets program work under System V (Solaris)? What | |
954 | does the error message "Protocol not supported" mean? | |
955 | ||
956 | =item How can I call my system's unique C functions from Perl? | |
957 | ||
958 | =item Where do I get the include files to do ioctl() or syscall()? | |
959 | ||
960 | =item Why do setuid perl scripts complain about kernel problems? | |
961 | ||
962 | =item How can I open a pipe both to and from a command? | |
963 | ||
3fe9a6f1 | 964 | =item Why can't I get the output of a command with system()? |
965 | ||
68dc0745 | 966 | =item How can I capture STDERR from an external command? |
967 | ||
968 | =item Why doesn't open() return an error when a pipe open fails? | |
969 | ||
970 | =item What's wrong with using backticks in a void context? | |
971 | ||
972 | =item How can I call backticks without shell processing? | |
973 | ||
974 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, | |
54310121 | 975 | ^Z on MS-DOS)? |
68dc0745 | 976 | |
977 | =item How can I convert my shell script to perl? | |
978 | ||
979 | =item Can I use perl to run a telnet or ftp session? | |
980 | ||
981 | =item How can I write expect in Perl? | |
982 | ||
983 | =item Is there a way to hide perl's command line from programs such as | |
984 | "ps"? | |
985 | ||
986 | =item I {changed directory, modified my environment} in a perl script. How | |
987 | come the change disappeared when I exited the script? How do I get my | |
988 | changes to be visible? | |
989 | ||
fb9cefb4 | 990 | Unix |
68dc0745 | 991 | |
992 | =item How do I close a process's filehandle without waiting for it to | |
993 | complete? | |
994 | ||
995 | =item How do I fork a daemon process? | |
996 | ||
997 | =item How do I make my program run with sh and csh? | |
998 | ||
68dc0745 | 999 | =item How do I find out if I'm running interactively or not? |
1000 | ||
1001 | =item How do I timeout a slow event? | |
1002 | ||
1003 | =item How do I set CPU limits? | |
1004 | ||
1005 | =item How do I avoid zombies on a Unix system? | |
1006 | ||
1007 | =item How do I use an SQL database? | |
1008 | ||
1009 | =item How do I make a system() exit on control-C? | |
1010 | ||
1011 | =item How do I open a file without blocking? | |
1012 | ||
14218588 | 1013 | =item How do I install a module from CPAN? |
68dc0745 | 1014 | |
fb9cefb4 GS |
1015 | =item What's the difference between require and use? |
1016 | ||
46fc3d4c | 1017 | =item How do I keep my own module/library directory? |
1018 | ||
1019 | =item How do I add the directory my program lives in to the module/library | |
1020 | search path? | |
1021 | ||
1022 | =item How do I add a directory to my include path at runtime? | |
1023 | ||
14218588 GS |
1024 | =item What is socket.ph and where do I get it? |
1025 | ||
68dc0745 | 1026 | =back |
1027 | ||
fc36a67e | 1028 | =item AUTHOR AND COPYRIGHT |
1029 | ||
14218588 | 1030 | =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30 |
3fe9a6f1 | 1031 | $) |
68dc0745 | 1032 | |
1033 | =item DESCRIPTION | |
1034 | ||
1035 | =over | |
1036 | ||
fb9cefb4 GS |
1037 | =item My CGI script runs from the command line but not the browser. (500 |
1038 | Server Error) | |
1039 | ||
1040 | =item How can I get better error messages from a CGI program? | |
68dc0745 | 1041 | |
1042 | =item How do I remove HTML from a string? | |
1043 | ||
1044 | =item How do I extract URLs? | |
1045 | ||
1046 | =item How do I download a file from the user's machine? How do I open a | |
1047 | file on another machine? | |
1048 | ||
1049 | =item How do I make a pop-up menu in HTML? | |
1050 | ||
1051 | =item How do I fetch an HTML file? | |
1052 | ||
fb9cefb4 GS |
1053 | =item How do I automate an HTML form submission? |
1054 | ||
1055 | =item How do I decode or create those %-encodings on the web? | |
68dc0745 | 1056 | |
1057 | =item How do I redirect to another page? | |
1058 | ||
1059 | =item How do I put a password on my web pages? | |
1060 | ||
1061 | =item How do I edit my .htpasswd and .htgroup files with Perl? | |
1062 | ||
46fc3d4c | 1063 | =item How do I make sure users can't enter values into a form that cause my |
1064 | CGI script to do bad things? | |
1065 | ||
193fb0af | 1066 | =item How do I parse a mail header? |
68dc0745 | 1067 | |
1068 | =item How do I decode a CGI form? | |
1069 | ||
193fb0af | 1070 | =item How do I check a valid mail address? |
68dc0745 | 1071 | |
1072 | =item How do I decode a MIME/BASE64 string? | |
1073 | ||
193fb0af | 1074 | =item How do I return the user's mail address? |
68dc0745 | 1075 | |
fb9cefb4 GS |
1076 | =item How do I send mail? |
1077 | ||
1078 | =item How do I read mail? | |
68dc0745 | 1079 | |
1080 | =item How do I find out my hostname/domainname/IP address? | |
1081 | ||
1082 | =item How do I fetch a news article or the active newsgroups? | |
1083 | ||
1084 | =item How do I fetch/put an FTP file? | |
1085 | ||
1086 | =item How can I do RPC in Perl? | |
1087 | ||
1088 | =back | |
1089 | ||
1090 | =item AUTHOR AND COPYRIGHT | |
1091 | ||
14218588 | 1092 | =head2 perldelta - what's new for perl5.006 (as of 5.005_56) |
cb1a09d0 | 1093 | |
8ebc5c01 | 1094 | =item DESCRIPTION |
cb1a09d0 | 1095 | |
193fb0af | 1096 | =item Incompatible Changes |
cb1a09d0 | 1097 | |
fb9cefb4 GS |
1098 | =over |
1099 | ||
14218588 | 1100 | =item Perl Source Incompatibilities |
fb9cefb4 | 1101 | |
14218588 | 1102 | =item C Source Incompatibilities |
fb9cefb4 | 1103 | |
14218588 | 1104 | C<PERL_POLLUTE>, C<PERL_POLLUTE_MALLOC>, C<PL_na> and C<dTHR> Issues |
fb9cefb4 | 1105 | |
14218588 | 1106 | =item Compatible C Source API Changes |
fb9cefb4 | 1107 | |
14218588 | 1108 | C<PATCHLEVEL> is now C<PERL_VERSION> |
fb9cefb4 | 1109 | |
14218588 | 1110 | =item Binary Incompatibilities |
fb9cefb4 GS |
1111 | |
1112 | =back | |
1113 | ||
8ebc5c01 | 1114 | =item Core Changes |
cb1a09d0 | 1115 | |
fb9cefb4 GS |
1116 | =over |
1117 | ||
14218588 | 1118 | =item Unicode and UTF-8 support |
fb9cefb4 | 1119 | |
14218588 | 1120 | =item Lexically scoped warning categories |
637e9122 | 1121 | |
14218588 | 1122 | =item Binary numbers supported |
637e9122 | 1123 | |
14218588 | 1124 | =item syswrite() ease-of-use |
637e9122 | 1125 | |
14218588 | 1126 | =item 64-bit support |
fb9cefb4 | 1127 | |
14218588 | 1128 | =item Better syntax checks on parenthesized unary operators |
fb9cefb4 | 1129 | |
14218588 | 1130 | =item Improved C<qw//> operator |
fb9cefb4 | 1131 | |
14218588 | 1132 | =item pack() format 'Z' supported |
fb9cefb4 | 1133 | |
14218588 | 1134 | =item pack() format modifier '!' supported |
fb9cefb4 | 1135 | |
14218588 | 1136 | =item $^X variables may now have names longer than one character |
fb9cefb4 | 1137 | |
14218588 | 1138 | =back |
fb9cefb4 | 1139 | |
14218588 | 1140 | =item Significant bug fixes |
fb9cefb4 | 1141 | |
14218588 | 1142 | =over |
fb9cefb4 | 1143 | |
14218588 | 1144 | =item E<lt>HANDLEE<gt> on empty files |
fb9cefb4 | 1145 | |
14218588 | 1146 | =item C<eval '...'> improvements |
fb9cefb4 | 1147 | |
14218588 | 1148 | =item Automatic flushing of output buffers |
fb9cefb4 GS |
1149 | |
1150 | =back | |
1151 | ||
1152 | =item Supported Platforms | |
1153 | ||
14218588 | 1154 | =item New tests |
fb9cefb4 GS |
1155 | |
1156 | =item Modules and Pragmata | |
cb1a09d0 | 1157 | |
8ebc5c01 | 1158 | =over |
1159 | ||
14218588 | 1160 | =item Modules |
fb9cefb4 | 1161 | |
14218588 GS |
1162 | Dumpvalue, Benchmark, Devel::Peek, Fcntl, File::Spec, |
1163 | File::Spec::Functions, Math::BigInt, Math::Complex, Math::Trig, SDBM_File, | |
1164 | Time::Local, Win32, DBM Filters | |
fb9cefb4 | 1165 | |
14218588 | 1166 | =item Pragmata |
5cd24f17 | 1167 | |
cb1a09d0 AD |
1168 | =back |
1169 | ||
774d564b | 1170 | =item Utility Changes |
1171 | ||
8ebc5c01 | 1172 | =item Documentation Changes |
cb1a09d0 | 1173 | |
14218588 GS |
1174 | perlopentut.pod, perlreftut.pod, perltootc.pod |
1175 | ||
fb9cefb4 GS |
1176 | =item New Diagnostics |
1177 | ||
14218588 | 1178 | /%s/: Unrecognized escape \\%c passed through, Unrecognized escape \\%c |
a10cf691 GS |
1179 | passed through, Missing command in piped open, defined(@array) is |
1180 | deprecated (and not really meaningful), defined(%hash) is deprecated (and | |
1181 | not really meaningful) | |
fb9cefb4 GS |
1182 | |
1183 | =item Obsolete Diagnostics | |
1184 | ||
14218588 | 1185 | =item Configuration Changes |
fb9cefb4 | 1186 | |
8ebc5c01 | 1187 | =item BUGS |
cb1a09d0 | 1188 | |
8ebc5c01 | 1189 | =item SEE ALSO |
cb1a09d0 | 1190 | |
8ebc5c01 | 1191 | =item HISTORY |
cb1a09d0 | 1192 | |
8ebc5c01 | 1193 | =head2 perldata - Perl data types |
cb1a09d0 | 1194 | |
8ebc5c01 | 1195 | =item DESCRIPTION |
cb1a09d0 | 1196 | |
8ebc5c01 | 1197 | =over |
cb1a09d0 | 1198 | |
8ebc5c01 | 1199 | =item Variable names |
cb1a09d0 | 1200 | |
8ebc5c01 | 1201 | =item Context |
cb1a09d0 | 1202 | |
8ebc5c01 | 1203 | =item Scalar values |
cb1a09d0 | 1204 | |
8ebc5c01 | 1205 | =item Scalar value constructors |
cb1a09d0 | 1206 | |
8ebc5c01 | 1207 | =item List value constructors |
cb1a09d0 | 1208 | |
14218588 GS |
1209 | =item Slices |
1210 | ||
8ebc5c01 | 1211 | =item Typeglobs and Filehandles |
cb1a09d0 | 1212 | |
8ebc5c01 | 1213 | =back |
cb1a09d0 | 1214 | |
14218588 GS |
1215 | =item SEE ALSO |
1216 | ||
8ebc5c01 | 1217 | =head2 perlsyn - Perl syntax |
cb1a09d0 | 1218 | |
8ebc5c01 | 1219 | =item DESCRIPTION |
cb1a09d0 | 1220 | |
8ebc5c01 | 1221 | =over |
cb1a09d0 | 1222 | |
8ebc5c01 | 1223 | =item Declarations |
cb1a09d0 | 1224 | |
8ebc5c01 | 1225 | =item Simple statements |
cb1a09d0 | 1226 | |
8ebc5c01 | 1227 | =item Compound statements |
cb1a09d0 | 1228 | |
8ebc5c01 | 1229 | =item Loop Control |
cb1a09d0 | 1230 | |
8ebc5c01 | 1231 | =item For Loops |
cb1a09d0 | 1232 | |
8ebc5c01 | 1233 | =item Foreach Loops |
cb1a09d0 | 1234 | |
8ebc5c01 | 1235 | =item Basic BLOCKs and Switch Statements |
cb1a09d0 | 1236 | |
8ebc5c01 | 1237 | =item Goto |
cb1a09d0 | 1238 | |
8ebc5c01 | 1239 | =item PODs: Embedded Documentation |
cb1a09d0 | 1240 | |
774d564b | 1241 | =item Plain Old Comments (Not!) |
1242 | ||
8ebc5c01 | 1243 | =back |
cb1a09d0 AD |
1244 | |
1245 | =head2 perlop - Perl operators and precedence | |
1246 | ||
1247 | =item SYNOPSIS | |
1248 | ||
cb1a09d0 AD |
1249 | =item DESCRIPTION |
1250 | ||
cb1a09d0 AD |
1251 | =over |
1252 | ||
1253 | =item Terms and List Operators (Leftward) | |
1254 | ||
cb1a09d0 AD |
1255 | =item The Arrow Operator |
1256 | ||
5f05dabc | 1257 | =item Auto-increment and Auto-decrement |
cb1a09d0 | 1258 | |
cb1a09d0 AD |
1259 | =item Exponentiation |
1260 | ||
cb1a09d0 AD |
1261 | =item Symbolic Unary Operators |
1262 | ||
cb1a09d0 AD |
1263 | =item Binding Operators |
1264 | ||
cb1a09d0 AD |
1265 | =item Multiplicative Operators |
1266 | ||
cb1a09d0 AD |
1267 | =item Additive Operators |
1268 | ||
cb1a09d0 AD |
1269 | =item Shift Operators |
1270 | ||
cb1a09d0 AD |
1271 | =item Named Unary Operators |
1272 | ||
cb1a09d0 AD |
1273 | =item Relational Operators |
1274 | ||
cb1a09d0 AD |
1275 | =item Equality Operators |
1276 | ||
cb1a09d0 AD |
1277 | =item Bitwise And |
1278 | ||
cb1a09d0 AD |
1279 | =item Bitwise Or and Exclusive Or |
1280 | ||
cb1a09d0 AD |
1281 | =item C-style Logical And |
1282 | ||
cb1a09d0 AD |
1283 | =item C-style Logical Or |
1284 | ||
193fb0af | 1285 | =item Range Operators |
cb1a09d0 | 1286 | |
cb1a09d0 AD |
1287 | =item Conditional Operator |
1288 | ||
cb1a09d0 AD |
1289 | =item Assignment Operators |
1290 | ||
cb1a09d0 AD |
1291 | =item Comma Operator |
1292 | ||
cb1a09d0 AD |
1293 | =item List Operators (Rightward) |
1294 | ||
cb1a09d0 AD |
1295 | =item Logical Not |
1296 | ||
cb1a09d0 AD |
1297 | =item Logical And |
1298 | ||
cb1a09d0 AD |
1299 | =item Logical or and Exclusive Or |
1300 | ||
cb1a09d0 AD |
1301 | =item C Operators Missing From Perl |
1302 | ||
cb1a09d0 AD |
1303 | unary &, unary *, (TYPE) |
1304 | ||
5f05dabc | 1305 | =item Quote and Quote-like Operators |
cb1a09d0 | 1306 | |
8ebc5c01 | 1307 | =item Regexp Quote-Like Operators |
cb1a09d0 | 1308 | |
d516a115 | 1309 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, |
fb9cefb4 | 1310 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, |
14218588 GS |
1311 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC, |
1312 | y/SEARCHLIST/REPLACEMENTLIST/cdsUC | |
cb1a09d0 | 1313 | |
fb9cefb4 GS |
1314 | =item Gory details of parsing quoted constructs |
1315 | ||
1316 | Finding the end, Removal of backslashes before delimiters, Interpolation, | |
1317 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
1318 | C<``>, C<qq//>, C<qx//>, C<<file*globE<gt>>, C<?RE?>, C</RE/>, C<m/RE/>, | |
1319 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
1320 | regular expressions | |
1321 | ||
cb1a09d0 AD |
1322 | =item I/O Operators |
1323 | ||
cb1a09d0 AD |
1324 | =item Constant Folding |
1325 | ||
193fb0af GS |
1326 | =item Bitwise String Operators |
1327 | ||
55497cff | 1328 | =item Integer Arithmetic |
cb1a09d0 | 1329 | |
68dc0745 | 1330 | =item Floating-point Arithmetic |
1331 | ||
193fb0af GS |
1332 | =item Bigger Numbers |
1333 | ||
cb1a09d0 AD |
1334 | =back |
1335 | ||
cb1a09d0 AD |
1336 | =head2 perlre - Perl regular expressions |
1337 | ||
1338 | =item DESCRIPTION | |
1339 | ||
55497cff | 1340 | i, m, s, x |
1341 | ||
cb1a09d0 AD |
1342 | =over |
1343 | ||
1344 | =item Regular Expressions | |
1345 | ||
14218588 GS |
1346 | =item Extended Patterns |
1347 | ||
1348 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, | |
1349 | C<(?=pattern)>, C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{ | |
1350 | code })>, C<(?p{ code })>, C<(?E<gt>pattern)>, | |
1351 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
cb1a09d0 | 1352 | |
7d2bfb28 | 1353 | =item Backtracking |
1354 | ||
cb1a09d0 AD |
1355 | =item Version 8 Regular Expressions |
1356 | ||
14218588 | 1357 | =item Warning on \1 vs $1 |
cb1a09d0 | 1358 | |
fb9cefb4 GS |
1359 | =item Repeated patterns matching zero-length substring |
1360 | ||
1361 | =item Creating custom RE engines | |
1362 | ||
cb1a09d0 AD |
1363 | =back |
1364 | ||
14218588 GS |
1365 | =item BUGS |
1366 | ||
1367 | =item SEE ALSO | |
1368 | ||
cb1a09d0 AD |
1369 | =head2 perlrun - how to execute the Perl interpreter |
1370 | ||
1371 | =item SYNOPSIS | |
1372 | ||
cb1a09d0 AD |
1373 | =item DESCRIPTION |
1374 | ||
cb1a09d0 AD |
1375 | =over |
1376 | ||
68dc0745 | 1377 | =item #! and quoting on non-Unix systems |
1378 | ||
14218588 | 1379 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS |
68dc0745 | 1380 | |
193fb0af GS |
1381 | =item Location of Perl |
1382 | ||
14218588 | 1383 | =item Command Switches |
cb1a09d0 | 1384 | |
d516a115 JH |
1385 | B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>, |
1386 | B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>, | |
8ebc5c01 | 1387 | B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>], |
1388 | B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
1389 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, | |
1390 | B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-x> I<directory> | |
cb1a09d0 AD |
1391 | |
1392 | =back | |
1393 | ||
1e422769 | 1394 | =item ENVIRONMENT |
1395 | ||
3e3baf6d | 1396 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL |
14218588 | 1397 | (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL |
1e422769 | 1398 | |
cb1a09d0 AD |
1399 | =head2 perlfunc - Perl builtin functions |
1400 | ||
1401 | =item DESCRIPTION | |
1402 | ||
cb1a09d0 AD |
1403 | =over |
1404 | ||
1405 | =item Perl Functions by Category | |
1406 | ||
8ebc5c01 | 1407 | Functions for SCALARs or strings, Regular expressions and pattern matching, |
1408 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
1409 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
1410 | length data or records, Functions for filehandles, files, or directories, | |
1411 | Keywords related to the control flow of your perl program, Keywords related | |
1412 | to scoping, Miscellaneous functions, Functions for processes and process | |
1413 | groups, Keywords related to perl modules, Keywords related to classes and | |
1414 | object-orientedness, Low-level socket functions, System V interprocess | |
1415 | communication functions, Fetching user and group info, Fetching network | |
1416 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
1417 | in perl5 | |
cb1a09d0 | 1418 | |
14218588 GS |
1419 | =item Portability |
1420 | ||
cb1a09d0 AD |
1421 | =item Alphabetical Listing of Perl Functions |
1422 | ||
d516a115 | 1423 | I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept |
8ebc5c01 | 1424 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, |
1425 | binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller, | |
1426 | chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE, | |
1427 | chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot, | |
fb9cefb4 GS |
1428 | close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue |
1429 | BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen | |
14218588 GS |
1430 | HASH,DBNAME,MASK, defined EXPR, defined, delete EXPR, die LIST, do BLOCK, |
1431 | do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, each HASH, eof FILEHANDLE, | |
1432 | eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists | |
1433 | EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno | |
fb9cefb4 GS |
1434 | FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline |
1435 | PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp | |
1436 | PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, | |
1437 | gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, | |
1438 | getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, | |
1439 | getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport | |
1440 | PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent, | |
1441 | getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN, | |
1442 | setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent, | |
1443 | endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt | |
193fb0af GS |
1444 | SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR, |
1445 | goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index | |
1446 | STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl | |
1447 | FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last | |
1448 | LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link | |
14218588 GS |
1449 | OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock, |
1450 | log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST, | |
1451 | map EXPR,LIST, mkdir FILENAME,MASK, msgctl ID,CMD,ARG, msgget KEY,FLAGS, | |
1452 | msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL, | |
1453 | next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE, | |
1454 | opendir DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package | |
193fb0af GS |
1455 | NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, |
1456 | print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, | |
1457 | printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, | |
fb9cefb4 GS |
1458 | qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, |
1459 | rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read | |
1460 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, | |
14218588 | 1461 | readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, |
fb9cefb4 GS |
1462 | ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR, |
1463 | reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex | |
1464 | STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar | |
1465 | EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select | |
1466 | FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl | |
1467 | ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
1468 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority | |
1469 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
1470 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
1471 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
1472 | EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair | |
8ebc5c01 | 1473 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, |
1474 | sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, | |
1475 | splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, | |
1476 | split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, | |
b971f6e4 | 1477 | srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK, |
193fb0af GS |
1478 | sub NAME, sub NAME BLOCK, substr EXPR,OFFSET,LEN,REPLACEMENT, substr |
1479 | EXPR,OFFSET,LEN, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, | |
1480 | sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, | |
1481 | sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, | |
1482 | sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, | |
1483 | syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite | |
14218588 GS |
1484 | FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, |
1485 | tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, | |
1486 | times, tr///, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, | |
1487 | uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef EXPR, undef, unlink | |
1488 | LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use | |
1489 | Module LIST, use Module, use Module VERSION LIST, use VERSION, utime LIST, | |
1490 | values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn | |
1491 | LIST, write FILEHANDLE, write EXPR, write, y/// | |
cb1a09d0 AD |
1492 | |
1493 | =back | |
1494 | ||
cb1a09d0 AD |
1495 | =head2 perlvar - Perl predefined variables |
1496 | ||
1497 | =item DESCRIPTION | |
1498 | ||
cb1a09d0 AD |
1499 | =over |
1500 | ||
1501 | =item Predefined Names | |
1502 | ||
193fb0af | 1503 | $ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
14218588 GS |
1504 | $LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number |
1505 | HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE | |
1506 | EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, | |
1507 | $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR, | |
1508 | $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR, | |
1509 | $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", | |
1510 | $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE | |
1511 | EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR, | |
1512 | $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR, | |
1513 | $FORMAT_LINES_LEFT, $-, @-, format_name HANDLE EXPR, $FORMAT_NAME, $~, | |
1514 | format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^, | |
8ebc5c01 | 1515 | format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS, |
1516 | $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, | |
ff0cee69 | 1517 | $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, |
1518 | $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, | |
1519 | $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(, | |
1520 | $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $], | |
14218588 GS |
1521 | $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, |
1522 | $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, | |
1523 | $^R, $^S, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, | |
1524 | @ARGV, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} | |
cb1a09d0 | 1525 | |
fb9cefb4 GS |
1526 | =item Error Indicators |
1527 | ||
14218588 GS |
1528 | =item Technical Note on the Syntax of Variable Names |
1529 | ||
cb1a09d0 AD |
1530 | =back |
1531 | ||
14218588 GS |
1532 | =item BUGS |
1533 | ||
cb1a09d0 AD |
1534 | =head2 perlsub - Perl subroutines |
1535 | ||
1536 | =item SYNOPSIS | |
1537 | ||
cb1a09d0 AD |
1538 | =item DESCRIPTION |
1539 | ||
cb1a09d0 AD |
1540 | =over |
1541 | ||
14218588 | 1542 | =item Private Variables via my() |
cb1a09d0 | 1543 | |
c2611fb3 | 1544 | =item Persistent Private Variables |
193fb0af | 1545 | |
cb1a09d0 AD |
1546 | =item Temporary Values via local() |
1547 | ||
cb1a09d0 AD |
1548 | =item Passing Symbol Table Entries (typeglobs) |
1549 | ||
193fb0af GS |
1550 | =item When to Still Use local() |
1551 | ||
14218588 GS |
1552 | 1. You need to give a global variable a temporary value, especially $_, 2. |
1553 | You need to create a local file or directory handle or a local function, 3. | |
1554 | You want to temporarily change just one element of an array or hash | |
193fb0af | 1555 | |
cb1a09d0 AD |
1556 | =item Pass by Reference |
1557 | ||
cb1a09d0 AD |
1558 | =item Prototypes |
1559 | ||
44a8e56a | 1560 | =item Constant Functions |
1561 | ||
14218588 | 1562 | =item Overriding Built-in Functions |
cb1a09d0 | 1563 | |
cb1a09d0 AD |
1564 | =item Autoloading |
1565 | ||
cb1a09d0 AD |
1566 | =back |
1567 | ||
1568 | =item SEE ALSO | |
1569 | ||
c635e13b | 1570 | =head2 perlmod - Perl modules (packages and symbol tables) |
cb1a09d0 AD |
1571 | |
1572 | =item DESCRIPTION | |
1573 | ||
cb1a09d0 AD |
1574 | =over |
1575 | ||
1576 | =item Packages | |
1577 | ||
cb1a09d0 AD |
1578 | =item Symbol Tables |
1579 | ||
cb1a09d0 AD |
1580 | =item Package Constructors and Destructors |
1581 | ||
cb1a09d0 AD |
1582 | =item Perl Classes |
1583 | ||
cb1a09d0 AD |
1584 | =item Perl Modules |
1585 | ||
cb1a09d0 AD |
1586 | =back |
1587 | ||
c635e13b | 1588 | =item SEE ALSO |
1589 | ||
1590 | =head2 perlmodlib - constructing new Perl modules and finding existing ones | |
1591 | ||
1592 | =item DESCRIPTION | |
cb1a09d0 | 1593 | |
cb1a09d0 AD |
1594 | =item THE PERL MODULE LIBRARY |
1595 | ||
cb1a09d0 AD |
1596 | =over |
1597 | ||
1598 | =item Pragmatic Modules | |
1599 | ||
14218588 GS |
1600 | attrs, autouse, base, blib, constant, diagnostics, fields, filetest, |
1601 | integer, less, lib, locale, ops, overload, re, sigtrap, strict, subs, utf8, | |
1602 | vars, vmsish, warning | |
cb1a09d0 AD |
1603 | |
1604 | =item Standard Modules | |
1605 | ||
14218588 GS |
1606 | AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, |
1607 | B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint, | |
1608 | B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, CGI, CGI::Apache, | |
1609 | CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Push, CGI::Switch, CPAN, | |
1610 | CPAN::FirstTime, CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB, DB_File, | |
1611 | Data::Dumper, Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue, | |
1612 | DynaLoader, English, Env, Errno, Exporter, ExtUtils::Command, | |
1613 | ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, | |
1614 | ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, | |
1615 | ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Miniperl, | |
1616 | ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, | |
1617 | ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::Compare, File::Copy, | |
1618 | File::DosGlob, File::Find, File::Path, File::Spec, File::Spec::Functions, | |
1619 | File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, | |
1620 | File::Spec::Win32, File::stat, FileCache, FileHandle, FindBin, GDBM_File, | |
1621 | Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File, | |
1622 | IO::Handle, IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, | |
1623 | IO::Socket::INET, IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3, | |
1624 | IPC::Semaphore, IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex, | |
1625 | Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent, | |
1626 | Net::servent, O, Opcode, POSIX, Pod::Html, Pod::Text, SDBM_File, Safe, | |
1627 | Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Symbol, | |
1628 | Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete, Term::ReadLine, | |
1629 | Test, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex, | |
1630 | Text::Tabs -- expand and unexpand tabs per the unix expand(1) and | |
1631 | unexpand(1), Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, | |
1632 | Thread::Signal, Thread::Specific, Tie::Array, Tie::Handle, Tie::Hash, | |
1633 | Tie::StdHash, Tie::RefHash, Tie::Scalar, Tie::StdScalar, Tie::SubstrHash, | |
1634 | Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, | |
1635 | User::grent, User::pwent | |
cb1a09d0 AD |
1636 | |
1637 | =item Extension Modules | |
1638 | ||
cb1a09d0 AD |
1639 | =back |
1640 | ||
1641 | =item CPAN | |
1642 | ||
8ebc5c01 | 1643 | Language Extensions and Documentation Tools, Development Support, Operating |
1644 | System Interfaces, Networking, Device Control (modems) and InterProcess | |
1645 | Communication, Data Types and Data Type Utilities, Database Interfaces, | |
1646 | User Interfaces, Interfaces to / Emulations of Other Programming Languages, | |
1647 | File Names, File Systems and File Locking (see also File Handles), String | |
1648 | Processing, Language Text Processing, Parsing, and Searching, Option, | |
1649 | Argument, Parameter, and Configuration File Processing, | |
1650 | Internationalization and Locale, Authentication, Security, and Encryption, | |
1651 | World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities, | |
1652 | Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing, | |
1653 | and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and | |
1654 | exceptions etc), File Handle and Input/Output Stream Utilities, | |
9607fc9c | 1655 | Miscellaneous Modules, Africa, Asia, Australasia, Europe, North America, |
1656 | South America | |
8ebc5c01 | 1657 | |
1658 | =item Modules: Creation, Use, and Abuse | |
cb1a09d0 AD |
1659 | |
1660 | =over | |
1661 | ||
1662 | =item Guidelines for Module Creation | |
1663 | ||
cb1a09d0 | 1664 | Do similar modules already exist in some form?, Try to design the new |
8ebc5c01 | 1665 | module to be easy to extend and reuse, Some simple style guidelines, Select |
1666 | what to export, Select a name for the module, Have you got it right?, | |
1667 | README and other Additional Files, A description of the | |
1668 | module/package/extension etc, A copyright notice - see below, Prerequisites | |
1669 | - what else you may need to have, How to build it - possible changes to | |
1670 | Makefile.PL etc, How to install it, Recent changes in this release, | |
1671 | especially incompatibilities, Changes / enhancements you plan to make in | |
1672 | the future, Adding a Copyright Notice, Give the module a | |
1673 | version/issue/release number, How to release and distribute a module, Take | |
1674 | care when changing a released module | |
cb1a09d0 AD |
1675 | |
1676 | =item Guidelines for Converting Perl 4 Library Scripts into Modules | |
1677 | ||
cb1a09d0 | 1678 | There is no requirement to convert anything, Consider the implications, |
8ebc5c01 | 1679 | Make the most of the opportunity, The pl2pm utility will get you started, |
1680 | Adds the standard Module prologue lines, Converts package specifiers from ' | |
1681 | to ::, Converts die(...) to croak(...), Several other minor changes | |
cb1a09d0 AD |
1682 | |
1683 | =item Guidelines for Reusing Application Code | |
1684 | ||
cb1a09d0 | 1685 | Complete applications rarely belong in the Perl Module Library, Many |
193fb0af | 1686 | applications contain some Perl code that could be reused, Break-out the |
8ebc5c01 | 1687 | reusable code into one or more separate module files, Take the opportunity |
1688 | to reconsider and redesign the interfaces, In some cases the 'application' | |
1689 | can then be reduced to a small | |
cb1a09d0 AD |
1690 | |
1691 | =back | |
1692 | ||
c635e13b | 1693 | =item NOTE |
1694 | ||
fb9cefb4 GS |
1695 | =head2 perlmodinstall - Installing CPAN Modules |
1696 | ||
1697 | =item DESCRIPTION | |
1698 | ||
1699 | =over | |
1700 | ||
1701 | =item PREAMBLE | |
1702 | ||
637e9122 GS |
1703 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
1704 | module (sometimes unnecessary), B<INSTALL> the module | |
fb9cefb4 GS |
1705 | |
1706 | =back | |
1707 | ||
1708 | =item HEY | |
1709 | ||
1710 | =item AUTHOR | |
1711 | ||
1712 | =item COPYRIGHT | |
1713 | ||
8ebc5c01 | 1714 | =head2 perlform - Perl formats |
cb1a09d0 AD |
1715 | |
1716 | =item DESCRIPTION | |
1717 | ||
cb1a09d0 AD |
1718 | =over |
1719 | ||
8ebc5c01 | 1720 | =item Format Variables |
cb1a09d0 | 1721 | |
8ebc5c01 | 1722 | =back |
cb1a09d0 | 1723 | |
8ebc5c01 | 1724 | =item NOTES |
cb1a09d0 | 1725 | |
8ebc5c01 | 1726 | =over |
cb1a09d0 | 1727 | |
8ebc5c01 | 1728 | =item Footers |
cb1a09d0 | 1729 | |
8ebc5c01 | 1730 | =item Accessing Formatting Internals |
cb1a09d0 AD |
1731 | |
1732 | =back | |
1733 | ||
8ebc5c01 | 1734 | =item WARNINGS |
cb1a09d0 | 1735 | |
8ebc5c01 | 1736 | =head2 perllocale - Perl locale handling (internationalization and |
1737 | localization) | |
cb1a09d0 | 1738 | |
8ebc5c01 | 1739 | =item DESCRIPTION |
cb1a09d0 | 1740 | |
8ebc5c01 | 1741 | =item PREPARING TO USE LOCALES |
cb1a09d0 | 1742 | |
8ebc5c01 | 1743 | =item USING LOCALES |
cb1a09d0 | 1744 | |
8ebc5c01 | 1745 | =over |
cb1a09d0 | 1746 | |
8ebc5c01 | 1747 | =item The use locale pragma |
cb1a09d0 | 1748 | |
8ebc5c01 | 1749 | =item The setlocale function |
cb1a09d0 | 1750 | |
193fb0af GS |
1751 | =item Finding locales |
1752 | ||
1753 | =item LOCALE PROBLEMS | |
1754 | ||
1755 | =item Temporarily fixing locale problems | |
1756 | ||
1757 | =item Permanently fixing locale problems | |
1758 | ||
1759 | =item Permanently fixing your locale configuration | |
1760 | ||
14218588 | 1761 | =item Fixing system locale configuration |
193fb0af | 1762 | |
8ebc5c01 | 1763 | =item The localeconv function |
cb1a09d0 | 1764 | |
8ebc5c01 | 1765 | =back |
cb1a09d0 | 1766 | |
8ebc5c01 | 1767 | =item LOCALE CATEGORIES |
cb1a09d0 | 1768 | |
8ebc5c01 | 1769 | =over |
cb1a09d0 | 1770 | |
8ebc5c01 | 1771 | =item Category LC_COLLATE: Collation |
cb1a09d0 | 1772 | |
8ebc5c01 | 1773 | =item Category LC_CTYPE: Character Types |
cb1a09d0 | 1774 | |
8ebc5c01 | 1775 | =item Category LC_NUMERIC: Numeric Formatting |
cb1a09d0 | 1776 | |
8ebc5c01 | 1777 | =item Category LC_MONETARY: Formatting of monetary amounts |
cb1a09d0 | 1778 | |
8ebc5c01 | 1779 | =item LC_TIME |
cb1a09d0 | 1780 | |
8ebc5c01 | 1781 | =item Other categories |
cb1a09d0 | 1782 | |
8ebc5c01 | 1783 | =back |
cb1a09d0 | 1784 | |
8ebc5c01 | 1785 | =item SECURITY |
cb1a09d0 | 1786 | |
8ebc5c01 | 1787 | B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):, |
193fb0af | 1788 | B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>), |
8ebc5c01 | 1789 | B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):, |
1790 | B<In-memory formatting function> (sprintf()):, B<Output formatting | |
1791 | functions> (printf() and write()):, B<Case-mapping functions> (lc(), | |
1792 | lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent functions> | |
1793 | (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX character class | |
1794 | tests> (isalnum(), isalpha(), isdigit(),isgraph(), islower(), isprint(), | |
1795 | ispunct(), isspace(), isupper(), | |
1796 | isxdigit()): | |
cb1a09d0 | 1797 | |
8ebc5c01 | 1798 | =item ENVIRONMENT |
cb1a09d0 | 1799 | |
14218588 GS |
1800 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
1801 | LC_NUMERIC, LC_TIME, LANG | |
cb1a09d0 | 1802 | |
8ebc5c01 | 1803 | =item NOTES |
cb1a09d0 AD |
1804 | |
1805 | =over | |
1806 | ||
8ebc5c01 | 1807 | =item Backward compatibility |
cb1a09d0 | 1808 | |
8ebc5c01 | 1809 | =item I18N:Collate obsolete |
cb1a09d0 | 1810 | |
8ebc5c01 | 1811 | =item Sort speed and memory use impacts |
cb1a09d0 | 1812 | |
8ebc5c01 | 1813 | =item write() and LC_NUMERIC |
cb1a09d0 | 1814 | |
8ebc5c01 | 1815 | =item Freely available locale definitions |
cb1a09d0 | 1816 | |
8ebc5c01 | 1817 | =item I18n and l10n |
cb1a09d0 | 1818 | |
8ebc5c01 | 1819 | =item An imperfect standard |
cb1a09d0 AD |
1820 | |
1821 | =back | |
1822 | ||
8ebc5c01 | 1823 | =item BUGS |
cb1a09d0 AD |
1824 | |
1825 | =over | |
1826 | ||
8ebc5c01 | 1827 | =item Broken systems |
cb1a09d0 | 1828 | |
8ebc5c01 | 1829 | =back |
cb1a09d0 | 1830 | |
8ebc5c01 | 1831 | =item SEE ALSO |
cb1a09d0 | 1832 | |
8ebc5c01 | 1833 | =item HISTORY |
cb1a09d0 | 1834 | |
8ebc5c01 | 1835 | =head2 perlref - Perl references and nested data structures |
cb1a09d0 | 1836 | |
14218588 GS |
1837 | =item NOTE |
1838 | ||
8ebc5c01 | 1839 | =item DESCRIPTION |
cb1a09d0 | 1840 | |
8ebc5c01 | 1841 | =over |
cb1a09d0 | 1842 | |
193fb0af GS |
1843 | =item Making References |
1844 | ||
1845 | =item Using References | |
1846 | ||
8ebc5c01 | 1847 | =item Symbolic references |
cb1a09d0 | 1848 | |
8ebc5c01 | 1849 | =item Not-so-symbolic references |
cb1a09d0 | 1850 | |
fb9cefb4 GS |
1851 | =item Pseudo-hashes: Using an array as a hash |
1852 | ||
193fb0af GS |
1853 | =item Function Templates |
1854 | ||
8ebc5c01 | 1855 | =back |
cb1a09d0 | 1856 | |
8ebc5c01 | 1857 | =item WARNING |
cb1a09d0 | 1858 | |
8ebc5c01 | 1859 | =item SEE ALSO |
cb1a09d0 | 1860 | |
14218588 GS |
1861 | =head2 perlreftut - Mark's very short tutorial about references |
1862 | ||
1863 | =item DESCRIPTION | |
1864 | ||
1865 | =item Who Needs Complicated Data Structures? | |
1866 | ||
1867 | =item The Solution | |
1868 | ||
1869 | =item Syntax | |
1870 | ||
1871 | =over | |
1872 | ||
1873 | =item Making References | |
1874 | ||
1875 | =item Using References | |
1876 | ||
1877 | =back | |
1878 | ||
1879 | =item An Example | |
1880 | ||
1881 | =item Arrow Rule | |
1882 | ||
1883 | =item Solution | |
1884 | ||
1885 | =item The Rest | |
1886 | ||
1887 | =item Summary | |
1888 | ||
1889 | =item Credits | |
1890 | ||
1891 | =over | |
1892 | ||
1893 | =item Distribution Conditions | |
1894 | ||
1895 | =back | |
1896 | ||
8ebc5c01 | 1897 | =head2 perldsc - Perl Data Structures Cookbook |
cb1a09d0 | 1898 | |
8ebc5c01 | 1899 | =item DESCRIPTION |
cb1a09d0 | 1900 | |
8ebc5c01 | 1901 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
28757baa | 1902 | more elaborate constructs |
cb1a09d0 | 1903 | |
8ebc5c01 | 1904 | =item REFERENCES |
cb1a09d0 | 1905 | |
8ebc5c01 | 1906 | =item COMMON MISTAKES |
cb1a09d0 | 1907 | |
8ebc5c01 | 1908 | =item CAVEAT ON PRECEDENCE |
cb1a09d0 | 1909 | |
8ebc5c01 | 1910 | =item WHY YOU SHOULD ALWAYS C<use strict> |
cb1a09d0 | 1911 | |
8ebc5c01 | 1912 | =item DEBUGGING |
cb1a09d0 | 1913 | |
8ebc5c01 | 1914 | =item CODE EXAMPLES |
cb1a09d0 | 1915 | |
14218588 | 1916 | =item ARRAYS OF ARRAYS |
cb1a09d0 AD |
1917 | |
1918 | =over | |
1919 | ||
14218588 | 1920 | =item Declaration of a ARRAY OF ARRAYS |
cb1a09d0 | 1921 | |
14218588 | 1922 | =item Generation of a ARRAY OF ARRAYS |
cb1a09d0 | 1923 | |
14218588 | 1924 | =item Access and Printing of a ARRAY OF ARRAYS |
cb1a09d0 | 1925 | |
8ebc5c01 | 1926 | =back |
cb1a09d0 | 1927 | |
14218588 | 1928 | =item HASHES OF ARRAYS |
8ebc5c01 | 1929 | |
1930 | =over | |
cb1a09d0 | 1931 | |
14218588 | 1932 | =item Declaration of a HASH OF ARRAYS |
cb1a09d0 | 1933 | |
14218588 | 1934 | =item Generation of a HASH OF ARRAYS |
cb1a09d0 | 1935 | |
14218588 | 1936 | =item Access and Printing of a HASH OF ARRAYS |
cb1a09d0 AD |
1937 | |
1938 | =back | |
1939 | ||
14218588 | 1940 | =item ARRAYS OF HASHES |
cb1a09d0 AD |
1941 | |
1942 | =over | |
1943 | ||
14218588 | 1944 | =item Declaration of a ARRAY OF HASHES |
cb1a09d0 | 1945 | |
14218588 | 1946 | =item Generation of a ARRAY OF HASHES |
cb1a09d0 | 1947 | |
14218588 | 1948 | =item Access and Printing of a ARRAY OF HASHES |
cb1a09d0 | 1949 | |
8ebc5c01 | 1950 | =back |
cb1a09d0 | 1951 | |
8ebc5c01 | 1952 | =item HASHES OF HASHES |
1953 | ||
1954 | =over | |
cb1a09d0 | 1955 | |
8ebc5c01 | 1956 | =item Declaration of a HASH OF HASHES |
cb1a09d0 | 1957 | |
8ebc5c01 | 1958 | =item Generation of a HASH OF HASHES |
cb1a09d0 | 1959 | |
8ebc5c01 | 1960 | =item Access and Printing of a HASH OF HASHES |
cb1a09d0 AD |
1961 | |
1962 | =back | |
1963 | ||
8ebc5c01 | 1964 | =item MORE ELABORATE RECORDS |
7d2bfb28 | 1965 | |
8ebc5c01 | 1966 | =over |
7d2bfb28 | 1967 | |
8ebc5c01 | 1968 | =item Declaration of MORE ELABORATE RECORDS |
cb1a09d0 | 1969 | |
8ebc5c01 | 1970 | =item Declaration of a HASH OF COMPLEX RECORDS |
cb1a09d0 | 1971 | |
8ebc5c01 | 1972 | =item Generation of a HASH OF COMPLEX RECORDS |
cb1a09d0 | 1973 | |
8ebc5c01 | 1974 | =back |
cb1a09d0 | 1975 | |
8ebc5c01 | 1976 | =item Database Ties |
cb1a09d0 | 1977 | |
8ebc5c01 | 1978 | =item SEE ALSO |
cb1a09d0 | 1979 | |
8ebc5c01 | 1980 | =item AUTHOR |
cb1a09d0 | 1981 | |
14218588 | 1982 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
cb1a09d0 AD |
1983 | |
1984 | =item DESCRIPTION | |
1985 | ||
14218588 | 1986 | =item Declaration and Access of Arrays of Arrays |
cb1a09d0 | 1987 | |
cb1a09d0 AD |
1988 | =item Growing Your Own |
1989 | ||
cb1a09d0 AD |
1990 | =item Access and Printing |
1991 | ||
cb1a09d0 AD |
1992 | =item Slices |
1993 | ||
cb1a09d0 AD |
1994 | =item SEE ALSO |
1995 | ||
cb1a09d0 AD |
1996 | =item AUTHOR |
1997 | ||
8ebc5c01 | 1998 | =head2 perltoot - Tom's object-oriented tutorial for perl |
cb1a09d0 | 1999 | |
8ebc5c01 | 2000 | =item DESCRIPTION |
cb1a09d0 | 2001 | |
8ebc5c01 | 2002 | =item Creating a Class |
cb1a09d0 | 2003 | |
8ebc5c01 | 2004 | =over |
cb1a09d0 | 2005 | |
8ebc5c01 | 2006 | =item Object Representation |
cb1a09d0 | 2007 | |
8ebc5c01 | 2008 | =item Class Interface |
2009 | ||
2010 | =item Constructors and Instance Methods | |
2011 | ||
2012 | =item Planning for the Future: Better Constructors | |
2013 | ||
2014 | =item Destructors | |
cb1a09d0 | 2015 | |
8ebc5c01 | 2016 | =item Other Object Methods |
2017 | ||
2018 | =back | |
2019 | ||
2020 | =item Class Data | |
cb1a09d0 AD |
2021 | |
2022 | =over | |
2023 | ||
8ebc5c01 | 2024 | =item Accessing Class Data |
cb1a09d0 | 2025 | |
8ebc5c01 | 2026 | =item Debugging Methods |
cb1a09d0 | 2027 | |
8ebc5c01 | 2028 | =item Class Destructors |
cb1a09d0 | 2029 | |
8ebc5c01 | 2030 | =item Documenting the Interface |
cb1a09d0 | 2031 | |
8ebc5c01 | 2032 | =back |
cb1a09d0 | 2033 | |
8ebc5c01 | 2034 | =item Aggregation |
cb1a09d0 | 2035 | |
8ebc5c01 | 2036 | =item Inheritance |
cb1a09d0 | 2037 | |
8ebc5c01 | 2038 | =over |
cb1a09d0 | 2039 | |
8ebc5c01 | 2040 | =item Overridden Methods |
55497cff | 2041 | |
8ebc5c01 | 2042 | =item Multiple Inheritance |
55497cff | 2043 | |
8ebc5c01 | 2044 | =item UNIVERSAL: The Root of All Objects |
55497cff | 2045 | |
8ebc5c01 | 2046 | =back |
cb1a09d0 | 2047 | |
8ebc5c01 | 2048 | =item Alternate Object Representations |
cb1a09d0 | 2049 | |
8ebc5c01 | 2050 | =over |
cb1a09d0 | 2051 | |
8ebc5c01 | 2052 | =item Arrays as Objects |
cb1a09d0 | 2053 | |
8ebc5c01 | 2054 | =item Closures as Objects |
2055 | ||
2056 | =back | |
cb1a09d0 | 2057 | |
8ebc5c01 | 2058 | =item AUTOLOAD: Proxy Methods |
cb1a09d0 | 2059 | |
8ebc5c01 | 2060 | =over |
2061 | ||
2062 | =item Autoloaded Data Methods | |
2063 | ||
2064 | =item Inherited Autoloaded Data Methods | |
2065 | ||
2066 | =back | |
2067 | ||
2068 | =item Metaclassical Tools | |
cb1a09d0 | 2069 | |
8ebc5c01 | 2070 | =over |
2071 | ||
8cc95fdb | 2072 | =item Class::Struct |
cb1a09d0 | 2073 | |
8ebc5c01 | 2074 | =item Data Members as Variables |
2075 | ||
2076 | =item NOTES | |
cb1a09d0 | 2077 | |
8ebc5c01 | 2078 | =item Object Terminology |
cb1a09d0 AD |
2079 | |
2080 | =back | |
2081 | ||
2082 | =item SEE ALSO | |
2083 | ||
193fb0af GS |
2084 | =item AUTHOR AND COPYRIGHT |
2085 | ||
8ebc5c01 | 2086 | =item COPYRIGHT |
2087 | ||
2088 | =over | |
2089 | ||
2090 | =item Acknowledgments | |
2091 | ||
2092 | =back | |
2093 | ||
14218588 GS |
2094 | =head2 perltootc - Tom's OO Tutorial for Class Data in Perl |
2095 | ||
2096 | =item DESCRIPTION | |
2097 | ||
2098 | =item Class Data as Package Variables | |
2099 | ||
2100 | =over | |
2101 | ||
2102 | =item Putting All Your Eggs in One Basket | |
2103 | ||
2104 | =item Inheritance Concerns | |
2105 | ||
2106 | =item The Eponymous Meta-Object | |
2107 | ||
2108 | =item Indirect References to Class Data | |
2109 | ||
2110 | =item Monadic Classes | |
2111 | ||
2112 | =item Translucent Attributes | |
2113 | ||
2114 | =back | |
2115 | ||
2116 | =item Class Data as Lexical Variables | |
2117 | ||
2118 | =over | |
2119 | ||
2120 | =item Privacy and Responsibility | |
2121 | ||
2122 | =item File-Scoped Lexicals | |
2123 | ||
2124 | =item More Inheritance Concerns | |
2125 | ||
2126 | =item Locking the Door and Throwing Away the Key | |
2127 | ||
2128 | =item Translucency Revisited | |
2129 | ||
2130 | =back | |
2131 | ||
2132 | =item NOTES | |
2133 | ||
2134 | =item SEE ALSO | |
2135 | ||
2136 | =item AUTHOR AND COPYRIGHT | |
2137 | ||
2138 | =item ACKNOWLEDGEMENTS | |
2139 | ||
2140 | =item HISTORY | |
2141 | ||
8ebc5c01 | 2142 | =head2 perlobj - Perl objects |
2143 | ||
2144 | =item DESCRIPTION | |
2145 | ||
2146 | =over | |
2147 | ||
2148 | =item An Object is Simply a Reference | |
2149 | ||
2150 | =item A Class is Simply a Package | |
2151 | ||
2152 | =item A Method is Simply a Subroutine | |
2153 | ||
2154 | =item Method Invocation | |
2155 | ||
14218588 GS |
2156 | =item WARNING |
2157 | ||
8ebc5c01 | 2158 | =item Default UNIVERSAL methods |
2159 | ||
ff0cee69 | 2160 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
8ebc5c01 | 2161 | |
54310121 | 2162 | =item Destructors |
8ebc5c01 | 2163 | |
8ebc5c01 | 2164 | =item Summary |
cb1a09d0 | 2165 | |
8ebc5c01 | 2166 | =item Two-Phased Garbage Collection |
cb1a09d0 | 2167 | |
8ebc5c01 | 2168 | =back |
cb1a09d0 | 2169 | |
8ebc5c01 | 2170 | =item SEE ALSO |
cb1a09d0 AD |
2171 | |
2172 | =head2 perltie - how to hide an object class in a simple variable | |
2173 | ||
2174 | =item SYNOPSIS | |
2175 | ||
cb1a09d0 AD |
2176 | =item DESCRIPTION |
2177 | ||
cb1a09d0 AD |
2178 | =over |
2179 | ||
2180 | =item Tying Scalars | |
2181 | ||
cb1a09d0 AD |
2182 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
2183 | ||
2184 | =item Tying Arrays | |
2185 | ||
cb1a09d0 AD |
2186 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, |
2187 | DESTROY this | |
2188 | ||
2189 | =item Tying Hashes | |
2190 | ||
8ebc5c01 | 2191 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE |
2192 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
2193 | this, NEXTKEY this, lastkey, DESTROY this | |
cb1a09d0 AD |
2194 | |
2195 | =item Tying FileHandles | |
2196 | ||
193fb0af GS |
2197 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, |
2198 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this | |
cb1a09d0 | 2199 | |
4fdae800 | 2200 | =item The C<untie> Gotcha |
2201 | ||
cb1a09d0 AD |
2202 | =back |
2203 | ||
2204 | =item SEE ALSO | |
2205 | ||
cb1a09d0 AD |
2206 | =item BUGS |
2207 | ||
cb1a09d0 AD |
2208 | =item AUTHOR |
2209 | ||
cb1a09d0 AD |
2210 | =head2 perlbot - Bag'o Object Tricks (the BOT) |
2211 | ||
2212 | =item DESCRIPTION | |
2213 | ||
cb1a09d0 AD |
2214 | =item OO SCALING TIPS |
2215 | ||
cb1a09d0 AD |
2216 | =item INSTANCE VARIABLES |
2217 | ||
cb1a09d0 AD |
2218 | =item SCALAR INSTANCE VARIABLES |
2219 | ||
cb1a09d0 AD |
2220 | =item INSTANCE VARIABLE INHERITANCE |
2221 | ||
cb1a09d0 AD |
2222 | =item OBJECT RELATIONSHIPS |
2223 | ||
cb1a09d0 AD |
2224 | =item OVERRIDING SUPERCLASS METHODS |
2225 | ||
cb1a09d0 AD |
2226 | =item USING RELATIONSHIP WITH SDBM |
2227 | ||
cb1a09d0 AD |
2228 | =item THINKING OF CODE REUSE |
2229 | ||
cb1a09d0 AD |
2230 | =item CLASS CONTEXT AND THE OBJECT |
2231 | ||
cb1a09d0 AD |
2232 | =item INHERITING A CONSTRUCTOR |
2233 | ||
cb1a09d0 AD |
2234 | =item DELEGATION |
2235 | ||
8ebc5c01 | 2236 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
2237 | safe subprocesses, sockets, and semaphores) | |
cb1a09d0 | 2238 | |
8ebc5c01 | 2239 | =item DESCRIPTION |
cb1a09d0 | 2240 | |
8ebc5c01 | 2241 | =item Signals |
cb1a09d0 | 2242 | |
8ebc5c01 | 2243 | =item Named Pipes |
cb1a09d0 | 2244 | |
193fb0af GS |
2245 | =over |
2246 | ||
2247 | =item WARNING | |
2248 | ||
2249 | =back | |
2250 | ||
8ebc5c01 | 2251 | =item Using open() for IPC |
cb1a09d0 | 2252 | |
8ebc5c01 | 2253 | =over |
cb1a09d0 | 2254 | |
68dc0745 | 2255 | =item Filehandles |
2256 | ||
2257 | =item Background Processes | |
2258 | ||
2259 | =item Complete Dissociation of Child from Parent | |
2260 | ||
8ebc5c01 | 2261 | =item Safe Pipe Opens |
cb1a09d0 | 2262 | |
c90c0ff4 | 2263 | =item Bidirectional Communication with Another Process |
55497cff | 2264 | |
193fb0af GS |
2265 | =item Bidirectional Communication with Yourself |
2266 | ||
8ebc5c01 | 2267 | =back |
2268 | ||
2269 | =item Sockets: Client/Server Communication | |
55497cff | 2270 | |
cb1a09d0 AD |
2271 | =over |
2272 | ||
193fb0af GS |
2273 | =item Internet Line Terminators |
2274 | ||
8ebc5c01 | 2275 | =item Internet TCP Clients and Servers |
55497cff | 2276 | |
8ebc5c01 | 2277 | =item Unix-Domain TCP Clients and Servers |
55497cff | 2278 | |
c90c0ff4 | 2279 | =back |
2280 | ||
2281 | =item TCP Clients with IO::Socket | |
2282 | ||
2283 | =over | |
2284 | ||
2285 | =item A Simple Client | |
2286 | ||
2287 | C<Proto>, C<PeerAddr>, C<PeerPort> | |
2288 | ||
2289 | =item A Webget Client | |
2290 | ||
2291 | =item Interactive Client with IO::Socket | |
cb1a09d0 | 2292 | |
8ebc5c01 | 2293 | =back |
cb1a09d0 | 2294 | |
c90c0ff4 | 2295 | =item TCP Servers with IO::Socket |
cb1a09d0 | 2296 | |
c90c0ff4 | 2297 | Proto, LocalPort, Listen, Reuse |
2298 | ||
2299 | =item UDP: Message Passing | |
2300 | ||
2301 | =item SysV IPC | |
cb1a09d0 | 2302 | |
8ebc5c01 | 2303 | =item NOTES |
cb1a09d0 | 2304 | |
8ebc5c01 | 2305 | =item BUGS |
55497cff | 2306 | |
8ebc5c01 | 2307 | =item AUTHOR |
55497cff | 2308 | |
8ebc5c01 | 2309 | =item SEE ALSO |
55497cff | 2310 | |
14218588 GS |
2311 | =head2 perldbmfilter - Perl DBM Filters |
2312 | ||
2313 | =item SYNOPSIS | |
2314 | ||
2315 | =item DESCRIPTION | |
2316 | ||
2317 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
2318 | B<filter_fetch_value> | |
2319 | ||
2320 | =over | |
2321 | ||
2322 | =item The Filter | |
2323 | ||
2324 | =item An Example -- the NULL termination problem. | |
2325 | ||
2326 | =item Another Example -- Key is a C int. | |
2327 | ||
2328 | =back | |
2329 | ||
2330 | =item SEE ALSO | |
2331 | ||
2332 | =item AUTHOR | |
2333 | ||
8ebc5c01 | 2334 | =head2 perldebug - Perl debugging |
55497cff | 2335 | |
8ebc5c01 | 2336 | =item DESCRIPTION |
55497cff | 2337 | |
8ebc5c01 | 2338 | =item The Perl Debugger |
55497cff | 2339 | |
8ebc5c01 | 2340 | =over |
55497cff | 2341 | |
8ebc5c01 | 2342 | =item Debugger Commands |
a6006777 | 2343 | |
774d564b | 2344 | h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n |
2345 | [expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l | |
2346 | subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern], | |
2347 | t, t expr, b [line] [condition], b subname [condition], b postpone subname | |
2348 | [condition], b load filename, b compile subname, d [line], D, a [line] | |
193fb0af GS |
2349 | command, A, W [expr], W, O [opt[=val]] [opt"val"] [opt?].., |
2350 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, | |
2351 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
2352 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>, | |
2353 | C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>, | |
2354 | C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>, | |
2355 | C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ], | |
2356 | E<lt>E<lt> command, E<gt> command, E<gt>E<gt> command, { [ command ], {{ | |
2357 | command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R, | |
2358 | |dbcmd, ||dbcmd, command, m expr, m package | |
774d564b | 2359 | |
2360 | =item Debugger input/output | |
2361 | ||
54310121 | 2362 | Prompt, Multiline commands, Stack backtrace, Listing, Frame listing |
774d564b | 2363 | |
2364 | =item Debugging compile-time statements | |
cb1a09d0 | 2365 | |
8ebc5c01 | 2366 | =item Debugger Customization |
cb1a09d0 | 2367 | |
8ebc5c01 | 2368 | =item Readline Support |
cb1a09d0 | 2369 | |
8ebc5c01 | 2370 | =item Editor Support for Debugging |
cb1a09d0 | 2371 | |
8ebc5c01 | 2372 | =item The Perl Profiler |
cb1a09d0 | 2373 | |
8ebc5c01 | 2374 | =item Debugger support in perl |
cb1a09d0 | 2375 | |
8ebc5c01 | 2376 | =item Debugger Internals |
cb1a09d0 | 2377 | |
8ebc5c01 | 2378 | =item Other resources |
cb1a09d0 | 2379 | |
193fb0af GS |
2380 | =item BUGS |
2381 | ||
8ebc5c01 | 2382 | =back |
cb1a09d0 | 2383 | |
193fb0af GS |
2384 | =item Debugging Perl memory usage |
2385 | ||
2386 | =over | |
2387 | ||
2388 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> | |
2389 | ||
2390 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): | |
2391 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
2392 | 6144> | |
2393 | ||
2394 | =item Example of using B<-DL> switch | |
2395 | ||
2396 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> | |
2397 | ||
2398 | =item B<-DL> details | |
2399 | ||
2400 | C<!!!>, C<!!>, C<!> | |
2401 | ||
2402 | =item Limitations of B<-DL> statistic | |
2403 | ||
2404 | =back | |
cb1a09d0 | 2405 | |
fb9cefb4 GS |
2406 | =item Debugging regular expressions |
2407 | ||
2408 | =over | |
2409 | ||
2410 | =item Compile-time output | |
2411 | ||
2412 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> | |
2413 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
2414 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
2415 | C<anchored(TYPE)> | |
2416 | ||
2417 | =item Types of nodes | |
2418 | ||
2419 | =item Run-time output | |
2420 | ||
2421 | =back | |
2422 | ||
cb1a09d0 AD |
2423 | =head2 perldiag - various Perl diagnostics |
2424 | ||
2425 | =item DESCRIPTION | |
2426 | ||
8ebc5c01 | 2427 | =head2 perlsec - Perl security |
cb1a09d0 AD |
2428 | |
2429 | =item DESCRIPTION | |
2430 | ||
cb1a09d0 AD |
2431 | =over |
2432 | ||
55497cff | 2433 | =item Laundering and Detecting Tainted Data |
2434 | ||
b971f6e4 | 2435 | =item Switches On the "#!" Line |
2436 | ||
55497cff | 2437 | =item Cleaning Up Your Path |
cb1a09d0 | 2438 | |
55497cff | 2439 | =item Security Bugs |
a6006777 | 2440 | |
68dc0745 | 2441 | =item Protecting Your Programs |
2442 | ||
cb1a09d0 AD |
2443 | =back |
2444 | ||
193fb0af GS |
2445 | =item SEE ALSO |
2446 | ||
8ebc5c01 | 2447 | =head2 perltrap - Perl traps for the unwary |
cb1a09d0 | 2448 | |
8ebc5c01 | 2449 | =item DESCRIPTION |
cb1a09d0 AD |
2450 | |
2451 | =over | |
2452 | ||
8ebc5c01 | 2453 | =item Awk Traps |
cb1a09d0 | 2454 | |
8ebc5c01 | 2455 | =item C Traps |
cb1a09d0 | 2456 | |
8ebc5c01 | 2457 | =item Sed Traps |
cb1a09d0 | 2458 | |
8ebc5c01 | 2459 | =item Shell Traps |
cb1a09d0 | 2460 | |
8ebc5c01 | 2461 | =item Perl Traps |
cb1a09d0 | 2462 | |
8ebc5c01 | 2463 | =item Perl4 to Perl5 Traps |
cb1a09d0 | 2464 | |
8ebc5c01 | 2465 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
2466 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
2467 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
2468 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
cb1a09d0 | 2469 | |
8ebc5c01 | 2470 | =item Discontinuance, Deprecation, and BugFix traps |
cb1a09d0 | 2471 | |
8ebc5c01 | 2472 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, |
2473 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
68dc0745 | 2474 | Discontinuance, Discontinuance, Deprecation, Discontinuance |
cb1a09d0 | 2475 | |
8ebc5c01 | 2476 | =item Parsing Traps |
cb1a09d0 | 2477 | |
fb9cefb4 | 2478 | Parsing, Parsing, Parsing, Parsing |
cb1a09d0 | 2479 | |
8ebc5c01 | 2480 | =item Numerical Traps |
cb1a09d0 | 2481 | |
8ebc5c01 | 2482 | Numerical, Numerical, Numerical |
cb1a09d0 | 2483 | |
8ebc5c01 | 2484 | =item General data type traps |
cb1a09d0 | 2485 | |
193fb0af GS |
2486 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), |
2487 | (Constants), (Scalars), (Variable Suicide) | |
cb1a09d0 | 2488 | |
8ebc5c01 | 2489 | =item Context Traps - scalar, list contexts |
cb1a09d0 | 2490 | |
8ebc5c01 | 2491 | (list context), (scalar context), (scalar context), (list, builtin) |
cb1a09d0 | 2492 | |
8ebc5c01 | 2493 | =item Precedence Traps |
cb1a09d0 | 2494 | |
fb9cefb4 GS |
2495 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, |
2496 | Precedence | |
cb1a09d0 | 2497 | |
8ebc5c01 | 2498 | =item General Regular Expression Traps using s///, etc. |
cb1a09d0 | 2499 | |
8ebc5c01 | 2500 | Regular Expression, Regular Expression, Regular Expression, Regular |
44a8e56a | 2501 | Expression, Regular Expression, Regular Expression, Regular Expression, |
fb9cefb4 | 2502 | Regular Expression |
cb1a09d0 | 2503 | |
8ebc5c01 | 2504 | =item Subroutine, Signal, Sorting Traps |
cb1a09d0 | 2505 | |
2ae324a7 | 2506 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle |
cb1a09d0 | 2507 | |
8ebc5c01 | 2508 | =item OS Traps |
cb1a09d0 | 2509 | |
8ebc5c01 | 2510 | (SysV), (SysV) |
cb1a09d0 | 2511 | |
8ebc5c01 | 2512 | =item Interpolation Traps |
cb1a09d0 | 2513 | |
8ebc5c01 | 2514 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, |
2515 | Interpolation, Interpolation, Interpolation, Interpolation | |
cb1a09d0 | 2516 | |
8ebc5c01 | 2517 | =item DBM Traps |
cb1a09d0 | 2518 | |
8ebc5c01 | 2519 | DBM, DBM |
cb1a09d0 | 2520 | |
8ebc5c01 | 2521 | =item Unclassified Traps |
cb1a09d0 | 2522 | |
d516a115 JH |
2523 | C<require>/C<do> trap using returned value, C<split> on empty string with |
2524 | LIMIT specified | |
cb1a09d0 | 2525 | |
8ebc5c01 | 2526 | =back |
cb1a09d0 | 2527 | |
fb9cefb4 GS |
2528 | =head2 perlport - Writing portable Perl |
2529 | ||
2530 | =item DESCRIPTION | |
2531 | ||
a10cf691 | 2532 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
fb9cefb4 GS |
2533 | portable |
2534 | ||
2535 | =item ISSUES | |
2536 | ||
2537 | =over | |
2538 | ||
2539 | =item Newlines | |
2540 | ||
14218588 GS |
2541 | =item Numbers endianness and Width |
2542 | ||
2543 | =item Files and Filesystems | |
fb9cefb4 GS |
2544 | |
2545 | =item System Interaction | |
2546 | ||
2547 | =item Interprocess Communication (IPC) | |
2548 | ||
2549 | =item External Subroutines (XS) | |
2550 | ||
2551 | =item Standard Modules | |
2552 | ||
2553 | =item Time and Date | |
2554 | ||
14218588 GS |
2555 | =item Character sets and character encoding |
2556 | ||
2557 | =item Internationalisation | |
2558 | ||
fb9cefb4 GS |
2559 | =item System Resources |
2560 | ||
2561 | =item Security | |
2562 | ||
2563 | =item Style | |
2564 | ||
2565 | =back | |
2566 | ||
14218588 | 2567 | =item CPAN Testers |
fb9cefb4 GS |
2568 | |
2569 | Mailing list: cpan-testers@perl.org, Testing results: | |
14218588 | 2570 | C<http://www.perl.org/cpan-testers/> |
fb9cefb4 GS |
2571 | |
2572 | =item PLATFORMS | |
2573 | ||
2574 | =over | |
2575 | ||
2576 | =item Unix | |
2577 | ||
2578 | =item DOS and Derivatives | |
2579 | ||
2580 | The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX | |
2581 | environment for DOS, OS/2, etc. | |
14218588 GS |
2582 | C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index. |
2583 | html> or | |
2584 | C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32, | |
2585 | L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/> | |
fb9cefb4 | 2586 | |
14218588 | 2587 | =item S<Mac OS> |
fb9cefb4 | 2588 | |
14218588 GS |
2589 | The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists, |
2590 | C<http://www.macperl.org/>, MacPerl Module Porters, | |
2591 | C<http://pudge.net/mmp/> | |
fb9cefb4 GS |
2592 | |
2593 | =item VMS | |
2594 | ||
14218588 GS |
2595 | L<perlvms.pod>, vmsperl list, C<majordomo@perl.org>, vmsperl on the web, |
2596 | C<http://www.sidhe.org/vmsperl/index.html> | |
2597 | ||
2598 | =item VOS | |
2599 | ||
2600 | L<README.vos>, VOS mailing list, VOS Perl on the web at | |
2601 | C<http://ftp.stratus.com/pub/vos/vos.html> | |
fb9cefb4 GS |
2602 | |
2603 | =item EBCDIC Platforms | |
2604 | ||
14218588 GS |
2605 | perl-mvs list, AS/400 Perl information at |
2606 | C<http://as400.rochester.ibm.com/> | |
2607 | ||
2608 | =item Acorn RISC OS | |
fb9cefb4 GS |
2609 | |
2610 | =item Other perls | |
2611 | ||
2612 | Atari, Guido Flohr's page C<http://stud.uni-sb.de/~gufl0000/>, HP 300 | |
14218588 | 2613 | MPE/iX C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware |
fb9cefb4 GS |
2614 | |
2615 | =back | |
2616 | ||
2617 | =item FUNCTION IMPLEMENTATIONS | |
2618 | ||
2619 | =over | |
2620 | ||
2621 | =item Alphabetical Listing of Perl Functions | |
2622 | ||
2623 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown | |
2624 | LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen | |
2625 | HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, | |
2626 | flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, | |
2627 | getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, | |
2628 | getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber | |
2629 | NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent, | |
2630 | getnetent, getprotoent, getservent, setpwent, setgrent, sethostent | |
2631 | STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, | |
2632 | endpwent, endgrent, endhostent, endnetent, endprotoent, endservent, | |
2633 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl | |
2634 | FILEHANDLE,FUNCTION,SCALAR, kill LIST, link OLDFILE,NEWFILE, lstat | |
2635 | FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd | |
2636 | ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open | |
2637 | FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select | |
2638 | RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget | |
2639 | KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority | |
2640 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl | |
2641 | ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite | |
2642 | ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat | |
14218588 GS |
2643 | FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen |
2644 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate | |
2645 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
2646 | wait, waitpid PID,FLAGS | |
fb9cefb4 GS |
2647 | |
2648 | =back | |
2649 | ||
14218588 GS |
2650 | =item CHANGES |
2651 | ||
a10cf691 GS |
2652 | v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April |
2653 | 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December | |
2654 | 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August | |
2655 | 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998 | |
14218588 | 2656 | |
fb9cefb4 GS |
2657 | =item AUTHORS / CONTRIBUTORS |
2658 | ||
2659 | =item VERSION | |
2660 | ||
8ebc5c01 | 2661 | =head2 perlstyle - Perl style guide |
cb1a09d0 | 2662 | |
8ebc5c01 | 2663 | =item DESCRIPTION |
cb1a09d0 | 2664 | |
8ebc5c01 | 2665 | =head2 perlpod - plain old documentation |
cb1a09d0 | 2666 | |
8ebc5c01 | 2667 | =item DESCRIPTION |
cb1a09d0 | 2668 | |
d516a115 JH |
2669 | =over |
2670 | ||
2671 | =item Verbatim Paragraph | |
2672 | ||
2673 | =item Command Paragraph | |
2674 | ||
2675 | =item Ordinary Block of Text | |
2676 | ||
2677 | =item The Intent | |
2678 | ||
8ebc5c01 | 2679 | =item Embedding Pods in Perl Modules |
cb1a09d0 | 2680 | |
8ebc5c01 | 2681 | =item Common Pod Pitfalls |
cb1a09d0 | 2682 | |
d516a115 JH |
2683 | =back |
2684 | ||
8ebc5c01 | 2685 | =item SEE ALSO |
cb1a09d0 | 2686 | |
8ebc5c01 | 2687 | =item AUTHOR |
cb1a09d0 | 2688 | |
8ebc5c01 | 2689 | =head2 perlbook - Perl book information |
cb1a09d0 | 2690 | |
8ebc5c01 | 2691 | =item DESCRIPTION |
cb1a09d0 | 2692 | |
8ebc5c01 | 2693 | =head2 perlembed - how to embed perl in your C program |
cb1a09d0 | 2694 | |
8ebc5c01 | 2695 | =item DESCRIPTION |
cb1a09d0 | 2696 | |
8ebc5c01 | 2697 | =over |
cb1a09d0 | 2698 | |
8ebc5c01 | 2699 | =item PREAMBLE |
cb1a09d0 | 2700 | |
54310121 | 2701 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
8ebc5c01 | 2702 | Perl?>, B<Use C from C?>, B<Use Perl from C?> |
cb1a09d0 | 2703 | |
8ebc5c01 | 2704 | =item ROADMAP |
cb1a09d0 | 2705 | |
8ebc5c01 | 2706 | =item Compiling your C program |
cb1a09d0 | 2707 | |
8ebc5c01 | 2708 | =item Adding a Perl interpreter to your C program |
cb1a09d0 | 2709 | |
8ebc5c01 | 2710 | =item Calling a Perl subroutine from your C program |
cb1a09d0 | 2711 | |
8ebc5c01 | 2712 | =item Evaluating a Perl statement from your C program |
cb1a09d0 | 2713 | |
8ebc5c01 | 2714 | =item Performing Perl pattern matches and substitutions from your C program |
cb1a09d0 | 2715 | |
8ebc5c01 | 2716 | =item Fiddling with the Perl stack from your C program |
cb1a09d0 | 2717 | |
8ebc5c01 | 2718 | =item Maintaining a persistent interpreter |
cb1a09d0 | 2719 | |
8ebc5c01 | 2720 | =item Maintaining multiple interpreter instances |
cb1a09d0 | 2721 | |
8ebc5c01 | 2722 | =item Using Perl modules, which themselves use C libraries, from your C |
2723 | program | |
cb1a09d0 | 2724 | |
8ebc5c01 | 2725 | =back |
cb1a09d0 | 2726 | |
3e3baf6d TB |
2727 | =item Embedding Perl under Win32 |
2728 | ||
8ebc5c01 | 2729 | =item MORAL |
cb1a09d0 | 2730 | |
8ebc5c01 | 2731 | =item AUTHOR |
cb1a09d0 | 2732 | |
f86702cc | 2733 | =item COPYRIGHT |
2734 | ||
28757baa | 2735 | =head2 perlapio - perl's IO abstraction interface. |
cb1a09d0 | 2736 | |
8ebc5c01 | 2737 | =item SYNOPSIS |
cb1a09d0 AD |
2738 | |
2739 | =item DESCRIPTION | |
2740 | ||
8ebc5c01 | 2741 | B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>, |
2742 | B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>, | |
2743 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, | |
2744 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
d516a115 JH |
2745 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, |
2746 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
8ebc5c01 | 2747 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, |
2748 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>, | |
2749 | B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
2750 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()> | |
cb1a09d0 AD |
2751 | |
2752 | =over | |
2753 | ||
8ebc5c01 | 2754 | =item Co-existence with stdio |
cb1a09d0 | 2755 | |
8ebc5c01 | 2756 | B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>, |
2757 | B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>, | |
2758 | B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>, | |
2759 | B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>, | |
2760 | B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, | |
2761 | B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)> | |
cb1a09d0 | 2762 | |
8ebc5c01 | 2763 | =back |
cb1a09d0 | 2764 | |
8ebc5c01 | 2765 | =head2 perlxs - XS language reference manual |
cb1a09d0 | 2766 | |
8ebc5c01 | 2767 | =item DESCRIPTION |
cb1a09d0 | 2768 | |
8ebc5c01 | 2769 | =over |
cb1a09d0 AD |
2770 | |
2771 | =item Introduction | |
2772 | ||
cb1a09d0 AD |
2773 | =item On The Road |
2774 | ||
cb1a09d0 AD |
2775 | =item The Anatomy of an XSUB |
2776 | ||
cb1a09d0 AD |
2777 | =item The Argument Stack |
2778 | ||
cb1a09d0 AD |
2779 | =item The RETVAL Variable |
2780 | ||
cb1a09d0 AD |
2781 | =item The MODULE Keyword |
2782 | ||
cb1a09d0 AD |
2783 | =item The PACKAGE Keyword |
2784 | ||
cb1a09d0 AD |
2785 | =item The PREFIX Keyword |
2786 | ||
cb1a09d0 AD |
2787 | =item The OUTPUT: Keyword |
2788 | ||
cb1a09d0 AD |
2789 | =item The CODE: Keyword |
2790 | ||
7d2bfb28 | 2791 | =item The INIT: Keyword |
2792 | ||
cb1a09d0 AD |
2793 | =item The NO_INIT Keyword |
2794 | ||
cb1a09d0 AD |
2795 | =item Initializing Function Parameters |
2796 | ||
cb1a09d0 AD |
2797 | =item Default Parameter Values |
2798 | ||
7d2bfb28 | 2799 | =item The PREINIT: Keyword |
2800 | ||
8ebc5c01 | 2801 | =item The SCOPE: Keyword |
7d2bfb28 | 2802 | |
2803 | =item The INPUT: Keyword | |
2804 | ||
cb1a09d0 AD |
2805 | =item Variable-length Parameter Lists |
2806 | ||
193fb0af GS |
2807 | =item The C_ARGS: Keyword |
2808 | ||
cb1a09d0 AD |
2809 | =item The PPCODE: Keyword |
2810 | ||
cb1a09d0 AD |
2811 | =item Returning Undef And Empty Lists |
2812 | ||
cb1a09d0 AD |
2813 | =item The REQUIRE: Keyword |
2814 | ||
cb1a09d0 AD |
2815 | =item The CLEANUP: Keyword |
2816 | ||
cb1a09d0 AD |
2817 | =item The BOOT: Keyword |
2818 | ||
7d2bfb28 | 2819 | =item The VERSIONCHECK: Keyword |
2820 | ||
7d2bfb28 | 2821 | =item The PROTOTYPES: Keyword |
2822 | ||
7d2bfb28 | 2823 | =item The PROTOTYPE: Keyword |
2824 | ||
7d2bfb28 | 2825 | =item The ALIAS: Keyword |
2826 | ||
193fb0af GS |
2827 | =item The INTERFACE: Keyword |
2828 | ||
2829 | =item The INTERFACE_MACRO: Keyword | |
2830 | ||
7d2bfb28 | 2831 | =item The INCLUDE: Keyword |
2832 | ||
7d2bfb28 | 2833 | =item The CASE: Keyword |
2834 | ||
7d2bfb28 | 2835 | =item The & Unary Operator |
2836 | ||
cb1a09d0 AD |
2837 | =item Inserting Comments and C Preprocessor Directives |
2838 | ||
cb1a09d0 AD |
2839 | =item Using XS With C++ |
2840 | ||
cb1a09d0 AD |
2841 | =item Interface Strategy |
2842 | ||
cb1a09d0 AD |
2843 | =item Perl Objects And C Structures |
2844 | ||
cb1a09d0 AD |
2845 | =item The Typemap |
2846 | ||
cb1a09d0 AD |
2847 | =back |
2848 | ||
2849 | =item EXAMPLES | |
2850 | ||
7d2bfb28 | 2851 | =item XS VERSION |
2852 | ||
cb1a09d0 AD |
2853 | =item AUTHOR |
2854 | ||
8ebc5c01 | 2855 | =head2 perlxstut, perlXStut - Tutorial for XSUBs |
cb1a09d0 AD |
2856 | |
2857 | =item DESCRIPTION | |
2858 | ||
7d2bfb28 | 2859 | =over |
2860 | ||
2861 | =item VERSION CAVEAT | |
2862 | ||
7d2bfb28 | 2863 | =item DYNAMIC VERSUS STATIC |
2864 | ||
cb1a09d0 AD |
2865 | =item EXAMPLE 1 |
2866 | ||
cb1a09d0 AD |
2867 | =item EXAMPLE 2 |
2868 | ||
cb1a09d0 AD |
2869 | =item WHAT HAS GONE ON? |
2870 | ||
8ebc5c01 | 2871 | =item WRITING GOOD TEST SCRIPTS |
cb1a09d0 AD |
2872 | |
2873 | =item EXAMPLE 3 | |
2874 | ||
cb1a09d0 AD |
2875 | =item WHAT'S NEW HERE? |
2876 | ||
cb1a09d0 AD |
2877 | =item INPUT AND OUTPUT PARAMETERS |
2878 | ||
cb1a09d0 AD |
2879 | =item THE XSUBPP COMPILER |
2880 | ||
cb1a09d0 AD |
2881 | =item THE TYPEMAP FILE |
2882 | ||
cb1a09d0 AD |
2883 | =item WARNING |
2884 | ||
8ebc5c01 | 2885 | =item EXAMPLE 4 |
cb1a09d0 | 2886 | |
8ebc5c01 | 2887 | =item WHAT HAS HAPPENED HERE? |
7d2bfb28 | 2888 | |
8ebc5c01 | 2889 | =item SPECIFYING ARGUMENTS TO XSUBPP |
7d2bfb28 | 2890 | |
2891 | =item THE ARGUMENT STACK | |
2892 | ||
7d2bfb28 | 2893 | =item EXTENDING YOUR EXTENSION |
2894 | ||
7d2bfb28 | 2895 | =item DOCUMENTING YOUR EXTENSION |
2896 | ||
7d2bfb28 | 2897 | =item INSTALLING YOUR EXTENSION |
2898 | ||
7d2bfb28 | 2899 | =item SEE ALSO |
cb1a09d0 | 2900 | |
cb1a09d0 AD |
2901 | =item Author |
2902 | ||
cb1a09d0 AD |
2903 | =item Last Changed |
2904 | ||
7d2bfb28 | 2905 | =back |
2906 | ||
cb1a09d0 AD |
2907 | =head2 perlguts - Perl's Internal Functions |
2908 | ||
2909 | =item DESCRIPTION | |
2910 | ||
0a753a76 | 2911 | =item Variables |
2912 | ||
8ebc5c01 | 2913 | =over |
cb1a09d0 AD |
2914 | |
2915 | =item Datatypes | |
2916 | ||
cb1a09d0 AD |
2917 | =item What is an "IV"? |
2918 | ||
54310121 | 2919 | =item Working with SVs |
cb1a09d0 | 2920 | |
cb1a09d0 AD |
2921 | =item What's Really Stored in an SV? |
2922 | ||
54310121 | 2923 | =item Working with AVs |
cb1a09d0 | 2924 | |
54310121 | 2925 | =item Working with HVs |
cb1a09d0 | 2926 | |
1e422769 | 2927 | =item Hash API Extensions |
2928 | ||
cb1a09d0 AD |
2929 | =item References |
2930 | ||
cb1a09d0 AD |
2931 | =item Blessed References and Class Objects |
2932 | ||
cb1a09d0 AD |
2933 | =item Creating New Variables |
2934 | ||
8ebc5c01 | 2935 | =item Reference Counts and Mortality |
cb1a09d0 | 2936 | |
8ebc5c01 | 2937 | =item Stashes and Globs |
cb1a09d0 | 2938 | |
54310121 | 2939 | =item Double-Typed SVs |
0a753a76 | 2940 | |
2941 | =item Magic Variables | |
cb1a09d0 | 2942 | |
cb1a09d0 AD |
2943 | =item Assigning Magic |
2944 | ||
cb1a09d0 AD |
2945 | =item Magic Virtual Tables |
2946 | ||
cb1a09d0 AD |
2947 | =item Finding Magic |
2948 | ||
3e3baf6d TB |
2949 | =item Understanding the Magic of Tied Hashes and Arrays |
2950 | ||
d516a115 JH |
2951 | =item Localizing changes |
2952 | ||
2953 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, | |
2954 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP | |
2955 | *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char | |
2956 | *key, I32 length)>, C<SAVEDESTRUCTOR(f,p)>, C<SAVESTACK_POS()>, C<SV* | |
2957 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
2958 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
2959 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
2960 | save_hptr(HV **hptr)> | |
2961 | ||
0a753a76 | 2962 | =back |
2963 | ||
2964 | =item Subroutines | |
2965 | ||
2966 | =over | |
cb1a09d0 | 2967 | |
68dc0745 | 2968 | =item XSUBs and the Argument Stack |
cb1a09d0 AD |
2969 | |
2970 | =item Calling Perl Routines from within C Programs | |
2971 | ||
cb1a09d0 AD |
2972 | =item Memory Allocation |
2973 | ||
8ebc5c01 | 2974 | =item PerlIO |
cb1a09d0 | 2975 | |
8ebc5c01 | 2976 | =item Putting a C value on Perl stack |
cb1a09d0 | 2977 | |
8ebc5c01 | 2978 | =item Scratchpads |
cb1a09d0 | 2979 | |
2ae324a7 | 2980 | =item Scratchpads and recursion |
cb1a09d0 | 2981 | |
0a753a76 | 2982 | =back |
2983 | ||
2984 | =item Compiled code | |
2985 | ||
2986 | =over | |
2987 | ||
2988 | =item Code tree | |
2989 | ||
2990 | =item Examining the tree | |
2991 | ||
2992 | =item Compile pass 1: check routines | |
2993 | ||
2994 | =item Compile pass 1a: constant folding | |
2995 | ||
2996 | =item Compile pass 2: context propagation | |
2997 | ||
2998 | =item Compile pass 3: peephole optimization | |
2999 | ||
3000 | =back | |
3001 | ||
8ebc5c01 | 3002 | =item API LISTING |
cb1a09d0 | 3003 | |
193fb0af | 3004 | av_clear, av_extend, av_fetch, AvFILL, av_len, av_make, av_pop, av_push, |
8ebc5c01 | 3005 | av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH, |
9cde0e7f GS |
3006 | PL_DBsingle, PL_DBsub, PL_DBtrace, dMARK, dORIGMARK, PL_dowarn, dSP, |
3007 | dXSARGS, dXSI32, do_binmode, ENTER, EXTEND, fbm_compile, fbm_instr, | |
3008 | FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V, G_NOARGS, G_SCALAR, | |
3009 | gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, G_VOID, gv_stashpv, | |
3010 | gv_stashsv, GvSV, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, | |
14218588 GS |
3011 | HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delete, hv_delete_ent, |
3012 | hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, | |
3013 | hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, HvNAME, | |
3014 | hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, | |
3015 | isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, MARK, mg_clear, | |
3016 | mg_copy, mg_find, mg_free, mg_get, mg_len, mg_magical, mg_set, modglobal, | |
3017 | Move, PL_na, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, | |
3018 | NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv, | |
3019 | newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, | |
3020 | perl_alloc, perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv, | |
193fb0af GS |
3021 | perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv, perl_free, |
3022 | perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse, | |
3023 | perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi, | |
3024 | PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, RETVAL, safefree, | |
3025 | safemalloc, saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, | |
3026 | strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless, | |
3027 | sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf, sv_catpvf_mg, | |
3028 | sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, SvCUR, SvCUR_set, sv_dec, | |
14218588 GS |
3029 | sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW, sv_grow, sv_inc, |
3030 | sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp, sv_isa, | |
3031 | sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy, | |
9cde0e7f | 3032 | sv_newmortal, SvNIOK, SvNIOK_off, SvNIOKp, PL_sv_no, SvNOK, SvNOK_off, |
193fb0af | 3033 | SvNOK_on, SvNOK_only, SvNOKp, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOK_off, |
14218588 GS |
3034 | SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPV_nolen, SvPVX, |
3035 | SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, | |
3036 | SvSETMAGIC, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, | |
3037 | sv_setpv_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf, | |
193fb0af GS |
3038 | sv_setpvf_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, |
3039 | SvSetSV, SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, | |
3040 | SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SVt_IV, SVt_PV, | |
3041 | SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE, SvTYPE, svtype, | |
9cde0e7f | 3042 | PL_sv_undef, sv_unref, SvUPGRADE, sv_upgrade, sv_usepvn, sv_usepvn_mg, |
193fb0af GS |
3043 | sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), |
3044 | sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), SvUV, | |
9cde0e7f | 3045 | SvUVX, PL_sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, |
193fb0af | 3046 | XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, |
46fc3d4c | 3047 | XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV, |
3048 | XST_mNO, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, | |
3049 | Zero | |
cb1a09d0 | 3050 | |
193fb0af | 3051 | =item AUTHORS |
cb1a09d0 AD |
3052 | |
3053 | =head2 perlcall - Perl calling conventions from C | |
3054 | ||
3055 | =item DESCRIPTION | |
3056 | ||
cb1a09d0 AD |
3057 | An Error Handler, An Event Driven Program |
3058 | ||
3059 | =item THE PERL_CALL FUNCTIONS | |
3060 | ||
14218588 | 3061 | perl_call_sv, perl_call_pv, perl_call_method, perl_call_argv |
cb1a09d0 AD |
3062 | |
3063 | =item FLAG VALUES | |
3064 | ||
cb1a09d0 AD |
3065 | =over |
3066 | ||
54310121 | 3067 | =item G_VOID |
3068 | ||
cb1a09d0 AD |
3069 | =item G_SCALAR |
3070 | ||
cb1a09d0 AD |
3071 | =item G_ARRAY |
3072 | ||
cb1a09d0 AD |
3073 | =item G_DISCARD |
3074 | ||
cb1a09d0 AD |
3075 | =item G_NOARGS |
3076 | ||
54310121 | 3077 | =item G_EVAL |
cb1a09d0 | 3078 | |
7d2bfb28 | 3079 | =item G_KEEPERR |
3080 | ||
54310121 | 3081 | =item Determining the Context |
cb1a09d0 AD |
3082 | |
3083 | =back | |
3084 | ||
3085 | =item KNOWN PROBLEMS | |
3086 | ||
cb1a09d0 AD |
3087 | =item EXAMPLES |
3088 | ||
cb1a09d0 AD |
3089 | =over |
3090 | ||
3091 | =item No Parameters, Nothing returned | |
3092 | ||
cb1a09d0 AD |
3093 | =item Passing Parameters |
3094 | ||
cb1a09d0 AD |
3095 | =item Returning a Scalar |
3096 | ||
cb1a09d0 AD |
3097 | =item Returning a list of values |
3098 | ||
cb1a09d0 AD |
3099 | =item Returning a list in a scalar context |
3100 | ||
cb1a09d0 AD |
3101 | =item Returning Data from Perl via the parameter list |
3102 | ||
cb1a09d0 AD |
3103 | =item Using G_EVAL |
3104 | ||
7d2bfb28 | 3105 | =item Using G_KEEPERR |
3106 | ||
cb1a09d0 AD |
3107 | =item Using perl_call_sv |
3108 | ||
cb1a09d0 AD |
3109 | =item Using perl_call_argv |
3110 | ||
cb1a09d0 AD |
3111 | =item Using perl_call_method |
3112 | ||
54310121 | 3113 | =item Using GIMME_V |
cb1a09d0 | 3114 | |
cb1a09d0 AD |
3115 | =item Using Perl to dispose of temporaries |
3116 | ||
cb1a09d0 AD |
3117 | =item Strategies for storing Callback Context Information |
3118 | ||
cb1a09d0 AD |
3119 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
3120 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
3121 | callback | |
3122 | ||
3123 | =item Alternate Stack Manipulation | |
3124 | ||
5cd24f17 | 3125 | =item Creating and calling an anonymous subroutine in C |
3126 | ||
cb1a09d0 AD |
3127 | =back |
3128 | ||
3129 | =item SEE ALSO | |
3130 | ||
cb1a09d0 AD |
3131 | =item AUTHOR |
3132 | ||
cb1a09d0 AD |
3133 | =item DATE |
3134 | ||
d516a115 JH |
3135 | =head2 perlhist - the Perl history records |
3136 | ||
3137 | =item DESCRIPTION | |
3138 | ||
3139 | =item INTRODUCTION | |
3140 | ||
3141 | =item THE KEEPERS OF THE PUMPKIN | |
3142 | ||
3143 | =over | |
3144 | ||
3145 | =item PUMPKIN? | |
3146 | ||
3147 | =back | |
3148 | ||
3149 | =item THE RECORDS | |
3150 | ||
3151 | =over | |
3152 | ||
3153 | =item SELECTED RELEASE SIZES | |
3154 | ||
3155 | =item SELECTED PATCH SIZES | |
3156 | ||
3157 | =back | |
3158 | ||
3159 | =item THE KEEPERS OF THE RECORDS | |
3160 | ||
8ebc5c01 | 3161 | =head1 PRAGMA DOCUMENTATION |
cb1a09d0 | 3162 | |
d516a115 JH |
3163 | =head2 attrs - set/get attributes of a subroutine |
3164 | ||
3165 | =item SYNOPSIS | |
3166 | ||
3167 | =item DESCRIPTION | |
3168 | ||
3169 | method, locked | |
3170 | ||
fb9cefb4 GS |
3171 | =head2 re - Perl pragma to alter regular expression behaviour |
3172 | ||
3173 | =item SYNOPSIS | |
3174 | ||
3175 | =item DESCRIPTION | |
3176 | ||
14218588 GS |
3177 | =head2 attrs - set/get attributes of a subroutine |
3178 | ||
3179 | =item SYNOPSIS | |
3180 | ||
3181 | =item DESCRIPTION | |
3182 | ||
3183 | method, locked | |
3184 | ||
68dc0745 | 3185 | =head2 autouse - postpone load of modules until a function is used |
3186 | ||
3187 | =item SYNOPSIS | |
3188 | ||
3189 | =item DESCRIPTION | |
3190 | ||
3191 | =item WARNING | |
3192 | ||
68dc0745 | 3193 | =item AUTHOR |
3194 | ||
3195 | =item SEE ALSO | |
3196 | ||
d516a115 JH |
3197 | =head2 base - Establish IS-A relationship with base class at compile time |
3198 | ||
3199 | =item SYNOPSIS | |
3200 | ||
3201 | =item DESCRIPTION | |
3202 | ||
14218588 GS |
3203 | =item HISTORY |
3204 | ||
fb9cefb4 | 3205 | =item SEE ALSO |
d516a115 | 3206 | |
8ebc5c01 | 3207 | =head2 blib - Use MakeMaker's uninstalled version of a package |
cb1a09d0 | 3208 | |
8ebc5c01 | 3209 | =item SYNOPSIS |
cb1a09d0 | 3210 | |
8ebc5c01 | 3211 | =item DESCRIPTION |
cb1a09d0 | 3212 | |
8ebc5c01 | 3213 | =item BUGS |
cb1a09d0 | 3214 | |
8ebc5c01 | 3215 | =item AUTHOR |
cb1a09d0 | 3216 | |
a10cf691 GS |
3217 | =head2 caller - inherit pragmatic attributes from the context of the caller |
3218 | ||
3219 | =item SYNOPSIS | |
3220 | ||
3221 | =item DESCRIPTION | |
3222 | ||
3223 | encoding | |
3224 | ||
54310121 | 3225 | =head2 constant - Perl pragma to declare constants |
3226 | ||
3227 | =item SYNOPSIS | |
3228 | ||
3229 | =item DESCRIPTION | |
3230 | ||
3231 | =item NOTES | |
3232 | ||
3233 | =item TECHNICAL NOTE | |
3234 | ||
3235 | =item BUGS | |
3236 | ||
3237 | =item AUTHOR | |
3238 | ||
3239 | =item COPYRIGHT | |
3240 | ||
8ebc5c01 | 3241 | =head2 diagnostics - Perl compiler pragma to force verbose warning |
3242 | diagnostics | |
cb1a09d0 | 3243 | |
8ebc5c01 | 3244 | =item SYNOPSIS |
cb1a09d0 | 3245 | |
8ebc5c01 | 3246 | =item DESCRIPTION |
cb1a09d0 | 3247 | |
8ebc5c01 | 3248 | =over |
cb1a09d0 | 3249 | |
8ebc5c01 | 3250 | =item The C<diagnostics> Pragma |
cb1a09d0 | 3251 | |
8ebc5c01 | 3252 | =item The I<splain> Program |
cb1a09d0 | 3253 | |
8ebc5c01 | 3254 | =back |
cb1a09d0 | 3255 | |
8ebc5c01 | 3256 | =item EXAMPLES |
cb1a09d0 | 3257 | |
8ebc5c01 | 3258 | =item INTERNALS |
cb1a09d0 | 3259 | |
8ebc5c01 | 3260 | =item BUGS |
cb1a09d0 | 3261 | |
8ebc5c01 | 3262 | =item AUTHOR |
cb1a09d0 | 3263 | |
d516a115 JH |
3264 | =head2 fields - compile-time class fields |
3265 | ||
3266 | =item SYNOPSIS | |
3267 | ||
3268 | =item DESCRIPTION | |
3269 | ||
fb9cefb4 GS |
3270 | =item SEE ALSO |
3271 | ||
14218588 GS |
3272 | =head2 filetest - Perl pragma to control the filetest permission operators |
3273 | ||
3274 | =item SYNOPSIS | |
3275 | ||
3276 | $can_perhaps_read = -r "file"; # use the mode bits | |
3277 | { | |
3278 | use filetest 'access'; # intuit harder | |
3279 | $can_really_read = -r "file"; | |
3280 | } | |
3281 | $can_perhaps_read = -r "file"; # use the mode bits again | |
3282 | ||
3283 | =item DESCRIPTION | |
3284 | ||
3285 | =over | |
3286 | ||
3287 | =item subpragma access | |
3288 | ||
3289 | =back | |
3290 | ||
8ebc5c01 | 3291 | =head2 integer - Perl pragma to compute arithmetic in integer instead of |
3292 | double | |
cb1a09d0 | 3293 | |
8ebc5c01 | 3294 | =item SYNOPSIS |
cb1a09d0 | 3295 | |
8ebc5c01 | 3296 | =item DESCRIPTION |
cb1a09d0 | 3297 | |
8ebc5c01 | 3298 | =head2 less - perl pragma to request less of something from the compiler |
cb1a09d0 | 3299 | |
8ebc5c01 | 3300 | =item SYNOPSIS |
cb1a09d0 | 3301 | |
8ebc5c01 | 3302 | =item DESCRIPTION |
cb1a09d0 | 3303 | |
8ebc5c01 | 3304 | =head2 lib - manipulate @INC at compile time |
cb1a09d0 | 3305 | |
8ebc5c01 | 3306 | =item SYNOPSIS |
cb1a09d0 | 3307 | |
8ebc5c01 | 3308 | =item DESCRIPTION |
cb1a09d0 | 3309 | |
8ebc5c01 | 3310 | =over |
3311 | ||
3312 | =item ADDING DIRECTORIES TO @INC | |
cb1a09d0 | 3313 | |
8ebc5c01 | 3314 | =item DELETING DIRECTORIES FROM @INC |
cb1a09d0 | 3315 | |
8ebc5c01 | 3316 | =item RESTORING ORIGINAL @INC |
cb1a09d0 | 3317 | |
8ebc5c01 | 3318 | =back |
cb1a09d0 | 3319 | |
8ebc5c01 | 3320 | =item SEE ALSO |
cb1a09d0 | 3321 | |
8ebc5c01 | 3322 | =item AUTHOR |
cb1a09d0 | 3323 | |
8ebc5c01 | 3324 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
3325 | operations | |
cb1a09d0 | 3326 | |
8ebc5c01 | 3327 | =item SYNOPSIS |
cb1a09d0 AD |
3328 | |
3329 | =item DESCRIPTION | |
3330 | ||
14218588 GS |
3331 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
3332 | ||
3333 | =item SYNOPSIS | |
3334 | ||
3335 | =item DESCRIPTION | |
3336 | ||
3337 | =item SEE ALSO | |
3338 | ||
8ebc5c01 | 3339 | =head2 overload - Package for overloading perl operations |
cb1a09d0 | 3340 | |
8ebc5c01 | 3341 | =item SYNOPSIS |
cb1a09d0 | 3342 | |
8ebc5c01 | 3343 | =item DESCRIPTION |
cb1a09d0 | 3344 | |
8ebc5c01 | 3345 | =over |
cb1a09d0 | 3346 | |
8ebc5c01 | 3347 | =item Declaration of overloaded functions |
cb1a09d0 | 3348 | |
8ebc5c01 | 3349 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 3350 | |
8ebc5c01 | 3351 | FALSE, TRUE, C<undef> |
cb1a09d0 | 3352 | |
8ebc5c01 | 3353 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 3354 | |
14218588 GS |
3355 | =item Calling Conventions for Mutators |
3356 | ||
3357 | C<++> and C<-->, C<x=> and other assignment versions | |
3358 | ||
8ebc5c01 | 3359 | =item Overloadable Operations |
cb1a09d0 | 3360 | |
8ebc5c01 | 3361 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
3362 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
14218588 | 3363 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
cb1a09d0 | 3364 | |
774d564b | 3365 | =item Inheritance and overloading |
3366 | ||
3367 | Strings as values of C<use overload> directive, Overloading of an operation | |
3368 | is inherited by derived classes | |
3369 | ||
8ebc5c01 | 3370 | =back |
cb1a09d0 | 3371 | |
8ebc5c01 | 3372 | =item SPECIAL SYMBOLS FOR C<use overload> |
cb1a09d0 | 3373 | |
8ebc5c01 | 3374 | =over |
cb1a09d0 | 3375 | |
774d564b | 3376 | =item Last Resort |
cb1a09d0 | 3377 | |
8ebc5c01 | 3378 | =item Fallback |
cb1a09d0 | 3379 | |
8ebc5c01 | 3380 | C<undef>, TRUE, defined, but FALSE |
cb1a09d0 | 3381 | |
8ebc5c01 | 3382 | =item Copy Constructor |
cb1a09d0 | 3383 | |
8ebc5c01 | 3384 | B<Example> |
cb1a09d0 | 3385 | |
8ebc5c01 | 3386 | =back |
cb1a09d0 | 3387 | |
8ebc5c01 | 3388 | =item MAGIC AUTOGENERATION |
cb1a09d0 | 3389 | |
8ebc5c01 | 3390 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
3391 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
14218588 GS |
3392 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
3393 | I<Copy operator> | |
cb1a09d0 | 3394 | |
14218588 | 3395 | =item Losing overloading |
cb1a09d0 | 3396 | |
8ebc5c01 | 3397 | =item Run-time Overloading |
cb1a09d0 | 3398 | |
8ebc5c01 | 3399 | =item Public functions |
cb1a09d0 | 3400 | |
8ebc5c01 | 3401 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 3402 | |
fb9cefb4 GS |
3403 | =item Overloading constants |
3404 | ||
3405 | integer, float, binary, q, qr | |
3406 | ||
8ebc5c01 | 3407 | =item IMPLEMENTATION |
cb1a09d0 | 3408 | |
14218588 GS |
3409 | =item Metaphor clash |
3410 | ||
3411 | =item Cookbook | |
3412 | ||
3413 | =over | |
3414 | ||
3415 | =item Two-face scalars | |
3416 | ||
3417 | =item Two-face references | |
3418 | ||
3419 | =item Symbolic calculator | |
3420 | ||
3421 | =item I<Really> symbolic calculator | |
3422 | ||
3423 | =back | |
3424 | ||
8ebc5c01 | 3425 | =item AUTHOR |
cb1a09d0 | 3426 | |
8ebc5c01 | 3427 | =item DIAGNOSTICS |
cb1a09d0 | 3428 | |
8ebc5c01 | 3429 | =item BUGS |
cb1a09d0 | 3430 | |
14218588 GS |
3431 | =head2 re - Perl pragma to alter regular expression behaviour |
3432 | ||
3433 | =item SYNOPSIS | |
3434 | ||
3435 | =item DESCRIPTION | |
3436 | ||
8ebc5c01 | 3437 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 3438 | |
8ebc5c01 | 3439 | =item SYNOPSIS |
cb1a09d0 | 3440 | |
8ebc5c01 | 3441 | =item DESCRIPTION |
cb1a09d0 | 3442 | |
8ebc5c01 | 3443 | =item OPTIONS |
cb1a09d0 | 3444 | |
8ebc5c01 | 3445 | =over |
cb1a09d0 | 3446 | |
8ebc5c01 | 3447 | =item SIGNAL HANDLERS |
cb1a09d0 | 3448 | |
8ebc5c01 | 3449 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
cb1a09d0 | 3450 | |
8ebc5c01 | 3451 | =item SIGNAL LISTS |
cb1a09d0 | 3452 | |
8ebc5c01 | 3453 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
cb1a09d0 | 3454 | |
8ebc5c01 | 3455 | =item OTHER |
cb1a09d0 | 3456 | |
8ebc5c01 | 3457 | B<untrapped>, B<any>, I<signal>, I<number> |
cb1a09d0 | 3458 | |
8ebc5c01 | 3459 | =back |
cb1a09d0 | 3460 | |
8ebc5c01 | 3461 | =item EXAMPLES |
cb1a09d0 | 3462 | |
8ebc5c01 | 3463 | =head2 strict - Perl pragma to restrict unsafe constructs |
cb1a09d0 | 3464 | |
8ebc5c01 | 3465 | =item SYNOPSIS |
cb1a09d0 | 3466 | |
8ebc5c01 | 3467 | =item DESCRIPTION |
cb1a09d0 | 3468 | |
8ebc5c01 | 3469 | C<strict refs>, C<strict vars>, C<strict subs> |
cb1a09d0 | 3470 | |
8ebc5c01 | 3471 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 AD |
3472 | |
3473 | =item SYNOPSIS | |
3474 | ||
cb1a09d0 AD |
3475 | =item DESCRIPTION |
3476 | ||
14218588 GS |
3477 | =head2 utf8 - Perl pragma to turn on UTF-8 and Unicode support |
3478 | ||
3479 | =item SYNOPSIS | |
3480 | ||
3481 | =item DESCRIPTION | |
3482 | ||
3483 | =item CAVEATS | |
3484 | ||
8ebc5c01 | 3485 | =head2 vars - Perl pragma to predeclare global variable names |
cb1a09d0 | 3486 | |
8ebc5c01 | 3487 | =item SYNOPSIS |
cb1a09d0 | 3488 | |
8ebc5c01 | 3489 | =item DESCRIPTION |
cb1a09d0 | 3490 | |
14218588 GS |
3491 | =head2 warning - Perl pragma to control optional warnings |
3492 | ||
3493 | =item SYNOPSIS | |
3494 | ||
3495 | =item DESCRIPTION | |
3496 | ||
3497 | C<warning deprecated> | |
3498 | ||
8ebc5c01 | 3499 | =head1 MODULE DOCUMENTATION |
cb1a09d0 | 3500 | |
8ebc5c01 | 3501 | =head2 AnyDBM_File - provide framework for multiple DBMs |
cb1a09d0 AD |
3502 | |
3503 | =item SYNOPSIS | |
3504 | ||
cb1a09d0 AD |
3505 | =item DESCRIPTION |
3506 | ||
cb1a09d0 AD |
3507 | =over |
3508 | ||
8ebc5c01 | 3509 | =item DBM Comparisons |
cb1a09d0 | 3510 | |
8ebc5c01 | 3511 | [0], [1], [2], [3] |
cb1a09d0 | 3512 | |
8ebc5c01 | 3513 | =back |
cb1a09d0 | 3514 | |
8ebc5c01 | 3515 | =item SEE ALSO |
cb1a09d0 | 3516 | |
4a6725af | 3517 | =head2 AutoLoader - load subroutines only on demand |
cb1a09d0 | 3518 | |
8ebc5c01 | 3519 | =item SYNOPSIS |
cb1a09d0 | 3520 | |
8ebc5c01 | 3521 | =item DESCRIPTION |
cb1a09d0 | 3522 | |
8ebc5c01 | 3523 | =over |
cb1a09d0 | 3524 | |
4a6725af NT |
3525 | =item Subroutine Stubs |
3526 | ||
3527 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
cb1a09d0 | 3528 | |
4a6725af | 3529 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
cb1a09d0 | 3530 | |
8ebc5c01 | 3531 | =item Package Lexicals |
cb1a09d0 | 3532 | |
4a6725af | 3533 | =item B<AutoLoader> vs. B<SelfLoader> |
cb1a09d0 | 3534 | |
8ebc5c01 | 3535 | =back |
cb1a09d0 | 3536 | |
4a6725af NT |
3537 | =item CAVEATS |
3538 | ||
3539 | =item SEE ALSO | |
cb1a09d0 | 3540 | |
8ebc5c01 | 3541 | =head2 AutoSplit - split a package for autoloading |
cb1a09d0 | 3542 | |
8ebc5c01 | 3543 | =item SYNOPSIS |
cb1a09d0 | 3544 | |
8ebc5c01 | 3545 | =item DESCRIPTION |
cb1a09d0 | 3546 | |
193fb0af GS |
3547 | $keep, $check, $modtime |
3548 | ||
3549 | =over | |
3550 | ||
3551 | =item Multiple packages | |
3552 | ||
3553 | =back | |
cb1a09d0 | 3554 | |
8ebc5c01 | 3555 | =item DIAGNOSTICS |
cb1a09d0 | 3556 | |
fb9cefb4 | 3557 | =head2 B - The Perl Compiler |
193fb0af GS |
3558 | |
3559 | =item SYNOPSIS | |
3560 | ||
3561 | =item DESCRIPTION | |
3562 | ||
fb9cefb4 | 3563 | =item OVERVIEW OF CLASSES |
193fb0af | 3564 | |
fb9cefb4 | 3565 | =over |
193fb0af | 3566 | |
fb9cefb4 | 3567 | =item SV-RELATED CLASSES |
193fb0af | 3568 | |
fb9cefb4 | 3569 | =item B::SV METHODS |
193fb0af | 3570 | |
fb9cefb4 | 3571 | REFCNT, FLAGS |
193fb0af | 3572 | |
fb9cefb4 | 3573 | =item B::IV METHODS |
193fb0af | 3574 | |
fb9cefb4 | 3575 | IV, IVX, needs64bits, packiv |
193fb0af | 3576 | |
fb9cefb4 | 3577 | =item B::NV METHODS |
193fb0af | 3578 | |
fb9cefb4 | 3579 | NV, NVX |
193fb0af | 3580 | |
fb9cefb4 | 3581 | =item B::RV METHODS |
193fb0af | 3582 | |
fb9cefb4 | 3583 | RV |
193fb0af | 3584 | |
fb9cefb4 | 3585 | =item B::PV METHODS |
193fb0af | 3586 | |
fb9cefb4 | 3587 | PV |
193fb0af | 3588 | |
fb9cefb4 | 3589 | =item B::PVMG METHODS |
cb1a09d0 | 3590 | |
fb9cefb4 | 3591 | MAGIC, SvSTASH |
cb1a09d0 | 3592 | |
fb9cefb4 | 3593 | =item B::MAGIC METHODS |
cb1a09d0 | 3594 | |
fb9cefb4 | 3595 | MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR |
cb1a09d0 | 3596 | |
fb9cefb4 | 3597 | =item B::PVLV METHODS |
cb1a09d0 | 3598 | |
fb9cefb4 | 3599 | TARGOFF, TARGLEN, TYPE, TARG |
cb1a09d0 | 3600 | |
fb9cefb4 | 3601 | =item B::BM METHODS |
cb1a09d0 | 3602 | |
fb9cefb4 | 3603 | USEFUL, PREVIOUS, RARE, TABLE |
cb1a09d0 | 3604 | |
fb9cefb4 | 3605 | =item B::GV METHODS |
cb1a09d0 | 3606 | |
fb9cefb4 GS |
3607 | NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILEGV, GvREFCNT, |
3608 | FLAGS | |
54310121 | 3609 | |
fb9cefb4 | 3610 | =item B::IO METHODS |
cb1a09d0 | 3611 | |
fb9cefb4 GS |
3612 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
3613 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS | |
cb1a09d0 | 3614 | |
fb9cefb4 | 3615 | =item B::AV METHODS |
cb1a09d0 | 3616 | |
fb9cefb4 | 3617 | FILL, MAX, OFF, ARRAY, AvFLAGS |
cb1a09d0 | 3618 | |
fb9cefb4 | 3619 | =item B::CV METHODS |
cb1a09d0 | 3620 | |
14218588 GS |
3621 | STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY, |
3622 | CvFLAGS | |
cb1a09d0 | 3623 | |
fb9cefb4 | 3624 | =item B::HV METHODS |
f86702cc | 3625 | |
fb9cefb4 | 3626 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
f86702cc | 3627 | |
fb9cefb4 | 3628 | =item OP-RELATED CLASSES |
f86702cc | 3629 | |
fb9cefb4 | 3630 | =item B::OP METHODS |
f86702cc | 3631 | |
fb9cefb4 | 3632 | next, sibling, ppaddr, desc, targ, type, seq, flags, private |
f86702cc | 3633 | |
fb9cefb4 | 3634 | =item B::UNOP METHOD |
54310121 | 3635 | |
fb9cefb4 | 3636 | first |
dc848c6f | 3637 | |
fb9cefb4 | 3638 | =item B::BINOP METHOD |
54310121 | 3639 | |
fb9cefb4 | 3640 | last |
54310121 | 3641 | |
fb9cefb4 | 3642 | =item B::LOGOP METHOD |
54310121 | 3643 | |
fb9cefb4 | 3644 | other |
54310121 | 3645 | |
fb9cefb4 | 3646 | =item B::LISTOP METHOD |
54310121 | 3647 | |
fb9cefb4 | 3648 | children |
54310121 | 3649 | |
fb9cefb4 | 3650 | =item B::PMOP METHODS |
54310121 | 3651 | |
fb9cefb4 | 3652 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp |
54310121 | 3653 | |
fb9cefb4 | 3654 | =item B::SVOP METHOD |
54310121 | 3655 | |
fb9cefb4 | 3656 | sv |
54310121 | 3657 | |
fb9cefb4 | 3658 | =item B::GVOP METHOD |
54310121 | 3659 | |
fb9cefb4 | 3660 | gv |
54310121 | 3661 | |
fb9cefb4 | 3662 | =item B::PVOP METHOD |
54310121 | 3663 | |
fb9cefb4 | 3664 | pv |
54310121 | 3665 | |
fb9cefb4 | 3666 | =item B::LOOP METHODS |
54310121 | 3667 | |
fb9cefb4 | 3668 | redoop, nextop, lastop |
54310121 | 3669 | |
fb9cefb4 | 3670 | =item B::COP METHODS |
54310121 | 3671 | |
fb9cefb4 | 3672 | label, stash, filegv, cop_seq, arybase, line |
54310121 | 3673 | |
fb9cefb4 | 3674 | =back |
54310121 | 3675 | |
fb9cefb4 | 3676 | =item FUNCTIONS EXPORTED BY C<B> |
54310121 | 3677 | |
14218588 GS |
3678 | main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes, |
3679 | sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), | |
3680 | walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), | |
a10cf691 | 3681 | hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names |
54310121 | 3682 | |
fb9cefb4 | 3683 | =item AUTHOR |
54310121 | 3684 | |
fb9cefb4 GS |
3685 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
3686 | bytecode | |
54310121 | 3687 | |
fb9cefb4 | 3688 | =item SYNOPSIS |
54310121 | 3689 | |
fb9cefb4 | 3690 | =item DESCRIPTION |
54310121 | 3691 | |
fb9cefb4 | 3692 | =item AUTHOR |
54310121 | 3693 | |
fb9cefb4 | 3694 | =head2 B::Assembler - Assemble Perl bytecode |
54310121 | 3695 | |
fb9cefb4 | 3696 | =item SYNOPSIS |
54310121 | 3697 | |
fb9cefb4 | 3698 | =item DESCRIPTION |
54310121 | 3699 | |
fb9cefb4 | 3700 | =item AUTHOR |
54310121 | 3701 | |
fb9cefb4 | 3702 | =head2 B::Bblock - Walk basic blocks |
54310121 | 3703 | |
fb9cefb4 | 3704 | =item SYNOPSIS |
54310121 | 3705 | |
fb9cefb4 | 3706 | =item DESCRIPTION |
54310121 | 3707 | |
fb9cefb4 | 3708 | =item AUTHOR |
54310121 | 3709 | |
fb9cefb4 | 3710 | =head2 B::Bytecode - Perl compiler's bytecode backend |
54310121 | 3711 | |
fb9cefb4 | 3712 | =item SYNOPSIS |
54310121 | 3713 | |
fb9cefb4 GS |
3714 | =item DESCRIPTION |
3715 | ||
3716 | =item OPTIONS | |
3717 | ||
3718 | B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>, | |
3719 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>, | |
3720 | B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m> | |
3721 | ||
14218588 GS |
3722 | =item EXAMPLES |
3723 | ||
fb9cefb4 GS |
3724 | =item BUGS |
3725 | ||
3726 | =item AUTHOR | |
3727 | ||
3728 | =head2 B::C - Perl compiler's C backend | |
3729 | ||
3730 | =item SYNOPSIS | |
3731 | ||
3732 | =item DESCRIPTION | |
3733 | ||
3734 | =item OPTIONS | |
3735 | ||
3736 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
3737 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On> | |
3738 | ||
3739 | =item EXAMPLES | |
3740 | ||
3741 | =item BUGS | |
3742 | ||
3743 | =item AUTHOR | |
3744 | ||
3745 | =head2 B::CC - Perl compiler's optimized C translation backend | |
3746 | ||
3747 | =item SYNOPSIS | |
3748 | ||
3749 | =item DESCRIPTION | |
3750 | ||
3751 | =item OPTIONS | |
3752 | ||
3753 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
3754 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
3755 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
3756 | ||
3757 | =item EXAMPLES | |
3758 | ||
3759 | =item BUGS | |
3760 | ||
3761 | =item DIFFERENCES | |
3762 | ||
3763 | =over | |
3764 | ||
3765 | =item Loops | |
3766 | ||
3767 | =item Context of ".." | |
3768 | ||
3769 | =item Arithmetic | |
3770 | ||
3771 | =item Deprecated features | |
3772 | ||
3773 | =back | |
3774 | ||
3775 | =item AUTHOR | |
3776 | ||
3777 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops | |
3778 | ||
3779 | =item SYNOPSIS | |
3780 | ||
3781 | =item DESCRIPTION | |
3782 | ||
3783 | =item AUTHOR | |
3784 | ||
3785 | =head2 B::Deparse - Perl compiler backend to produce perl code | |
3786 | ||
3787 | =item SYNOPSIS | |
3788 | ||
3789 | =item DESCRIPTION | |
3790 | ||
3791 | =item OPTIONS | |
3792 | ||
14218588 | 3793 | B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C> |
fb9cefb4 GS |
3794 | |
3795 | =item BUGS | |
3796 | ||
3797 | =item AUTHOR | |
3798 | ||
3799 | =head2 B::Disassembler - Disassemble Perl bytecode | |
3800 | ||
3801 | =item SYNOPSIS | |
3802 | ||
3803 | =item DESCRIPTION | |
3804 | ||
3805 | =item AUTHOR | |
3806 | ||
3807 | =head2 B::Lint - Perl lint | |
3808 | ||
3809 | =item SYNOPSIS | |
3810 | ||
3811 | =item DESCRIPTION | |
3812 | ||
3813 | =item OPTIONS AND LINT CHECKS | |
3814 | ||
3815 | B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>, | |
3816 | B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> | |
3817 | ||
3818 | =item NON LINT-CHECK OPTIONS | |
3819 | ||
3820 | B<-u Package> | |
3821 | ||
3822 | =item BUGS | |
3823 | ||
3824 | =item AUTHOR | |
3825 | ||
3826 | =head2 B::O, O - Generic interface to Perl Compiler backends | |
3827 | ||
3828 | =item SYNOPSIS | |
3829 | ||
3830 | =item DESCRIPTION | |
3831 | ||
3832 | =item CONVENTIONS | |
3833 | ||
3834 | =item IMPLEMENTATION | |
3835 | ||
3836 | =item AUTHOR | |
3837 | ||
3838 | =head2 B::Showlex - Show lexical variables used in functions or files | |
3839 | ||
3840 | =item SYNOPSIS | |
3841 | ||
3842 | =item DESCRIPTION | |
3843 | ||
3844 | =item AUTHOR | |
3845 | ||
3846 | =head2 B::Stackobj - Helper module for CC backend | |
3847 | ||
3848 | =item SYNOPSIS | |
3849 | ||
3850 | =item DESCRIPTION | |
3851 | ||
3852 | =item AUTHOR | |
3853 | ||
3854 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops | |
3855 | ||
3856 | =item SYNOPSIS | |
3857 | ||
3858 | =item DESCRIPTION | |
3859 | ||
3860 | =item AUTHOR | |
3861 | ||
3862 | =head2 B::Xref - Generates cross reference reports for Perl programs | |
3863 | ||
3864 | =item SYNOPSIS | |
3865 | ||
3866 | =item DESCRIPTION | |
3867 | ||
3868 | =item OPTIONS | |
3869 | ||
3870 | C<-oFILENAME>, C<-r>, C<-D[tO]> | |
3871 | ||
3872 | =item BUGS | |
3873 | ||
3874 | =item AUTHOR | |
3875 | ||
14218588 GS |
3876 | =head2 Bblock, B::Bblock - Walk basic blocks |
3877 | ||
3878 | =item SYNOPSIS | |
3879 | ||
3880 | =item DESCRIPTION | |
3881 | ||
3882 | =item AUTHOR | |
3883 | ||
fb9cefb4 GS |
3884 | =head2 Benchmark - benchmark running times of code |
3885 | ||
3886 | =item SYNOPSIS | |
3887 | ||
3888 | =item DESCRIPTION | |
3889 | ||
3890 | =over | |
3891 | ||
3892 | =item Methods | |
3893 | ||
3894 | new, debug | |
3895 | ||
3896 | =item Standard Exports | |
3897 | ||
3898 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
14218588 GS |
3899 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timesum ( |
3900 | T1, T2 ), timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
fb9cefb4 GS |
3901 | |
3902 | =item Optional Exports | |
3903 | ||
3904 | clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( ) | |
3905 | ||
3906 | =back | |
3907 | ||
3908 | =item NOTES | |
3909 | ||
3910 | =item INHERITANCE | |
3911 | ||
3912 | =item CAVEATS | |
3913 | ||
3914 | =item AUTHORS | |
3915 | ||
3916 | =item MODIFICATION HISTORY | |
3917 | ||
14218588 GS |
3918 | =head2 ByteLoader - load byte compiled perl code |
3919 | ||
3920 | =item SYNOPSIS | |
3921 | ||
3922 | =item DESCRIPTION | |
3923 | ||
3924 | =item AUTHOR | |
3925 | ||
3926 | =item SEE ALSO | |
3927 | ||
3928 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend | |
3929 | ||
3930 | =item SYNOPSIS | |
3931 | ||
3932 | =item DESCRIPTION | |
3933 | ||
3934 | =item OPTIONS | |
3935 | ||
3936 | B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>, | |
3937 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>, | |
3938 | B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m> | |
3939 | ||
3940 | =item EXAMPLES | |
3941 | ||
3942 | =item BUGS | |
3943 | ||
3944 | =item AUTHOR | |
3945 | ||
fb9cefb4 GS |
3946 | =head2 CGI - Simple Common Gateway Interface Class |
3947 | ||
3948 | =item SYNOPSIS | |
3949 | ||
3950 | =item ABSTRACT | |
3951 | ||
3952 | =item DESCRIPTION | |
3953 | ||
3954 | =over | |
3955 | ||
3956 | =item PROGRAMMING STYLE | |
3957 | ||
3958 | =item CALLING CGI.PM ROUTINES | |
3959 | ||
3960 | 1. Use another name for the argument, if one is available. Forexample, | |
3961 | -value is an alias for -values, 2. Change the capitalization, e.g. -Values, | |
3962 | 3. Put quotes around the argument name, e.g. '-values' | |
3963 | ||
3964 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): | |
3965 | ||
3966 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
3967 | ||
3968 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
3969 | ||
3970 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
3971 | ||
3972 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
3973 | ||
3974 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
3975 | ||
3976 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
3977 | ||
3978 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
3979 | ||
3980 | =item DELETING A PARAMETER COMPLETELY: | |
3981 | ||
3982 | =item DELETING ALL PARAMETERS: | |
3983 | ||
3984 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
3985 | ||
a10cf691 GS |
3986 | =item FETCHING THE PARAMETER LIST AS A HASH: |
3987 | ||
fb9cefb4 GS |
3988 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
3989 | ||
a10cf691 GS |
3990 | =item RETRIEVING CGI ERRORS |
3991 | ||
fb9cefb4 GS |
3992 | =item USING THE FUNCTION-ORIENTED INTERFACE |
3993 | ||
3994 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>, | |
3995 | B<:standard>, B<:all> | |
3996 | ||
3997 | =item PRAGMAS | |
3998 | ||
14218588 GS |
3999 | -any, -compile, -nph, -newstyle_urls, -autoload, -no_debug, |
4000 | -private_tempfiles | |
fb9cefb4 | 4001 | |
14218588 GS |
4002 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
4003 | ||
4004 | 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a | |
4005 | </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates | |
4006 | a </UL> tag) | |
4007 | ||
4008 | =back | |
fb9cefb4 GS |
4009 | |
4010 | =item GENERATING DYNAMIC DOCUMENTS | |
4011 | ||
4012 | =over | |
4013 | ||
4014 | =item CREATING A STANDARD HTTP HEADER: | |
4015 | ||
4016 | =item GENERATING A REDIRECTION HEADER | |
4017 | ||
4018 | =item CREATING THE HTML DOCUMENT HEADER | |
4019 | ||
4020 | B<Parameters:>, 4, 5, 6.. | |
4021 | ||
4022 | =item ENDING THE HTML DOCUMENT: | |
4023 | ||
4024 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
4025 | ||
4026 | =item OBTAINING THE SCRIPT'S URL | |
4027 | ||
4028 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
4029 | (B<-query_string>) | |
4030 | ||
14218588 GS |
4031 | =item MIXING POST AND URL PARAMETERS |
4032 | ||
fb9cefb4 GS |
4033 | =back |
4034 | ||
4035 | =item CREATING STANDARD HTML ELEMENTS: | |
4036 | ||
4037 | =over | |
4038 | ||
4039 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
4040 | ||
4041 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
4042 | ||
4043 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
4044 | ||
4045 | =item NON-STANDARD HTML SHORTCUTS | |
4046 | ||
14218588 GS |
4047 | =item PRETTY-PRINTING HTML |
4048 | ||
fb9cefb4 GS |
4049 | =back |
4050 | ||
4051 | =item CREATING FILL-OUT FORMS: | |
4052 | ||
4053 | =over | |
4054 | ||
4055 | =item CREATING AN ISINDEX TAG | |
4056 | ||
4057 | =item STARTING AND ENDING A FORM | |
4058 | ||
4059 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
4060 | ||
4061 | =item CREATING A TEXT FIELD | |
4062 | ||
4063 | B<Parameters> | |
4064 | ||
4065 | =item CREATING A BIG TEXT FIELD | |
4066 | ||
4067 | =item CREATING A PASSWORD FIELD | |
4068 | ||
4069 | =item CREATING A FILE UPLOAD FIELD | |
4070 | ||
4071 | B<Parameters> | |
4072 | ||
4073 | =item CREATING A POPUP MENU | |
4074 | ||
4075 | =item CREATING A SCROLLING LIST | |
4076 | ||
4077 | B<Parameters:> | |
4078 | ||
4079 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
54310121 | 4080 | |
4081 | B<Parameters:> | |
4082 | ||
4083 | =item CREATING A STANDALONE CHECKBOX | |
4084 | ||
4085 | B<Parameters:> | |
4086 | ||
4087 | =item CREATING A RADIO BUTTON GROUP | |
4088 | ||
4089 | B<Parameters:> | |
4090 | ||
4091 | =item CREATING A SUBMIT BUTTON | |
4092 | ||
4093 | B<Parameters:> | |
4094 | ||
4095 | =item CREATING A RESET BUTTON | |
4096 | ||
4097 | =item CREATING A DEFAULT BUTTON | |
4098 | ||
4099 | =item CREATING A HIDDEN FIELD | |
4100 | ||
4101 | B<Parameters:> | |
4102 | ||
4103 | =item CREATING A CLICKABLE IMAGE BUTTON | |
4104 | ||
4105 | B<Parameters:>, 3.The third option (-align, optional) is an alignment type, | |
4106 | and may be | |
4107 | TOP, BOTTOM or MIDDLE | |
4108 | ||
4109 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
4110 | ||
4111 | =back | |
4112 | ||
14218588 | 4113 | =item HTTP COOKIES |
54310121 | 4114 | |
4115 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
4116 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
4117 | ||
14218588 | 4118 | =item WORKING WITH FRAMES |
54310121 | 4119 | |
4120 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
4121 | document in the HTTP header, 3. Specify the destination for the document in | |
4122 | the <FORM> tag | |
4123 | ||
c90c0ff4 | 4124 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
4125 | ||
54310121 | 4126 | =item DEBUGGING |
4127 | ||
4128 | =over | |
4129 | ||
4130 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
4131 | ||
4132 | =back | |
4133 | ||
4134 | =item FETCHING ENVIRONMENT VARIABLES | |
4135 | ||
14218588 | 4136 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
54310121 | 4137 | B<path_translated()>, B<remote_host()>, B<script_name()>Return the script |
4138 | name as a partial URL, for self-refering | |
4139 | scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host | |
4140 | ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>, | |
a10cf691 | 4141 | B<request_method()>, B<content_type()>, B<http()>, B<https()> |
54310121 | 4142 | |
fb9cefb4 | 4143 | =item USING NPH SCRIPTS |
54310121 | 4144 | |
fb9cefb4 GS |
4145 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
4146 | parameters in the B<header()> and B<redirect()> statements: | |
54310121 | 4147 | |
fb9cefb4 | 4148 | =item Server Push |
54310121 | 4149 | |
fb9cefb4 | 4150 | multipart_init() |
14218588 | 4151 | multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end() |
54310121 | 4152 | |
fb9cefb4 | 4153 | =item Avoiding Denial of Service Attacks |
54310121 | 4154 | |
fb9cefb4 GS |
4155 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
4156 | basis>, B<2. Globally for all scripts> | |
54310121 | 4157 | |
fb9cefb4 | 4158 | =item COMPATIBILITY WITH CGI-LIB.PL |
54310121 | 4159 | |
4160 | =item AUTHOR INFORMATION | |
4161 | ||
4162 | =item CREDITS | |
4163 | ||
4164 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
4165 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
4166 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
14218588 GS |
4167 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
4168 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
4169 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
4170 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
4171 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
4172 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
4173 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
4174 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
4175 | ...and many many more.. | |
54310121 | 4176 | |
4177 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
4178 | ||
4179 | =item BUGS | |
4180 | ||
4181 | =item SEE ALSO | |
4182 | ||
4183 | =head2 CGI::Apache - Make things work with CGI.pm against Perl-Apache API | |
4184 | ||
4185 | =item SYNOPSIS | |
4186 | ||
4187 | =item DESCRIPTION | |
4188 | ||
137443ea | 4189 | =item NOTE 1 |
4190 | ||
4191 | =item NOTE 2 | |
54310121 | 4192 | |
4193 | =item SEE ALSO | |
4194 | ||
4195 | =item AUTHOR | |
4196 | ||
4197 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
4198 | other) error log | |
4199 | ||
4200 | =item SYNOPSIS | |
4201 | ||
4202 | =item DESCRIPTION | |
4203 | ||
4204 | =item REDIRECTING ERROR MESSAGES | |
4205 | ||
4206 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
4207 | ||
fb9cefb4 GS |
4208 | =over |
4209 | ||
4210 | =item Changing the default message | |
4211 | ||
4212 | =back | |
4213 | ||
54310121 | 4214 | =item CHANGE LOG |
4215 | ||
4216 | =item AUTHORS | |
4217 | ||
4218 | =item SEE ALSO | |
4219 | ||
fb9cefb4 GS |
4220 | =head2 CGI::Cookie - Interface to Netscape Cookies |
4221 | ||
4222 | =item SYNOPSIS | |
4223 | ||
4224 | =item DESCRIPTION | |
4225 | ||
4226 | =item USING CGI::Cookie | |
4227 | ||
4228 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
4229 | ||
4230 | =over | |
4231 | ||
4232 | =item Creating New Cookies | |
4233 | ||
4234 | =item Sending the Cookie to the Browser | |
4235 | ||
4236 | =item Recovering Previous Cookies | |
4237 | ||
4238 | =item Manipulating Cookies | |
4239 | ||
4240 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
4241 | ||
4242 | =back | |
4243 | ||
4244 | =item AUTHOR INFORMATION | |
4245 | ||
4246 | =item BUGS | |
4247 | ||
4248 | =item SEE ALSO | |
4249 | ||
54310121 | 4250 | =head2 CGI::Fast - CGI Interface for Fast CGI |
4251 | ||
4252 | =item SYNOPSIS | |
4253 | ||
4254 | =item DESCRIPTION | |
4255 | ||
4256 | =item OTHER PIECES OF THE PUZZLE | |
4257 | ||
4258 | =item WRITING FASTCGI PERL SCRIPTS | |
4259 | ||
4260 | =item INSTALLING FASTCGI SCRIPTS | |
4261 | ||
4262 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
4263 | ||
4264 | =item CAVEATS | |
4265 | ||
4266 | =item AUTHOR INFORMATION | |
4267 | ||
4268 | =item BUGS | |
4269 | ||
4270 | =item SEE ALSO | |
4271 | ||
4272 | =head2 CGI::Push - Simple Interface to Server Push | |
4273 | ||
4274 | =item SYNOPSIS | |
4275 | ||
4276 | =item DESCRIPTION | |
4277 | ||
4278 | =item USING CGI::Push | |
4279 | ||
d516a115 | 4280 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires |
54310121 | 4281 | |
fb9cefb4 GS |
4282 | =over |
4283 | ||
4284 | =item Heterogeneous Pages | |
4285 | ||
4286 | =item Changing the Page Delay on the Fly | |
4287 | ||
4288 | =back | |
4289 | ||
54310121 | 4290 | =item INSTALLING CGI::Push SCRIPTS |
4291 | ||
54310121 | 4292 | =item AUTHOR INFORMATION |
4293 | ||
4294 | =item BUGS | |
4295 | ||
4296 | =item SEE ALSO | |
4297 | ||
4298 | =head2 CGI::Switch - Try more than one constructors and return the first | |
4299 | object available | |
4300 | ||
4301 | =item SYNOPSIS | |
4302 | ||
4303 | =item DESCRIPTION | |
4304 | ||
4305 | =item SEE ALSO | |
4306 | ||
4307 | =item AUTHOR | |
4308 | ||
8ebc5c01 | 4309 | =head2 CPAN - query, download and build perl modules from CPAN sites |
cb1a09d0 | 4310 | |
8ebc5c01 | 4311 | =item SYNOPSIS |
cb1a09d0 | 4312 | |
8ebc5c01 | 4313 | =item DESCRIPTION |
cb1a09d0 AD |
4314 | |
4315 | =over | |
4316 | ||
8ebc5c01 | 4317 | =item Interactive Mode |
cb1a09d0 | 4318 | |
8ebc5c01 | 4319 | Searching for authors, bundles, distribution files and modules, make, test, |
774d564b | 4320 | install, clean modules or distributions, readme, look module or |
fb9cefb4 | 4321 | distribution, Signals |
cb1a09d0 | 4322 | |
8ebc5c01 | 4323 | =item CPAN::Shell |
cb1a09d0 | 4324 | |
774d564b | 4325 | =item autobundle |
4326 | ||
4327 | =item recompile | |
4328 | ||
d516a115 | 4329 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
dc848c6f | 4330 | |
8ebc5c01 | 4331 | =item ProgrammerE<39>s interface |
cb1a09d0 | 4332 | |
dc848c6f | 4333 | expand($type,@things), Programming Examples |
4334 | ||
14218588 | 4335 | =item Methods in the four Classes |
d516a115 | 4336 | |
8ebc5c01 | 4337 | =item Cache Manager |
cb1a09d0 | 4338 | |
8ebc5c01 | 4339 | =item Bundles |
cb1a09d0 | 4340 | |
774d564b | 4341 | =item Prerequisites |
cb1a09d0 | 4342 | |
fb9cefb4 GS |
4343 | =item Finding packages and VERSION |
4344 | ||
774d564b | 4345 | =item Debugging |
4346 | ||
14218588 | 4347 | =item Floppy, Zip, Offline Mode |
cb1a09d0 AD |
4348 | |
4349 | =back | |
4350 | ||
8ebc5c01 | 4351 | =item CONFIGURATION |
cb1a09d0 | 4352 | |
8ebc5c01 | 4353 | o conf E<lt>scalar optionE<gt>, o conf E<lt>scalar optionE<gt> |
4354 | E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt> | |
4355 | [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice] | |
4356 | E<lt>listE<gt> | |
cb1a09d0 | 4357 | |
d516a115 JH |
4358 | =over |
4359 | ||
14218588 GS |
4360 | =item Note on urllist parameter's format |
4361 | ||
4362 | =item urllist parameter has CD-ROM support | |
d516a115 JH |
4363 | |
4364 | =back | |
4365 | ||
8ebc5c01 | 4366 | =item SECURITY |
cb1a09d0 | 4367 | |
8ebc5c01 | 4368 | =item EXPORT |
cb1a09d0 | 4369 | |
14218588 GS |
4370 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
4371 | ||
4372 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
4373 | ||
4374 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade | |
4375 | ||
774d564b | 4376 | =item BUGS |
cb1a09d0 AD |
4377 | |
4378 | =item AUTHOR | |
4379 | ||
8ebc5c01 | 4380 | =item SEE ALSO |
cb1a09d0 | 4381 | |
8ebc5c01 | 4382 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
cb1a09d0 AD |
4383 | |
4384 | =item SYNOPSIS | |
4385 | ||
cb1a09d0 AD |
4386 | =item DESCRIPTION |
4387 | ||
8ebc5c01 | 4388 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
4389 | module | |
cb1a09d0 AD |
4390 | |
4391 | =item SYNOPSIS | |
4392 | ||
cb1a09d0 AD |
4393 | =item DESCRIPTION |
4394 | ||
8ebc5c01 | 4395 | =item SEE ALSO |
cb1a09d0 | 4396 | |
d516a115 | 4397 | =head2 Carp, carp - warn of errors (from perspective of caller) |
cb1a09d0 | 4398 | |
8ebc5c01 | 4399 | =item SYNOPSIS |
cb1a09d0 | 4400 | |
8ebc5c01 | 4401 | =item DESCRIPTION |
cb1a09d0 | 4402 | |
d516a115 JH |
4403 | =over |
4404 | ||
4405 | =item Forcing a Stack Trace | |
4406 | ||
4407 | =back | |
4408 | ||
14218588 GS |
4409 | =item BUGS |
4410 | ||
8cc95fdb | 4411 | =head2 Class::Struct - declare struct-like datatypes as Perl classes |
cb1a09d0 AD |
4412 | |
4413 | =item SYNOPSIS | |
4414 | ||
cb1a09d0 AD |
4415 | =item DESCRIPTION |
4416 | ||
8cc95fdb | 4417 | =over |
4418 | ||
4419 | =item The C<struct()> function | |
4420 | ||
4421 | =item Element Types and Accessor Methods | |
4422 | ||
4423 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
4424 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
4425 | ||
a10cf691 GS |
4426 | =item Initializing with C<new> |
4427 | ||
8cc95fdb | 4428 | =back |
4429 | ||
8ebc5c01 | 4430 | =item EXAMPLES |
cb1a09d0 | 4431 | |
a10cf691 | 4432 | Example 1, Example 2, Example 3 |
cb1a09d0 | 4433 | |
8cc95fdb | 4434 | =item Author and Modification History |
cb1a09d0 | 4435 | |
14218588 GS |
4436 | =head2 Config - access Perl configuration information |
4437 | ||
4438 | =item SYNOPSIS | |
4439 | ||
4440 | =item DESCRIPTION | |
4441 | ||
4442 | myconfig(), config_sh(), config_vars(@names) | |
4443 | ||
4444 | =item EXAMPLE | |
4445 | ||
4446 | =item WARNING | |
4447 | ||
4448 | =item GLOSSARY | |
4449 | ||
4450 | =over | |
4451 | ||
4452 | =item _ | |
4453 | ||
4454 | C<_a>, C<_exe>, C<_o> | |
4455 | ||
4456 | =item a | |
4457 | ||
4458 | C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<apiversion>, C<ar>, | |
4459 | C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk> | |
4460 | ||
4461 | =item b | |
4462 | ||
4463 | C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> | |
4464 | ||
4465 | =item c | |
4466 | ||
4467 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
4468 | C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>, | |
4469 | C<chown>, C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, | |
4470 | C<cpp>, C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, | |
4471 | C<cppminus>, C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crosscompile>, | |
4472 | C<cryptlib>, C<csh> | |
4473 | ||
4474 | =item d | |
4475 | ||
4476 | C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_attribut>, | |
4477 | C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, | |
4478 | C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, | |
4479 | C<d_chroot>, C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, | |
4480 | C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbmclose64>, | |
4481 | C<d_dbminit64>, C<d_delete64>, C<d_difftime>, C<d_dirent64_s>, | |
4482 | C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, | |
4483 | C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>, | |
4484 | C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>, | |
4485 | C<d_eunice>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fd_macros>, | |
4486 | C<d_fd_set>, C<d_fds_bits>, C<d_fetch64>, C<d_fgetpos64>, C<d_fgetpos>, | |
4487 | C<d_firstkey64>, C<d_flexfnam>, C<d_flock64_s>, C<d_flock>, C<d_fopen64>, | |
4488 | C<d_fork>, C<d_fpathconf>, C<d_freopen64>, C<d_fseek64>, C<d_fseeko64>, | |
4489 | C<d_fseeko>, C<d_fsetpos64>, C<d_fsetpos>, C<d_fstat64>, C<d_fstatfs>, | |
4490 | C<d_fstatvfs>, C<d_ftell64>, C<d_ftello64>, C<d_ftello>, C<d_ftime>, | |
4491 | C<d_ftruncate64>, C<d_Gconvert>, C<d_getgrent>, C<d_getgrps>, | |
4492 | C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, | |
4493 | C<d_gethostprotos>, C<d_getlogin>, C<d_getmntent>, C<d_getnbyaddr>, | |
4494 | C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpbyname>, | |
4495 | C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, | |
4496 | C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getpwent>, | |
4497 | C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, | |
4498 | C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, | |
4499 | C<d_index>, C<d_inetaton>, C<d_ino64_t>, C<d_int64t>, C<d_iovec_s>, | |
4500 | C<d_isascii>, C<d_killpg>, C<d_lchown>, C<d_link>, C<d_llseek>, | |
4501 | C<d_locconv>, C<d_lockf64>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, | |
4502 | C<d_lseek64>, C<d_lstat64>, C<d_lstat>, C<d_madvise>, C<d_mblen>, | |
4503 | C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, | |
4504 | C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkfifo>, C<d_mktime>, C<d_mmap>, | |
4505 | C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, | |
4506 | C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, | |
4507 | C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, | |
4508 | C<d_nextkey64>, C<d_nice>, C<d_off64_t>, C<d_offset_t>, | |
4509 | C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>, | |
4510 | C<d_open3>, C<d_open64>, C<d_opendir64>, C<d_pathconf>, C<d_pause>, | |
4511 | C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_pthread_yield>, | |
4512 | C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, | |
4513 | C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_readdir64>, C<d_readdir>, | |
4514 | C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, | |
4515 | C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>, | |
4516 | C<d_scm_rights>, C<d_seekdir64>, C<d_seekdir>, C<d_select>, C<d_sem>, | |
4517 | C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, | |
4518 | C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, | |
4519 | C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, | |
4520 | C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, | |
4521 | C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>, | |
4522 | C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>, | |
4523 | C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, | |
4524 | C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>, | |
4525 | C<d_socket>, C<d_sockpair>, C<d_stat64>, C<d_statblks>, C<d_statfs>, | |
4526 | C<d_statfsflags>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, | |
4527 | C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_store64>, | |
4528 | C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, | |
4529 | C<d_strtod>, C<d_strtol>, C<d_strtoul>, C<d_strxfrm>, C<d_suidsafe>, | |
4530 | C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, | |
4531 | C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir64>, C<d_telldir>, | |
4532 | C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tmpfile64>, C<d_truncate64>, | |
4533 | C<d_truncate>, C<d_tzname>, C<d_umask>, C<d_uname>, C<d_union_semun>, | |
4534 | C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>, | |
4535 | C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, | |
4536 | C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>, | |
4537 | C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>, | |
4538 | C<drand01>, C<dynamic_ext> | |
4539 | ||
4540 | =item e | |
4541 | ||
4542 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>, | |
4543 | C<exe_ext>, C<expr>, C<extensions> | |
4544 | ||
4545 | =item f | |
4546 | ||
4547 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
4548 | C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed> | |
4549 | ||
4550 | =item g | |
4551 | ||
4552 | C<gccversion>, C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, | |
4553 | C<gzip> | |
4554 | ||
4555 | =item h | |
4556 | ||
4557 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge> | |
4558 | ||
4559 | =item i | |
4560 | ||
4561 | C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>, C<i_dirent>, C<i_dld>, | |
4562 | C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>, C<i_grp>, C<i_inttypes>, | |
4563 | C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>, | |
4564 | C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>, | |
4565 | C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_pthread>, C<i_pwd>, | |
4566 | C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_stdarg>, C<i_stddef>, | |
4567 | C<i_stdlib>, C<i_string>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, | |
4568 | C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_sysmman>, C<i_sysmount>, | |
4569 | C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>, | |
4570 | C<i_syssockio>, C<i_sysstat>, C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, | |
4571 | C<i_systimes>, C<i_systypes>, C<i_sysuio>, C<i_sysun>, C<i_syswait>, | |
4572 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_utime>, C<i_values>, | |
4573 | C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>, | |
4574 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>, | |
4575 | C<installman3dir>, C<installprivlib>, C<installscript>, C<installsitearch>, | |
4576 | C<installsitelib>, C<installusrbinperl>, C<intsize> | |
4577 | ||
4578 | =item k | |
4579 | ||
4580 | C<known_extensions>, C<ksh> | |
4581 | ||
4582 | =item l | |
4583 | ||
4584 | C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<less>, C<lib_ext>, C<libc>, | |
4585 | C<libperl>, C<libpth>, C<libs>, C<libswanted>, C<line>, C<lint>, | |
4586 | C<lkflags>, C<ln>, C<lns>, C<locincpth>, C<loclibpth>, C<longdblsize>, | |
4587 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, | |
4588 | C<lseektype> | |
4589 | ||
4590 | =item m | |
4591 | ||
4592 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
4593 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
4594 | C<man3direxp>, C<man3ext> | |
4595 | ||
4596 | =item M | |
4597 | ||
4598 | C<Mcc>, C<medium>, C<mips_type>, C<mkdir>, C<mmaptype>, C<models>, | |
4599 | C<modetype>, C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, | |
4600 | C<myhostname>, C<myuname> | |
4601 | ||
4602 | =item n | |
4603 | ||
4604 | C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>, | |
4605 | C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff> | |
4606 | ||
4607 | =item o | |
4608 | ||
4609 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
4610 | C<orderlib>, C<osname>, C<osvers> | |
4611 | ||
4612 | =item p | |
4613 | ||
4614 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>, | |
4615 | C<perladmin>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, | |
4616 | C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, | |
4617 | C<prototype>, C<ptrsize> | |
4618 | ||
4619 | =item r | |
4620 | ||
4621 | C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, C<rm>, | |
4622 | C<rmail>, C<runnm> | |
4623 | ||
4624 | =item s | |
4625 | ||
4626 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
4627 | C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>, | |
4628 | C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>, | |
4629 | C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>, | |
4630 | C<sitearch>, C<sitearchexp>, C<sitelib>, C<sitelibexp>, C<sizetype>, | |
4631 | C<sleep>, C<smail>, C<small>, C<so>, C<sockethdr>, C<socketlib>, C<sort>, | |
4632 | C<spackage>, C<spitshell>, C<split>, C<src>, C<ssizetype>, C<startperl>, | |
4633 | C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, | |
4634 | C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>, | |
4635 | C<strings>, C<submit>, C<subversion>, C<sysman> | |
4636 | ||
4637 | =item t | |
4638 | ||
4639 | C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>, | |
4640 | C<touch>, C<tr>, C<trnl>, C<troff> | |
4641 | ||
4642 | =item u | |
4643 | ||
4644 | C<uidtype>, C<uname>, C<uniq>, C<use64bits>, C<usedl>, C<usemultiplicity>, | |
4645 | C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, | |
4646 | C<usesfio>, C<useshrplib>, C<usethreads>, C<usevfork>, C<usrinc>, C<uuname> | |
4647 | ||
4648 | =item v | |
4649 | ||
4650 | C<version>, C<vi>, C<voidflags> | |
4651 | ||
4652 | =item x | |
4653 | ||
4654 | C<xlibpth> | |
4655 | ||
4656 | =item z | |
4657 | ||
4658 | C<zcat>, C<zip> | |
4659 | ||
4660 | =back | |
4661 | ||
4662 | =item NOTE | |
4663 | ||
8ebc5c01 | 4664 | =head2 Cwd, getcwd - get pathname of current working directory |
cb1a09d0 | 4665 | |
8ebc5c01 | 4666 | =item SYNOPSIS |
cb1a09d0 | 4667 | |
8ebc5c01 | 4668 | =item DESCRIPTION |
cb1a09d0 | 4669 | |
14218588 GS |
4670 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
4671 | subject to | |
4672 | change) | |
4673 | ||
4674 | =item SYNOPSIS | |
4675 | ||
4676 | =item DESCRIPTION | |
4677 | ||
4678 | =over | |
4679 | ||
4680 | =item Global Variables | |
4681 | ||
4682 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
4683 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
4684 | $DB::lineno | |
4685 | ||
4686 | =item API Methods | |
4687 | ||
4688 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
4689 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
4690 | ||
4691 | =item Client Callback Methods | |
4692 | ||
4693 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
4694 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
4695 | CLIENT->output(LIST) | |
4696 | ||
4697 | =back | |
4698 | ||
4699 | =item BUGS | |
4700 | ||
4701 | =item AUTHOR | |
4702 | ||
d516a115 | 4703 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
cb1a09d0 AD |
4704 | |
4705 | =item SYNOPSIS | |
4706 | ||
cb1a09d0 AD |
4707 | =item DESCRIPTION |
4708 | ||
8ebc5c01 | 4709 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
cb1a09d0 AD |
4710 | |
4711 | =over | |
4712 | ||
d516a115 JH |
4713 | =item Using DB_File with Berkeley DB version 2 |
4714 | ||
68dc0745 | 4715 | =item Interface to Berkeley DB |
cb1a09d0 | 4716 | |
8ebc5c01 | 4717 | =item Opening a Berkeley DB Database File |
cb1a09d0 | 4718 | |
8ebc5c01 | 4719 | =item Default Parameters |
cb1a09d0 | 4720 | |
8ebc5c01 | 4721 | =item In Memory Databases |
cb1a09d0 AD |
4722 | |
4723 | =back | |
4724 | ||
8ebc5c01 | 4725 | =item DB_HASH |
cb1a09d0 | 4726 | |
8ebc5c01 | 4727 | =over |
cb1a09d0 | 4728 | |
68dc0745 | 4729 | =item A Simple Example |
cb1a09d0 | 4730 | |
8ebc5c01 | 4731 | =back |
cb1a09d0 | 4732 | |
8ebc5c01 | 4733 | =item DB_BTREE |
cb1a09d0 | 4734 | |
8ebc5c01 | 4735 | =over |
cb1a09d0 | 4736 | |
8ebc5c01 | 4737 | =item Changing the BTREE sort order |
cb1a09d0 | 4738 | |
68dc0745 | 4739 | =item Handling Duplicate Keys |
cb1a09d0 | 4740 | |
68dc0745 | 4741 | =item The get_dup() Method |
cb1a09d0 | 4742 | |
14218588 GS |
4743 | =item The find_dup() Method |
4744 | ||
4745 | =item The del_dup() Method | |
4746 | ||
8ebc5c01 | 4747 | =item Matching Partial Keys |
cb1a09d0 | 4748 | |
8ebc5c01 | 4749 | =back |
cb1a09d0 | 4750 | |
8ebc5c01 | 4751 | =item DB_RECNO |
cb1a09d0 | 4752 | |
8ebc5c01 | 4753 | =over |
cb1a09d0 | 4754 | |
68dc0745 | 4755 | =item The 'bval' Option |
cb1a09d0 | 4756 | |
8ebc5c01 | 4757 | =item A Simple Example |
cb1a09d0 | 4758 | |
14218588 | 4759 | =item Extra RECNO Methods |
cb1a09d0 | 4760 | |
8ebc5c01 | 4761 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
4762 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length> | |
cb1a09d0 | 4763 | |
8ebc5c01 | 4764 | =item Another Example |
cb1a09d0 | 4765 | |
8ebc5c01 | 4766 | =back |
cb1a09d0 | 4767 | |
8ebc5c01 | 4768 | =item THE API INTERFACE |
cb1a09d0 | 4769 | |
8ebc5c01 | 4770 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
4771 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
4772 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
4773 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
cb1a09d0 | 4774 | |
8ebc5c01 | 4775 | =item HINTS AND TIPS |
cb1a09d0 | 4776 | |
8ebc5c01 | 4777 | =over |
4778 | ||
4779 | =item Locking Databases | |
cb1a09d0 | 4780 | |
68dc0745 | 4781 | =item Sharing Databases With C Applications |
cb1a09d0 | 4782 | |
68dc0745 | 4783 | =item The untie() Gotcha |
4fdae800 | 4784 | |
8ebc5c01 | 4785 | =back |
cb1a09d0 | 4786 | |
8ebc5c01 | 4787 | =item COMMON QUESTIONS |
cb1a09d0 AD |
4788 | |
4789 | =over | |
4790 | ||
8ebc5c01 | 4791 | =item Why is there Perl source in my database? |
cb1a09d0 | 4792 | |
8ebc5c01 | 4793 | =item How do I store complex data structures with DB_File? |
cb1a09d0 | 4794 | |
8ebc5c01 | 4795 | =item What does "Invalid Argument" mean? |
cb1a09d0 | 4796 | |
8ebc5c01 | 4797 | =item What does "Bareword 'DB_File' not allowed" mean? |
cb1a09d0 | 4798 | |
8ebc5c01 | 4799 | =back |
cb1a09d0 | 4800 | |
8ebc5c01 | 4801 | =item HISTORY |
cb1a09d0 | 4802 | |
8ebc5c01 | 4803 | =item BUGS |
cb1a09d0 | 4804 | |
8ebc5c01 | 4805 | =item AVAILABILITY |
cb1a09d0 | 4806 | |
d516a115 JH |
4807 | =item COPYRIGHT |
4808 | ||
8ebc5c01 | 4809 | =item SEE ALSO |
cb1a09d0 | 4810 | |
8ebc5c01 | 4811 | =item AUTHOR |
cb1a09d0 | 4812 | |
fb9cefb4 GS |
4813 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
4814 | printing and C<eval> | |
4815 | ||
4816 | =item SYNOPSIS | |
4817 | ||
4818 | =item DESCRIPTION | |
4819 | ||
4820 | =over | |
4821 | ||
4822 | =item Methods | |
4823 | ||
14218588 GS |
4824 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
4825 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs I<or> | |
fb9cefb4 GS |
4826 | I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>), |
4827 | I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>), | |
4828 | I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset | |
4829 | ||
4830 | =item Functions | |
4831 | ||
4832 | Dumper(I<LIST>), DumperX(I<LIST>) | |
4833 | ||
4834 | =item Configuration Variables or Methods | |
4835 | ||
4836 | $Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>), | |
4837 | $Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>), | |
4838 | $Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>), | |
4839 | $Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>), | |
4840 | $Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>), | |
4841 | $Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>), | |
4842 | $Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>), | |
4843 | $Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>), | |
4844 | $Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>), | |
4845 | $Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>), | |
4846 | $Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>) | |
4847 | ||
4848 | =item Exports | |
4849 | ||
4850 | Dumper | |
4851 | ||
4852 | =back | |
4853 | ||
4854 | =item EXAMPLES | |
4855 | ||
4856 | =item BUGS | |
4857 | ||
4858 | =item AUTHOR | |
4859 | ||
4860 | =item VERSION | |
4861 | ||
4862 | =item SEE ALSO | |
4863 | ||
14218588 GS |
4864 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
4865 | ||
4866 | =item SYNOPSIS | |
4867 | ||
4868 | =item DESCRIPTION | |
4869 | ||
4870 | =item EXAMPLES | |
4871 | ||
4872 | =over | |
4873 | ||
4874 | =item A simple scalar string | |
4875 | ||
4876 | =item A simple scalar number | |
4877 | ||
4878 | =item A simple scalar with an extra reference | |
4879 | ||
4880 | =item A reference to a simple scalar | |
4881 | ||
4882 | =item A reference to an array | |
4883 | ||
4884 | =item A reference to a hash | |
4885 | ||
4886 | =item Dumping a large array or hash | |
4887 | ||
4888 | =item A reference to an SV which holds a C pointer | |
4889 | ||
4890 | =item A reference to a subroutine | |
4891 | ||
4892 | =back | |
4893 | ||
4894 | =item EXPORTS | |
4895 | ||
4896 | =item BUGS | |
4897 | ||
4898 | =item AUTHOR | |
4899 | ||
4900 | =item SEE ALSO | |
4901 | ||
8ebc5c01 | 4902 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
cb1a09d0 | 4903 | |
8ebc5c01 | 4904 | =item SYNOPSIS |
cb1a09d0 | 4905 | |
8ebc5c01 | 4906 | =item DESCRIPTION |
cb1a09d0 | 4907 | |
8ebc5c01 | 4908 | =head2 DirHandle - supply object methods for directory handles |
cb1a09d0 | 4909 | |
8ebc5c01 | 4910 | =item SYNOPSIS |
cb1a09d0 | 4911 | |
8ebc5c01 | 4912 | =item DESCRIPTION |
cb1a09d0 | 4913 | |
14218588 GS |
4914 | =head2 Dumpvalue - provides screen dump of Perl data. |
4915 | ||
4916 | =item SYNOPSYS | |
4917 | ||
4918 | =item DESCRIPTION | |
4919 | ||
4920 | =over | |
4921 | ||
4922 | =item Creation | |
4923 | ||
4924 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
4925 | C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>, | |
4926 | C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
4927 | stopDbSignal | |
4928 | ||
4929 | =item Methods | |
4930 | ||
4931 | dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump, | |
4932 | veryCompact, set, get | |
4933 | ||
4934 | =back | |
4935 | ||
4936 | =head2 DynaLoader - Dynamically load C libraries into Perl code | |
4937 | ||
4938 | =item SYNOPSIS | |
4939 | ||
4940 | =item DESCRIPTION | |
4941 | ||
4942 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
4943 | @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), | |
4944 | dl_load_file(), dl_loadflags(), dl_find_symbol(), | |
4945 | dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), | |
4946 | bootstrap() | |
4947 | ||
4948 | =item AUTHOR | |
4949 | ||
8ebc5c01 | 4950 | =head2 English - use nice English (or awk) names for ugly punctuation |
4951 | variables | |
cb1a09d0 | 4952 | |
8ebc5c01 | 4953 | =item SYNOPSIS |
cb1a09d0 | 4954 | |
8ebc5c01 | 4955 | =item DESCRIPTION |
cb1a09d0 | 4956 | |
8ebc5c01 | 4957 | =head2 Env - perl module that imports environment variables |
cb1a09d0 AD |
4958 | |
4959 | =item SYNOPSIS | |
4960 | ||
cb1a09d0 AD |
4961 | =item DESCRIPTION |
4962 | ||
8ebc5c01 | 4963 | =item AUTHOR |
cb1a09d0 | 4964 | |
14218588 GS |
4965 | =head2 Errno - System errno constants |
4966 | ||
4967 | =item SYNOPSIS | |
4968 | ||
4969 | =item DESCRIPTION | |
4970 | ||
4971 | =item AUTHOR | |
4972 | ||
4973 | =item COPYRIGHT | |
4974 | ||
8ebc5c01 | 4975 | =head2 Exporter - Implements default import method for modules |
cb1a09d0 | 4976 | |
8ebc5c01 | 4977 | =item SYNOPSIS |
cb1a09d0 | 4978 | |
8ebc5c01 | 4979 | =item DESCRIPTION |
cb1a09d0 | 4980 | |
8ebc5c01 | 4981 | =over |
cb1a09d0 | 4982 | |
8ebc5c01 | 4983 | =item Selecting What To Export |
cb1a09d0 | 4984 | |
8ebc5c01 | 4985 | =item Specialised Import Lists |
cb1a09d0 | 4986 | |
d516a115 JH |
4987 | =item Exporting without using Export's import method |
4988 | ||
8ebc5c01 | 4989 | =item Module Version Checking |
cb1a09d0 | 4990 | |
8ebc5c01 | 4991 | =item Managing Unknown Symbols |
cb1a09d0 | 4992 | |
8ebc5c01 | 4993 | =item Tag Handling Utility Functions |
cb1a09d0 | 4994 | |
8ebc5c01 | 4995 | =back |
cb1a09d0 | 4996 | |
68dc0745 | 4997 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
4998 | Makefiles etc. | |
4999 | ||
dc848c6f | 5000 | =item SYNOPSIS |
68dc0745 | 5001 | |
5002 | =item DESCRIPTION | |
5003 | ||
5004 | cat, eqtime src dst, rm_f files..., rm_f files..., touch files .., mv | |
5005 | source... destination, cp source... destination, chmod mode files.., mkpath | |
5006 | directory.., test_f file | |
5007 | ||
5008 | =item BUGS | |
5009 | ||
5010 | =item SEE ALSO | |
5011 | ||
5012 | =item AUTHOR | |
5013 | ||
8ebc5c01 | 5014 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
cb1a09d0 AD |
5015 | |
5016 | =item SYNOPSIS | |
5017 | ||
cb1a09d0 AD |
5018 | =item DESCRIPTION |
5019 | ||
8ebc5c01 | 5020 | =item @EXPORT |
cb1a09d0 | 5021 | |
8ebc5c01 | 5022 | =item FUNCTIONS |
cb1a09d0 | 5023 | |
8ebc5c01 | 5024 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
5025 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
cb1a09d0 | 5026 | |
8ebc5c01 | 5027 | =item EXAMPLES |
cb1a09d0 | 5028 | |
8ebc5c01 | 5029 | =item SEE ALSO |
cb1a09d0 | 5030 | |
8ebc5c01 | 5031 | =item AUTHOR |
cb1a09d0 | 5032 | |
8ebc5c01 | 5033 | =head2 ExtUtils::Install - install files from here to there |
cb1a09d0 | 5034 | |
8ebc5c01 | 5035 | =item SYNOPSIS |
cb1a09d0 | 5036 | |
8ebc5c01 | 5037 | =item DESCRIPTION |
cb1a09d0 | 5038 | |
193fb0af GS |
5039 | =head2 ExtUtils::Installed - Inventory management of installed modules |
5040 | ||
5041 | =item SYNOPSIS | |
5042 | ||
5043 | =item DESCRIPTION | |
5044 | ||
5045 | =item USAGE | |
5046 | ||
5047 | =item FUNCTIONS | |
5048 | ||
5049 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
5050 | packlist(), version() | |
5051 | ||
fb9cefb4 GS |
5052 | =item EXAMPLE |
5053 | ||
193fb0af GS |
5054 | =item AUTHOR |
5055 | ||
8ebc5c01 | 5056 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
cb1a09d0 | 5057 | |
8ebc5c01 | 5058 | =item SYNOPSIS |
cb1a09d0 | 5059 | |
8ebc5c01 | 5060 | =item DESCRIPTION |
cb1a09d0 | 5061 | |
8ebc5c01 | 5062 | For static extensions, For dynamic extensions, For dynamic extensions |
cb1a09d0 | 5063 | |
8ebc5c01 | 5064 | =over |
cb1a09d0 | 5065 | |
8ebc5c01 | 5066 | =item EXTRALIBS |
cb1a09d0 | 5067 | |
8ebc5c01 | 5068 | =item LDLOADLIBS and LD_RUN_PATH |
cb1a09d0 | 5069 | |
8ebc5c01 | 5070 | =item BSLOADLIBS |
cb1a09d0 | 5071 | |
8ebc5c01 | 5072 | =back |
cb1a09d0 | 5073 | |
8ebc5c01 | 5074 | =item PORTABILITY |
cb1a09d0 AD |
5075 | |
5076 | =over | |
5077 | ||
8ebc5c01 | 5078 | =item VMS implementation |
cb1a09d0 | 5079 | |
3e3baf6d TB |
5080 | =item Win32 implementation |
5081 | ||
8ebc5c01 | 5082 | =back |
cb1a09d0 | 5083 | |
8ebc5c01 | 5084 | =item SEE ALSO |
cb1a09d0 | 5085 | |
14218588 GS |
5086 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
5087 | ExtUtils::MakeMaker | |
5088 | ||
5089 | =item SYNOPSIS | |
5090 | ||
5091 | =item DESCRIPTION | |
5092 | ||
5093 | canonpath, cflags, manifypods, perl_archive | |
5094 | ||
8ebc5c01 | 5095 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
5096 | ExtUtils::MakeMaker | |
cb1a09d0 | 5097 | |
8ebc5c01 | 5098 | =item SYNOPSIS |
cb1a09d0 | 5099 | |
8ebc5c01 | 5100 | =item DESCRIPTION |
cb1a09d0 | 5101 | |
8ebc5c01 | 5102 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
cb1a09d0 | 5103 | |
8ebc5c01 | 5104 | =item SYNOPSIS |
cb1a09d0 | 5105 | |
8ebc5c01 | 5106 | =item DESCRIPTION |
cb1a09d0 | 5107 | |
8ebc5c01 | 5108 | =item METHODS |
cb1a09d0 | 5109 | |
8ebc5c01 | 5110 | =over |
cb1a09d0 | 5111 | |
8ebc5c01 | 5112 | =item Preloaded methods |
cb1a09d0 | 5113 | |
8ebc5c01 | 5114 | canonpath, catdir, catfile, curdir, rootdir, updir |
cb1a09d0 | 5115 | |
8ebc5c01 | 5116 | =item SelfLoaded methods |
cb1a09d0 | 5117 | |
8ebc5c01 | 5118 | c_o (o), cflags (o), clean (o), const_cccmd (o), const_config (o), |
5119 | const_loadlibs (o), constants (o), depend (o), dir_target (o), dist (o), | |
5120 | dist_basics (o), dist_ci (o), dist_core (o), dist_dir (o), dist_test (o), | |
5121 | dlsyms (o), dynamic (o), dynamic_bs (o), dynamic_lib (o), exescan, | |
5122 | extliblist, file_name_is_absolute, find_perl | |
5123 | ||
5124 | =item Methods to actually produce chunks of text for the Makefile | |
5125 | ||
d516a115 JH |
5126 | fixin, force (o), guess_name, has_link_code, init_dirscan, init_main, |
5127 | init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir, | |
5128 | macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command, | |
fb9cefb4 GS |
5129 | maybe_command_in_dirs, needs_linking (o), nicetext, parse_version, |
5130 | parse_abstract, pasthru (o), path, perl_script, perldepend (o), ppd, | |
5131 | perm_rw (o), perm_rwx (o), pm_to_blib, post_constants (o), post_initialize | |
5132 | (o), postamble (o), prefixify, processPL (o), realclean (o), | |
5133 | replace_manpage_separator, static (o), static_lib (o), staticmake (o), | |
8ebc5c01 | 5134 | subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script |
5135 | (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o), | |
14218588 | 5136 | writedoc, xs_c (o), xs_cpp (o), xs_o (o), perl_archive, export_list |
cb1a09d0 | 5137 | |
8ebc5c01 | 5138 | =back |
cb1a09d0 | 5139 | |
8ebc5c01 | 5140 | =item SEE ALSO |
cb1a09d0 | 5141 | |
8ebc5c01 | 5142 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in |
5143 | ExtUtils::MakeMaker | |
cb1a09d0 | 5144 | |
8ebc5c01 | 5145 | =item SYNOPSIS |
cb1a09d0 | 5146 | |
8ebc5c01 | 5147 | =item DESCRIPTION |
cb1a09d0 | 5148 | |
8ebc5c01 | 5149 | =over |
cb1a09d0 | 5150 | |
8ebc5c01 | 5151 | =item Methods always loaded |
cb1a09d0 | 5152 | |
8ebc5c01 | 5153 | eliminate_macros, fixpath, catdir, catfile, wraplist, curdir (override), |
5154 | rootdir (override), updir (override) | |
cb1a09d0 | 5155 | |
8ebc5c01 | 5156 | =item SelfLoaded methods |
cb1a09d0 | 5157 | |
8ebc5c01 | 5158 | guess_name (override), find_perl (override), path (override), maybe_command |
5159 | (override), maybe_command_in_dirs (override), perl_script (override), | |
5160 | file_name_is_absolute (override), replace_manpage_separator, init_others | |
5161 | (override), constants (override), cflags (override), const_cccmd | |
5162 | (override), pm_to_blib (override), tool_autosplit (override), tool_sxubpp | |
5163 | (override), xsubpp_version (override), tools_other (override), dist | |
5164 | (override), c_o (override), xs_c (override), xs_o (override), top_targets | |
5165 | (override), dlsyms (override), dynamic_lib (override), dynamic_bs | |
5166 | (override), static_lib (override), manifypods (override), processPL | |
5167 | (override), installbin (override), subdir_x (override), clean (override), | |
5168 | realclean (override), dist_basics (override), dist_core (override), | |
5169 | dist_dir (override), dist_test (override), install (override), perldepend | |
5170 | (override), makefile (override), test (override), test_via_harness | |
5171 | (override), test_via_script (override), makeaperl (override), nicetext | |
5172 | (override) | |
cb1a09d0 | 5173 | |
8ebc5c01 | 5174 | =back |
cb1a09d0 | 5175 | |
68dc0745 | 5176 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in |
5177 | ExtUtils::MakeMaker | |
5178 | ||
5179 | =item SYNOPSIS | |
5180 | ||
5181 | =item DESCRIPTION | |
5182 | ||
3e3baf6d TB |
5183 | catfile, constants (o), static_lib (o), dynamic_bs (o), dynamic_lib (o), |
5184 | canonpath, perl_script, pm_to_blib, test_via_harness (o), tool_autosplit | |
5185 | (override), tools_other (o), xs_o (o), top_targets (o), manifypods (o), | |
5186 | dist_ci (o), dist_core (o), pasthru (o) | |
68dc0745 | 5187 | |
8ebc5c01 | 5188 | =head2 ExtUtils::MakeMaker - create an extension Makefile |
cb1a09d0 AD |
5189 | |
5190 | =item SYNOPSIS | |
5191 | ||
cb1a09d0 AD |
5192 | =item DESCRIPTION |
5193 | ||
8ebc5c01 | 5194 | =over |
cb1a09d0 | 5195 | |
8ebc5c01 | 5196 | =item How To Write A Makefile.PL |
cb1a09d0 | 5197 | |
8ebc5c01 | 5198 | =item Default Makefile Behaviour |
cb1a09d0 | 5199 | |
8ebc5c01 | 5200 | =item make test |
cb1a09d0 | 5201 | |
8ebc5c01 | 5202 | =item make testdb |
7d2bfb28 | 5203 | |
8ebc5c01 | 5204 | =item make install |
7d2bfb28 | 5205 | |
8ebc5c01 | 5206 | =item PREFIX and LIB attribute |
7d2bfb28 | 5207 | |
8ebc5c01 | 5208 | =item AFS users |
7d2bfb28 | 5209 | |
8ebc5c01 | 5210 | =item Static Linking of a new Perl Binary |
7d2bfb28 | 5211 | |
8ebc5c01 | 5212 | =item Determination of Perl Library and Installation Locations |
7d2bfb28 | 5213 | |
8ebc5c01 | 5214 | =item Which architecture dependent directory? |
7d2bfb28 | 5215 | |
8ebc5c01 | 5216 | =item Using Attributes and Parameters |
cb1a09d0 | 5217 | |
14218588 GS |
5218 | AUTHOR, ABSTRACT, ABSTRACT_FROM, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG, |
5219 | CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, | |
5220 | EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, IMPORTS, INC, | |
8ebc5c01 | 5221 | INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, |
14218588 GS |
5222 | INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITEARCH, |
5223 | INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR, | |
5224 | INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, | |
8ebc5c01 | 5225 | MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, |
14218588 | 5226 | NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC, |
fb9cefb4 | 5227 | PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, |
14218588 GS |
5228 | PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, |
5229 | PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, | |
5230 | XS_VERSION | |
cb1a09d0 | 5231 | |
8ebc5c01 | 5232 | =item Additional lowercase attributes |
cb1a09d0 | 5233 | |
14218588 | 5234 | clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, |
8ebc5c01 | 5235 | tool_autosplit |
cb1a09d0 | 5236 | |
8ebc5c01 | 5237 | =item Overriding MakeMaker Methods |
cb1a09d0 | 5238 | |
8ebc5c01 | 5239 | =item Hintsfile support |
cb1a09d0 | 5240 | |
8ebc5c01 | 5241 | =item Distribution Support |
cb1a09d0 | 5242 | |
14218588 GS |
5243 | make distcheck, make skipcheck, make distclean, make manifest, |
5244 | make distdir, make tardist, make dist, make uutardist, make | |
8ebc5c01 | 5245 | shdist, make zipdist, make ci |
cb1a09d0 | 5246 | |
d516a115 JH |
5247 | =item Disabling an extension |
5248 | ||
8ebc5c01 | 5249 | =back |
cb1a09d0 | 5250 | |
14218588 GS |
5251 | =item ENVIRONMENT |
5252 | ||
5253 | PERL_MM_OPT | |
5254 | ||
8ebc5c01 | 5255 | =item SEE ALSO |
cb1a09d0 | 5256 | |
8ebc5c01 | 5257 | =item AUTHORS |
cb1a09d0 | 5258 | |
8ebc5c01 | 5259 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file |
cb1a09d0 AD |
5260 | |
5261 | =item SYNOPSIS | |
5262 | ||
cb1a09d0 AD |
5263 | =item DESCRIPTION |
5264 | ||
8ebc5c01 | 5265 | =item MANIFEST.SKIP |
cb1a09d0 | 5266 | |
8ebc5c01 | 5267 | =item EXPORT_OK |
cb1a09d0 | 5268 | |
8ebc5c01 | 5269 | =item GLOBAL VARIABLES |
cb1a09d0 | 5270 | |
8ebc5c01 | 5271 | =item DIAGNOSTICS |
cb1a09d0 | 5272 | |
8ebc5c01 | 5273 | C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>, |
5274 | C<Added to MANIFEST:> I<file> | |
cb1a09d0 | 5275 | |
8ebc5c01 | 5276 | =item SEE ALSO |
cb1a09d0 AD |
5277 | |
5278 | =item AUTHOR | |
5279 | ||
14218588 GS |
5280 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c |
5281 | ||
5282 | =item SYNOPSIS | |
5283 | ||
5284 | =item DESCRIPTION | |
5285 | ||
5286 | =item SEE ALSO | |
5287 | ||
8ebc5c01 | 5288 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader |
cb1a09d0 AD |
5289 | |
5290 | =item SYNOPSIS | |
5291 | ||
cb1a09d0 AD |
5292 | =item DESCRIPTION |
5293 | ||
8ebc5c01 | 5294 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic |
5295 | extension | |
cb1a09d0 | 5296 | |
8ebc5c01 | 5297 | =item SYNOPSIS |
cb1a09d0 | 5298 | |
8ebc5c01 | 5299 | =item DESCRIPTION |
402d0d99 | 5300 | |
14218588 | 5301 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME |
402d0d99 | 5302 | |
8ebc5c01 | 5303 | =item AUTHOR |
402d0d99 | 5304 | |
8ebc5c01 | 5305 | =item REVISION |
402d0d99 | 5306 | |
193fb0af GS |
5307 | =head2 ExtUtils::Packlist - manage .packlist files |
5308 | ||
5309 | =item SYNOPSIS | |
5310 | ||
5311 | =item DESCRIPTION | |
5312 | ||
5313 | =item USAGE | |
5314 | ||
5315 | =item FUNCTIONS | |
5316 | ||
5317 | new(), read(), write(), validate(), packlist_file() | |
5318 | ||
fb9cefb4 GS |
5319 | =item EXAMPLE |
5320 | ||
193fb0af GS |
5321 | =item AUTHOR |
5322 | ||
8ebc5c01 | 5323 | =head2 ExtUtils::testlib - add blib/* directories to @INC |
cb1a09d0 | 5324 | |
8ebc5c01 | 5325 | =item SYNOPSIS |
cb1a09d0 | 5326 | |
8ebc5c01 | 5327 | =item DESCRIPTION |
402d0d99 | 5328 | |
d516a115 JH |
5329 | =head2 Fatal - replace functions with equivalents which succeed or die |
5330 | ||
5331 | =item SYNOPSIS | |
5332 | ||
5333 | =item DESCRIPTION | |
5334 | ||
5335 | =item AUTHOR | |
5336 | ||
8ebc5c01 | 5337 | =head2 Fcntl - load the C Fcntl.h defines |
cb1a09d0 | 5338 | |
8ebc5c01 | 5339 | =item SYNOPSIS |
cb1a09d0 | 5340 | |
8ebc5c01 | 5341 | =item DESCRIPTION |
cb1a09d0 | 5342 | |
8ebc5c01 | 5343 | =item NOTE |
cb1a09d0 | 5344 | |
8ebc5c01 | 5345 | =item EXPORTED SYMBOLS |
cb1a09d0 | 5346 | |
8ebc5c01 | 5347 | =head2 File::Basename, fileparse - split a pathname into pieces |
7d2bfb28 | 5348 | |
5349 | =item SYNOPSIS | |
5350 | ||
7d2bfb28 | 5351 | =item DESCRIPTION |
5352 | ||
8ebc5c01 | 5353 | fileparse_set_fstype, fileparse |
7d2bfb28 | 5354 | |
8ebc5c01 | 5355 | =item EXAMPLES |
7d2bfb28 | 5356 | |
8ebc5c01 | 5357 | C<basename>, C<dirname> |
7d2bfb28 | 5358 | |
8ebc5c01 | 5359 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
cb1a09d0 AD |
5360 | |
5361 | =item SYNOPSIS | |
5362 | ||
cb1a09d0 AD |
5363 | =item DESCRIPTION |
5364 | ||
8ebc5c01 | 5365 | =head2 File::Compare - Compare files or filehandles |
cb1a09d0 | 5366 | |
8ebc5c01 | 5367 | =item SYNOPSIS |
cb1a09d0 | 5368 | |
8ebc5c01 | 5369 | =item DESCRIPTION |
cb1a09d0 | 5370 | |
8ebc5c01 | 5371 | =item RETURN |
cb1a09d0 | 5372 | |
8ebc5c01 | 5373 | =item AUTHOR |
cb1a09d0 | 5374 | |
8ebc5c01 | 5375 | =head2 File::Copy - Copy files or filehandles |
cb1a09d0 | 5376 | |
8ebc5c01 | 5377 | =item SYNOPSIS |
cb1a09d0 | 5378 | |
8ebc5c01 | 5379 | =item DESCRIPTION |
cb1a09d0 | 5380 | |
8ebc5c01 | 5381 | =over |
cb1a09d0 | 5382 | |
14218588 | 5383 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
cb1a09d0 | 5384 | |
8ebc5c01 | 5385 | rmscopy($from,$to[,$date_flag]) |
cb1a09d0 AD |
5386 | |
5387 | =back | |
5388 | ||
8ebc5c01 | 5389 | =item RETURN |
cb1a09d0 | 5390 | |
8ebc5c01 | 5391 | =item AUTHOR |
cb1a09d0 | 5392 | |
3e3baf6d TB |
5393 | =head2 File::DosGlob - DOS like globbing and then some |
5394 | ||
5395 | =item SYNOPSIS | |
5396 | ||
5397 | =item DESCRIPTION | |
5398 | ||
5399 | =item EXPORTS (by request only) | |
5400 | ||
5401 | =item BUGS | |
5402 | ||
5403 | =item AUTHOR | |
5404 | ||
5405 | =item HISTORY | |
5406 | ||
5407 | =item SEE ALSO | |
5408 | ||
8ebc5c01 | 5409 | =head2 File::Find, find - traverse a file tree |
cb1a09d0 | 5410 | |
8ebc5c01 | 5411 | =item SYNOPSIS |
cb1a09d0 | 5412 | |
8ebc5c01 | 5413 | =item DESCRIPTION |
cb1a09d0 | 5414 | |
d516a115 JH |
5415 | =item BUGS |
5416 | ||
8ebc5c01 | 5417 | =head2 File::Path - create or remove a series of directories |
cb1a09d0 | 5418 | |
8ebc5c01 | 5419 | =item SYNOPSIS |
7d2bfb28 | 5420 | |
5421 | =item DESCRIPTION | |
5422 | ||
8ebc5c01 | 5423 | =item AUTHORS |
7d2bfb28 | 5424 | |
fb9cefb4 GS |
5425 | =head2 File::Spec - portably perform operations on file names |
5426 | ||
5427 | =item SYNOPSIS | |
5428 | ||
5429 | =item DESCRIPTION | |
5430 | ||
5431 | =item SEE ALSO | |
5432 | ||
5433 | =item AUTHORS | |
5434 | ||
14218588 GS |
5435 | =head2 File::Spec::Functions - portably perform operations on file names |
5436 | ||
5437 | =item SYNOPSIS | |
5438 | ||
5439 | =item DESCRIPTION | |
5440 | ||
5441 | =over | |
5442 | ||
5443 | =item Exports | |
5444 | ||
5445 | =back | |
5446 | ||
5447 | =item SEE ALSO | |
5448 | ||
fb9cefb4 GS |
5449 | =head2 File::Spec::Mac - File::Spec for MacOS |
5450 | ||
5451 | =item SYNOPSIS | |
5452 | ||
5453 | =item DESCRIPTION | |
5454 | ||
5455 | =item METHODS | |
5456 | ||
14218588 GS |
5457 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, |
5458 | file_name_is_absolute, path | |
fb9cefb4 GS |
5459 | |
5460 | =item SEE ALSO | |
5461 | ||
5462 | =head2 File::Spec::OS2 - methods for OS/2 file specs | |
5463 | ||
5464 | =item SYNOPSIS | |
5465 | ||
5466 | =item DESCRIPTION | |
5467 | ||
5468 | =head2 File::Spec::Unix - methods used by File::Spec | |
5469 | ||
5470 | =item SYNOPSIS | |
5471 | ||
5472 | =item DESCRIPTION | |
5473 | ||
5474 | =item METHODS | |
5475 | ||
14218588 GS |
5476 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, |
5477 | no_upwards, file_name_is_absolute, path, join, splitpath, splitdir, | |
5478 | catpath, abs2rel, rel2abs | |
fb9cefb4 GS |
5479 | |
5480 | =item SEE ALSO | |
5481 | ||
5482 | =head2 File::Spec::VMS - methods for VMS file specs | |
5483 | ||
5484 | =item SYNOPSIS | |
5485 | ||
5486 | =item DESCRIPTION | |
5487 | ||
5488 | =over | |
5489 | ||
5490 | =item Methods always loaded | |
5491 | ||
14218588 GS |
5492 | catdir, catfile, curdir (override), devnull (override), rootdir (override), |
5493 | tmpdir (override), updir (override), path (override), file_name_is_absolute | |
5494 | (override) | |
fb9cefb4 GS |
5495 | |
5496 | =back | |
5497 | ||
14218588 GS |
5498 | =item SEE ALSO |
5499 | ||
fb9cefb4 GS |
5500 | =head2 File::Spec::Win32 - methods for Win32 file specs |
5501 | ||
5502 | =item SYNOPSIS | |
5503 | ||
5504 | =item DESCRIPTION | |
5505 | ||
14218588 GS |
5506 | devnull, tmpdir, catfile, canonpath, splitpath, splitdir, catpath, abs2rel, |
5507 | rel2abs | |
5508 | ||
5509 | =item SEE ALSO | |
fb9cefb4 | 5510 | |
8ebc5c01 | 5511 | =head2 File::stat - by-name interface to Perl's built-in stat() functions |
7d2bfb28 | 5512 | |
5513 | =item SYNOPSIS | |
5514 | ||
7d2bfb28 | 5515 | =item DESCRIPTION |
5516 | ||
8ebc5c01 | 5517 | =item NOTE |
7d2bfb28 | 5518 | |
8ebc5c01 | 5519 | =item AUTHOR |
7d2bfb28 | 5520 | |
8ebc5c01 | 5521 | =head2 FileCache - keep more files open than the system permits |
7d2bfb28 | 5522 | |
8ebc5c01 | 5523 | =item SYNOPSIS |
7d2bfb28 | 5524 | |
8ebc5c01 | 5525 | =item DESCRIPTION |
7d2bfb28 | 5526 | |
8ebc5c01 | 5527 | =item BUGS |
7d2bfb28 | 5528 | |
8ebc5c01 | 5529 | =head2 FileHandle - supply object methods for filehandles |
7d2bfb28 | 5530 | |
8ebc5c01 | 5531 | =item SYNOPSIS |
7d2bfb28 | 5532 | |
8ebc5c01 | 5533 | =item DESCRIPTION |
7d2bfb28 | 5534 | |
8ebc5c01 | 5535 | $fh->print, $fh->printf, $fh->getline, $fh->getlines |
7d2bfb28 | 5536 | |
8ebc5c01 | 5537 | =item SEE ALSO |
7d2bfb28 | 5538 | |
8ebc5c01 | 5539 | =head2 FindBin - Locate directory of original perl script |
7d2bfb28 | 5540 | |
8ebc5c01 | 5541 | =item SYNOPSIS |
7d2bfb28 | 5542 | |
8ebc5c01 | 5543 | =item DESCRIPTION |
7d2bfb28 | 5544 | |
8ebc5c01 | 5545 | =item EXPORTABLE VARIABLES |
7d2bfb28 | 5546 | |
8ebc5c01 | 5547 | =item KNOWN BUGS |
7d2bfb28 | 5548 | |
8ebc5c01 | 5549 | =item AUTHORS |
7d2bfb28 | 5550 | |
8ebc5c01 | 5551 | =item COPYRIGHT |
7d2bfb28 | 5552 | |
8ebc5c01 | 5553 | =head2 GDBM_File - Perl5 access to the gdbm library. |
7d2bfb28 | 5554 | |
8ebc5c01 | 5555 | =item SYNOPSIS |
7d2bfb28 | 5556 | |
5557 | =item DESCRIPTION | |
5558 | ||
8ebc5c01 | 5559 | =item AVAILABILITY |
7d2bfb28 | 5560 | |
8ebc5c01 | 5561 | =item BUGS |
7d2bfb28 | 5562 | |
8ebc5c01 | 5563 | =item SEE ALSO |
7d2bfb28 | 5564 | |
8ebc5c01 | 5565 | =head2 Getopt::Long, GetOptions - extended processing of command line |
5566 | options | |
cb1a09d0 AD |
5567 | |
5568 | =item SYNOPSIS | |
5569 | ||
cb1a09d0 AD |
5570 | =item DESCRIPTION |
5571 | ||
193fb0af | 5572 | !, +, :s, :i, :f |
cb1a09d0 AD |
5573 | |
5574 | =over | |
5575 | ||
8ebc5c01 | 5576 | =item Linkage specification |
cb1a09d0 | 5577 | |
8ebc5c01 | 5578 | =item Aliases and abbreviations |
cb1a09d0 | 5579 | |
8ebc5c01 | 5580 | =item Non-option call-back routine |
cb1a09d0 | 5581 | |
8ebc5c01 | 5582 | =item Option starters |
cb1a09d0 | 5583 | |
d516a115 | 5584 | =item Return values and Errors |
cb1a09d0 | 5585 | |
8ebc5c01 | 5586 | =back |
cb1a09d0 | 5587 | |
8ebc5c01 | 5588 | =item COMPATIBILITY |
7d2bfb28 | 5589 | |
8ebc5c01 | 5590 | =item EXAMPLES |
7d2bfb28 | 5591 | |
9607fc9c | 5592 | =item CONFIGURATION OPTIONS |
5593 | ||
5594 | default, auto_abbrev, getopt_compat, require_order, permute, bundling | |
14218588 | 5595 | (default: reset), bundling_override (default: reset), ignore_case |
9607fc9c | 5596 | (default: set), ignore_case_always (default: reset), pass_through (default: |
193fb0af | 5597 | reset), prefix, prefix_pattern, debug (default: reset) |
9607fc9c | 5598 | |
5599 | =item OTHER USEFUL VARIABLES | |
cb1a09d0 | 5600 | |
9607fc9c | 5601 | $Getopt::Long::VERSION, $Getopt::Long::error |
cb1a09d0 | 5602 | |
d516a115 JH |
5603 | =item AUTHOR |
5604 | ||
5605 | =item COPYRIGHT AND DISCLAIMER | |
5606 | ||
8ebc5c01 | 5607 | =head2 Getopt::Std, getopt - Process single-character switches with switch |
5608 | clustering | |
cb1a09d0 | 5609 | |
8ebc5c01 | 5610 | =item SYNOPSIS |
cb1a09d0 | 5611 | |
8ebc5c01 | 5612 | =item DESCRIPTION |
cb1a09d0 | 5613 | |
8ebc5c01 | 5614 | =head2 I18N::Collate - compare 8-bit scalar data according to the current |
5615 | locale | |
cb1a09d0 | 5616 | |
8ebc5c01 | 5617 | =item SYNOPSIS |
cb1a09d0 | 5618 | |
8ebc5c01 | 5619 | =item DESCRIPTION |
cb1a09d0 | 5620 | |
8ebc5c01 | 5621 | =head2 IO - load various IO modules |
cb1a09d0 | 5622 | |
8ebc5c01 | 5623 | =item SYNOPSIS |
cb1a09d0 | 5624 | |
8ebc5c01 | 5625 | =item DESCRIPTION |
cb1a09d0 | 5626 | |
14218588 GS |
5627 | =head2 IO::Dir - supply object methods for directory handles |
5628 | ||
5629 | =item SYNOPSIS | |
5630 | ||
5631 | =item DESCRIPTION | |
5632 | ||
5633 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
5634 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
5635 | ||
5636 | =item SEE ALSO | |
5637 | ||
5638 | =item AUTHOR | |
5639 | ||
5640 | =item COPYRIGHT | |
5641 | ||
5642 | =head2 IO::File - supply object methods for filehandles | |
cb1a09d0 AD |
5643 | |
5644 | =item SYNOPSIS | |
5645 | ||
cb1a09d0 AD |
5646 | =item DESCRIPTION |
5647 | ||
8ebc5c01 | 5648 | =item CONSTRUCTOR |
cb1a09d0 | 5649 | |
14218588 | 5650 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile |
cb1a09d0 | 5651 | |
8ebc5c01 | 5652 | =item METHODS |
cb1a09d0 | 5653 | |
8ebc5c01 | 5654 | open( FILENAME [,MODE [,PERMS]] ) |
cb1a09d0 | 5655 | |
8ebc5c01 | 5656 | =item SEE ALSO |
cb1a09d0 | 5657 | |
8ebc5c01 | 5658 | =item HISTORY |
cb1a09d0 | 5659 | |
14218588 | 5660 | =head2 IO::Handle - supply object methods for I/O handles |
cb1a09d0 AD |
5661 | |
5662 | =item SYNOPSIS | |
5663 | ||
cb1a09d0 AD |
5664 | =item DESCRIPTION |
5665 | ||
8ebc5c01 | 5666 | =item CONSTRUCTOR |
cb1a09d0 | 5667 | |
8ebc5c01 | 5668 | new (), new_from_fd ( FD, MODE ) |
cb1a09d0 | 5669 | |
8ebc5c01 | 5670 | =item METHODS |
cb1a09d0 | 5671 | |
14218588 GS |
5672 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, |
5673 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
5674 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
5675 | $io->blocking ( [ BOOL ] ), $io->untaint | |
cb1a09d0 | 5676 | |
8ebc5c01 | 5677 | =item NOTE |
cb1a09d0 | 5678 | |
8ebc5c01 | 5679 | =item SEE ALSO |
cb1a09d0 | 5680 | |
8ebc5c01 | 5681 | =item BUGS |
cb1a09d0 | 5682 | |
8ebc5c01 | 5683 | =item HISTORY |
cb1a09d0 | 5684 | |
14218588 | 5685 | =head2 IO::Pipe - supply object methods for pipes |
cb1a09d0 AD |
5686 | |
5687 | =item SYNOPSIS | |
5688 | ||
cb1a09d0 AD |
5689 | =item DESCRIPTION |
5690 | ||
14218588 | 5691 | =item CONSTRUCTOR |
cb1a09d0 | 5692 | |
8ebc5c01 | 5693 | new ( [READER, WRITER] ) |
cb1a09d0 | 5694 | |
8ebc5c01 | 5695 | =item METHODS |
cb1a09d0 | 5696 | |
8ebc5c01 | 5697 | reader ([ARGS]), writer ([ARGS]), handles () |
cb1a09d0 | 5698 | |
8ebc5c01 | 5699 | =item SEE ALSO |
cb1a09d0 | 5700 | |
8ebc5c01 | 5701 | =item AUTHOR |
cb1a09d0 | 5702 | |
8ebc5c01 | 5703 | =item COPYRIGHT |
cb1a09d0 | 5704 | |
14218588 GS |
5705 | =head2 IO::Poll - Object interface to system poll call |
5706 | ||
5707 | =item SYNOPSIS | |
5708 | ||
5709 | =item DESCRIPTION | |
5710 | ||
5711 | =item METHODS | |
5712 | ||
5713 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
5714 | IO ), handles( [ EVENT_MASK ] ) | |
5715 | ||
5716 | =item SEE ALSO | |
5717 | ||
5718 | =item AUTHOR | |
5719 | ||
5720 | =item COPYRIGHT | |
5721 | ||
5722 | =head2 IO::Seekable - supply seek based methods for I/O objects | |
cb1a09d0 | 5723 | |
8ebc5c01 | 5724 | =item SYNOPSIS |
cb1a09d0 | 5725 | |
8ebc5c01 | 5726 | =item DESCRIPTION |
cb1a09d0 | 5727 | |
8ebc5c01 | 5728 | =item SEE ALSO |
cb1a09d0 | 5729 | |
8ebc5c01 | 5730 | =item HISTORY |
cb1a09d0 | 5731 | |
14218588 | 5732 | =head2 IO::Select - OO interface to the select system call |
cb1a09d0 AD |
5733 | |
5734 | =item SYNOPSIS | |
5735 | ||
cb1a09d0 AD |
5736 | =item DESCRIPTION |
5737 | ||
8ebc5c01 | 5738 | =item CONSTRUCTOR |
cb1a09d0 | 5739 | |
8ebc5c01 | 5740 | new ( [ HANDLES ] ) |
cb1a09d0 | 5741 | |
8ebc5c01 | 5742 | =item METHODS |
cb1a09d0 | 5743 | |
8ebc5c01 | 5744 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( |
14218588 GS |
5745 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), |
5746 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
cb1a09d0 | 5747 | |
8ebc5c01 | 5748 | =item EXAMPLE |
cb1a09d0 | 5749 | |
8ebc5c01 | 5750 | =item AUTHOR |
cb1a09d0 | 5751 | |
8ebc5c01 | 5752 | =item COPYRIGHT |
cb1a09d0 | 5753 | |
14218588 | 5754 | =head2 IO::Socket - Object interface to socket communications |
7d2bfb28 | 5755 | |
5756 | =item SYNOPSIS | |
5757 | ||
7d2bfb28 | 5758 | =item DESCRIPTION |
5759 | ||
8ebc5c01 | 5760 | =item CONSTRUCTOR |
7d2bfb28 | 5761 | |
8ebc5c01 | 5762 | new ( [ARGS] ) |
5763 | ||
5764 | =item METHODS | |
7d2bfb28 | 5765 | |
8ebc5c01 | 5766 | accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype, |
14218588 | 5767 | protocol, connected |
7d2bfb28 | 5768 | |
14218588 | 5769 | =item SEE ALSO |
7d2bfb28 | 5770 | |
14218588 | 5771 | =item AUTHOR |
7d2bfb28 | 5772 | |
14218588 | 5773 | =item COPYRIGHT |
7d2bfb28 | 5774 | |
14218588 | 5775 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets |
cb1a09d0 | 5776 | |
14218588 GS |
5777 | =item SYNOPSIS |
5778 | ||
5779 | =item DESCRIPTION | |
5780 | ||
5781 | =item CONSTRUCTOR | |
5782 | ||
5783 | new ( [ARGS] ) | |
cb1a09d0 | 5784 | |
14218588 | 5785 | =over |
cb1a09d0 | 5786 | |
8ebc5c01 | 5787 | =item METHODS |
cb1a09d0 | 5788 | |
14218588 GS |
5789 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost |
5790 | () | |
cb1a09d0 | 5791 | |
8ebc5c01 | 5792 | =back |
cb1a09d0 | 5793 | |
7d2bfb28 | 5794 | =item SEE ALSO |
cb1a09d0 | 5795 | |
8ebc5c01 | 5796 | =item AUTHOR |
cb1a09d0 | 5797 | |
8ebc5c01 | 5798 | =item COPYRIGHT |
cb1a09d0 | 5799 | |
14218588 | 5800 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets |
cb1a09d0 | 5801 | |
8ebc5c01 | 5802 | =item SYNOPSIS |
cb1a09d0 | 5803 | |
8ebc5c01 | 5804 | =item DESCRIPTION |
cb1a09d0 | 5805 | |
14218588 | 5806 | =item CONSTRUCTOR |
7d2bfb28 | 5807 | |
14218588 | 5808 | new ( [ARGS] ) |
7d2bfb28 | 5809 | |
14218588 | 5810 | =item METHODS |
7d2bfb28 | 5811 | |
14218588 | 5812 | hostpath(), peerpath() |
7d2bfb28 | 5813 | |
14218588 | 5814 | =item SEE ALSO |
7d2bfb28 | 5815 | |
14218588 | 5816 | =item AUTHOR |
8ebc5c01 | 5817 | |
14218588 GS |
5818 | =item COPYRIGHT |
5819 | ||
5820 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory | |
5821 | handles | |
fb9cefb4 GS |
5822 | |
5823 | =item SYNOPSIS | |
5824 | ||
5825 | =item DESCRIPTION | |
5826 | ||
14218588 GS |
5827 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
5828 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
fb9cefb4 GS |
5829 | |
5830 | =item SEE ALSO | |
5831 | ||
14218588 | 5832 | =item AUTHOR |
fb9cefb4 GS |
5833 | |
5834 | =item COPYRIGHT | |
5835 | ||
14218588 | 5836 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
fb9cefb4 GS |
5837 | |
5838 | =item SYNOPSIS | |
5839 | ||
5840 | =item DESCRIPTION | |
5841 | ||
14218588 GS |
5842 | =item CONSTRUCTOR |
5843 | ||
5844 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
5845 | ||
fb9cefb4 GS |
5846 | =item METHODS |
5847 | ||
14218588 | 5848 | open( FILENAME [,MODE [,PERMS]] ) |
fb9cefb4 GS |
5849 | |
5850 | =item SEE ALSO | |
5851 | ||
14218588 | 5852 | =item HISTORY |
fb9cefb4 | 5853 | |
14218588 GS |
5854 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
5855 | handles | |
5856 | ||
5857 | =item SYNOPSIS | |
5858 | ||
5859 | =item DESCRIPTION | |
5860 | ||
5861 | =item CONSTRUCTOR | |
5862 | ||
5863 | new (), new_from_fd ( FD, MODE ) | |
5864 | ||
5865 | =item METHODS | |
5866 | ||
5867 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
5868 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
5869 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
5870 | $io->blocking ( [ BOOL ] ), $io->untaint | |
5871 | ||
5872 | =item NOTE | |
5873 | ||
5874 | =item SEE ALSO | |
5875 | ||
5876 | =item BUGS | |
5877 | ||
5878 | =item HISTORY | |
5879 | ||
5880 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes | |
5881 | ||
5882 | =item SYNOPSIS | |
5883 | ||
5884 | =item DESCRIPTION | |
5885 | ||
5886 | =item CONSTRUCTOR | |
5887 | ||
5888 | new ( [READER, WRITER] ) | |
5889 | ||
5890 | =item METHODS | |
5891 | ||
5892 | reader ([ARGS]), writer ([ARGS]), handles () | |
5893 | ||
5894 | =item SEE ALSO | |
5895 | ||
5896 | =item AUTHOR | |
5897 | ||
5898 | =item COPYRIGHT | |
5899 | ||
5900 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call | |
5901 | ||
5902 | =item SYNOPSIS | |
5903 | ||
5904 | =item DESCRIPTION | |
5905 | ||
5906 | =item METHODS | |
5907 | ||
5908 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
5909 | IO ), handles( [ EVENT_MASK ] ) | |
5910 | ||
5911 | =item SEE ALSO | |
5912 | ||
5913 | =item AUTHOR | |
5914 | ||
5915 | =item COPYRIGHT | |
5916 | ||
5917 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for | |
5918 | I/O objects | |
5919 | ||
5920 | =item SYNOPSIS | |
5921 | ||
5922 | =item DESCRIPTION | |
5923 | ||
5924 | =item SEE ALSO | |
5925 | ||
5926 | =item HISTORY | |
5927 | ||
5928 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system | |
5929 | call | |
5930 | ||
5931 | =item SYNOPSIS | |
5932 | ||
5933 | =item DESCRIPTION | |
5934 | ||
5935 | =item CONSTRUCTOR | |
5936 | ||
5937 | new ( [ HANDLES ] ) | |
5938 | ||
5939 | =item METHODS | |
5940 | ||
5941 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
5942 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
5943 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
5944 | ||
5945 | =item EXAMPLE | |
5946 | ||
5947 | =item AUTHOR | |
5948 | ||
5949 | =item COPYRIGHT | |
5950 | ||
5951 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket | |
5952 | communications | |
5953 | ||
5954 | =item SYNOPSIS | |
5955 | ||
5956 | =item DESCRIPTION | |
5957 | ||
5958 | =item CONSTRUCTOR | |
5959 | ||
5960 | new ( [ARGS] ) | |
5961 | ||
5962 | =item METHODS | |
5963 | ||
5964 | accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype, | |
5965 | protocol, connected | |
5966 | ||
5967 | =item SEE ALSO | |
5968 | ||
5969 | =item AUTHOR | |
5970 | ||
5971 | =item COPYRIGHT | |
5972 | ||
5973 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for | |
5974 | AF_INET domain sockets | |
5975 | ||
5976 | =item SYNOPSIS | |
5977 | ||
5978 | =item DESCRIPTION | |
5979 | ||
5980 | =item CONSTRUCTOR | |
5981 | ||
5982 | new ( [ARGS] ) | |
5983 | ||
5984 | =over | |
5985 | ||
5986 | =item METHODS | |
5987 | ||
5988 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
5989 | () | |
5990 | ||
5991 | =back | |
5992 | ||
5993 | =item SEE ALSO | |
5994 | ||
5995 | =item AUTHOR | |
5996 | ||
5997 | =item COPYRIGHT | |
5998 | ||
5999 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for | |
6000 | AF_UNIX domain sockets | |
6001 | ||
6002 | =item SYNOPSIS | |
6003 | ||
6004 | =item DESCRIPTION | |
6005 | ||
6006 | =item CONSTRUCTOR | |
6007 | ||
6008 | new ( [ARGS] ) | |
6009 | ||
6010 | =item METHODS | |
6011 | ||
6012 | hostpath(), peerpath() | |
6013 | ||
6014 | =item SEE ALSO | |
6015 | ||
6016 | =item AUTHOR | |
6017 | ||
6018 | =item COPYRIGHT | |
6019 | ||
6020 | =head2 IPC::Msg - SysV Msg IPC object class | |
6021 | ||
6022 | =item SYNOPSIS | |
6023 | ||
6024 | =item DESCRIPTION | |
6025 | ||
6026 | =item METHODS | |
6027 | ||
6028 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
6029 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
6030 | FLAGS ] ), stat | |
6031 | ||
6032 | =item SEE ALSO | |
6033 | ||
6034 | =item AUTHOR | |
6035 | ||
6036 | =item COPYRIGHT | |
6037 | ||
6038 | =head2 IPC::Open2, open2 - open a process for both reading and writing | |
6039 | ||
6040 | =item SYNOPSIS | |
6041 | ||
6042 | =item DESCRIPTION | |
6043 | ||
6044 | =item WARNING | |
6045 | ||
6046 | =item SEE ALSO | |
6047 | ||
6048 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error | |
6049 | handling | |
6050 | ||
6051 | =item SYNOPSIS | |
6052 | ||
6053 | =item DESCRIPTION | |
6054 | ||
6055 | =item WARNING | |
6056 | ||
6057 | =head2 IPC::Semaphore - SysV Semaphore IPC object class | |
6058 | ||
6059 | =item SYNOPSIS | |
6060 | ||
6061 | =item DESCRIPTION | |
6062 | ||
6063 | =item METHODS | |
6064 | ||
6065 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
6066 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
6067 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
6068 | , VALUE ), stat | |
6069 | ||
6070 | =item SEE ALSO | |
6071 | ||
6072 | =item AUTHOR | |
6073 | ||
6074 | =item COPYRIGHT | |
6075 | ||
6076 | =head2 IPC::SysV - SysV IPC constants | |
6077 | ||
6078 | =item SYNOPSIS | |
6079 | ||
6080 | =item DESCRIPTION | |
6081 | ||
6082 | ftok( PATH, ID ) | |
6083 | ||
6084 | =item SEE ALSO | |
6085 | ||
6086 | =item AUTHORS | |
6087 | ||
6088 | =item COPYRIGHT | |
6089 | ||
6090 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class | |
6091 | ||
6092 | =item SYNOPSIS | |
6093 | ||
6094 | =item DESCRIPTION | |
6095 | ||
6096 | =item METHODS | |
6097 | ||
6098 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
6099 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
6100 | FLAGS ] ), stat | |
6101 | ||
6102 | =item SEE ALSO | |
6103 | ||
6104 | =item AUTHOR | |
6105 | ||
6106 | =item COPYRIGHT | |
fb9cefb4 GS |
6107 | |
6108 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object | |
6109 | class | |
6110 | ||
6111 | =item SYNOPSIS | |
6112 | ||
6113 | =item DESCRIPTION | |
6114 | ||
6115 | =item METHODS | |
6116 | ||
6117 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
6118 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
6119 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
6120 | , VALUE ), stat | |
6121 | ||
6122 | =item SEE ALSO | |
6123 | ||
6124 | =item AUTHOR | |
6125 | ||
6126 | =item COPYRIGHT | |
6127 | ||
8ebc5c01 | 6128 | =head2 Math::BigFloat - Arbitrary length float math package |
7d2bfb28 | 6129 | |
8ebc5c01 | 6130 | =item SYNOPSIS |
6131 | ||
6132 | =item DESCRIPTION | |
cb1a09d0 | 6133 | |
14218588 GS |
6134 | number format, Error returns 'NaN', Division is computed to, Rounding is |
6135 | performed | |
cb1a09d0 AD |
6136 | |
6137 | =item BUGS | |
6138 | ||
8ebc5c01 | 6139 | =item AUTHOR |
6140 | ||
6141 | =head2 Math::BigInt - Arbitrary size integer math package | |
cb1a09d0 | 6142 | |
8ebc5c01 | 6143 | =item SYNOPSIS |
7d2bfb28 | 6144 | |
8ebc5c01 | 6145 | =item DESCRIPTION |
7d2bfb28 | 6146 | |
8ebc5c01 | 6147 | Canonical notation, Input, Output |
cb1a09d0 | 6148 | |
8ebc5c01 | 6149 | =item EXAMPLES |
cb1a09d0 | 6150 | |
fb9cefb4 GS |
6151 | =item Autocreating constants |
6152 | ||
8ebc5c01 | 6153 | =item BUGS |
cb1a09d0 | 6154 | |
8ebc5c01 | 6155 | =item AUTHOR |
cb1a09d0 | 6156 | |
8ebc5c01 | 6157 | =head2 Math::Complex - complex numbers and associated mathematical |
6158 | functions | |
cb1a09d0 | 6159 | |
8ebc5c01 | 6160 | =item SYNOPSIS |
cb1a09d0 AD |
6161 | |
6162 | =item DESCRIPTION | |
6163 | ||
8ebc5c01 | 6164 | =item OPERATIONS |
cb1a09d0 | 6165 | |
8ebc5c01 | 6166 | =item CREATION |
7d2bfb28 | 6167 | |
8ebc5c01 | 6168 | =item STRINGIFICATION |
7d2bfb28 | 6169 | |
8ebc5c01 | 6170 | =item USAGE |
6171 | ||
d516a115 JH |
6172 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO |
6173 | ||
6174 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
4a6725af | 6175 | |
8ebc5c01 | 6176 | =item BUGS |
7d2bfb28 | 6177 | |
68dc0745 | 6178 | =item AUTHORS |
7d2bfb28 | 6179 | |
4a6725af NT |
6180 | =head2 Math::Trig - trigonometric functions |
6181 | ||
6182 | =item SYNOPSIS | |
6183 | ||
6184 | =item DESCRIPTION | |
6185 | ||
6186 | =item TRIGONOMETRIC FUNCTIONS | |
6187 | ||
fb9cefb4 GS |
6188 | B<tan> |
6189 | ||
4a6725af NT |
6190 | =over |
6191 | ||
5cd24f17 | 6192 | =item ERRORS DUE TO DIVISION BY ZERO |
6193 | ||
6194 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
4a6725af NT |
6195 | |
6196 | =back | |
6197 | ||
fb9cefb4 GS |
6198 | =item PLANE ANGLE CONVERSIONS |
6199 | ||
6200 | =item RADIAL COORDINATE CONVERSIONS | |
6201 | ||
6202 | =over | |
6203 | ||
6204 | =item COORDINATE SYSTEMS | |
6205 | ||
6206 | =item 3-D ANGLE CONVERSIONS | |
6207 | ||
6208 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
6209 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
6210 | ||
6211 | =back | |
6212 | ||
6213 | =item GREAT CIRCLE DISTANCES | |
6214 | ||
6215 | =item EXAMPLES | |
4a6725af | 6216 | |
5cd24f17 | 6217 | =item BUGS |
6218 | ||
6219 | =item AUTHORS | |
6220 | ||
8ebc5c01 | 6221 | =head2 NDBM_File - Tied access to ndbm files |
7d2bfb28 | 6222 | |
8ebc5c01 | 6223 | =item SYNOPSIS |
7d2bfb28 | 6224 | |
8ebc5c01 | 6225 | =item DESCRIPTION |
7d2bfb28 | 6226 | |
8ebc5c01 | 6227 | =head2 Net::Ping - check a remote host for reachability |
7d2bfb28 | 6228 | |
8ebc5c01 | 6229 | =item SYNOPSIS |
7d2bfb28 | 6230 | |
8ebc5c01 | 6231 | =item DESCRIPTION |
7d2bfb28 | 6232 | |
8ebc5c01 | 6233 | =over |
6234 | ||
6235 | =item Functions | |
7d2bfb28 | 6236 | |
8ebc5c01 | 6237 | Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, |
6238 | $timeout]);, $p->close();, pingecho($host [, $timeout]); | |
7d2bfb28 | 6239 | |
8ebc5c01 | 6240 | =back |
6241 | ||
6242 | =item WARNING | |
7d2bfb28 | 6243 | |
8ebc5c01 | 6244 | =item NOTES |
7d2bfb28 | 6245 | |
8ebc5c01 | 6246 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
6247 | functions | |
7d2bfb28 | 6248 | |
8ebc5c01 | 6249 | =item SYNOPSIS |
7d2bfb28 | 6250 | |
8ebc5c01 | 6251 | =item DESCRIPTION |
7d2bfb28 | 6252 | |
cb1a09d0 AD |
6253 | =item EXAMPLES |
6254 | ||
8ebc5c01 | 6255 | =item NOTE |
cb1a09d0 | 6256 | |
8ebc5c01 | 6257 | =item AUTHOR |
cb1a09d0 | 6258 | |
8ebc5c01 | 6259 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
6260 | functions | |
cb1a09d0 | 6261 | |
8ebc5c01 | 6262 | =item SYNOPSIS |
cb1a09d0 | 6263 | |
8ebc5c01 | 6264 | =item DESCRIPTION |
cb1a09d0 | 6265 | |
8ebc5c01 | 6266 | =item EXAMPLES |
cb1a09d0 | 6267 | |
8ebc5c01 | 6268 | =item NOTE |
cb1a09d0 | 6269 | |
8ebc5c01 | 6270 | =item AUTHOR |
cb1a09d0 | 6271 | |
8ebc5c01 | 6272 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
6273 | functions | |
cb1a09d0 | 6274 | |
8ebc5c01 | 6275 | =item SYNOPSIS |
cb1a09d0 AD |
6276 | |
6277 | =item DESCRIPTION | |
6278 | ||
8ebc5c01 | 6279 | =item NOTE |
cb1a09d0 | 6280 | |
8ebc5c01 | 6281 | =item AUTHOR |
cb1a09d0 | 6282 | |
8ebc5c01 | 6283 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
6284 | functions | |
cb1a09d0 AD |
6285 | |
6286 | =item SYNOPSIS | |
6287 | ||
cb1a09d0 AD |
6288 | =item DESCRIPTION |
6289 | ||
8ebc5c01 | 6290 | =item EXAMPLES |
cb1a09d0 | 6291 | |
8ebc5c01 | 6292 | =item NOTE |
cb1a09d0 | 6293 | |
8ebc5c01 | 6294 | =item AUTHOR |
cb1a09d0 | 6295 | |
14218588 GS |
6296 | =head2 O - Generic interface to Perl Compiler backends |
6297 | ||
6298 | =item SYNOPSIS | |
6299 | ||
6300 | =item DESCRIPTION | |
6301 | ||
6302 | =item CONVENTIONS | |
6303 | ||
6304 | =item IMPLEMENTATION | |
6305 | ||
6306 | =item AUTHOR | |
6307 | ||
8ebc5c01 | 6308 | =head2 ODBM_File - Tied access to odbm files |
cb1a09d0 AD |
6309 | |
6310 | =item SYNOPSIS | |
6311 | ||
cb1a09d0 AD |
6312 | =item DESCRIPTION |
6313 | ||
8ebc5c01 | 6314 | =head2 Opcode - Disable named opcodes when compiling perl code |
cb1a09d0 | 6315 | |
8ebc5c01 | 6316 | =item SYNOPSIS |
cb1a09d0 | 6317 | |
8ebc5c01 | 6318 | =item DESCRIPTION |
cb1a09d0 | 6319 | |
8ebc5c01 | 6320 | =item NOTE |
cb1a09d0 | 6321 | |
8ebc5c01 | 6322 | =item WARNING |
cb1a09d0 | 6323 | |
8ebc5c01 | 6324 | =item Operator Names and Operator Lists |
cb1a09d0 | 6325 | |
8ebc5c01 | 6326 | an operator name (opname), an operator tag name (optag), a negated opname |
6327 | or optag, an operator set (opset) | |
cb1a09d0 | 6328 | |
8ebc5c01 | 6329 | =item Opcode Functions |
cb1a09d0 | 6330 | |
8ebc5c01 | 6331 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
6332 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
6333 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
6334 | opdump (PAT) | |
cb1a09d0 | 6335 | |
8ebc5c01 | 6336 | =item Manipulating Opsets |
cb1a09d0 | 6337 | |
8ebc5c01 | 6338 | =item TO DO (maybe) |
cb1a09d0 | 6339 | |
8ebc5c01 | 6340 | =item Predefined Opcode Tags |
cb1a09d0 | 6341 | |
8ebc5c01 | 6342 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
d516a115 JH |
6343 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
6344 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
6345 | :dangerous | |
cb1a09d0 | 6346 | |
8ebc5c01 | 6347 | =item SEE ALSO |
cb1a09d0 | 6348 | |
8ebc5c01 | 6349 | =item AUTHORS |
cb1a09d0 | 6350 | |
8ebc5c01 | 6351 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
6352 | compartments | |
cb1a09d0 AD |
6353 | |
6354 | =item SYNOPSIS | |
6355 | ||
cb1a09d0 AD |
6356 | =item DESCRIPTION |
6357 | ||
8ebc5c01 | 6358 | a new namespace, an operator mask |
6359 | ||
6360 | =item WARNING | |
cb1a09d0 AD |
6361 | |
6362 | =over | |
6363 | ||
8ebc5c01 | 6364 | =item RECENT CHANGES |
cb1a09d0 | 6365 | |
8ebc5c01 | 6366 | =item Methods in class Safe |
cb1a09d0 | 6367 | |
8ebc5c01 | 6368 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
6369 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
6370 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
6371 | root (NAMESPACE), mask (MASK) | |
cb1a09d0 | 6372 | |
8ebc5c01 | 6373 | =item Some Safety Issues |
cb1a09d0 | 6374 | |
8ebc5c01 | 6375 | Memory, CPU, Snooping, Signals, State Changes |
cb1a09d0 | 6376 | |
8ebc5c01 | 6377 | =item AUTHOR |
cb1a09d0 | 6378 | |
8ebc5c01 | 6379 | =back |
cb1a09d0 | 6380 | |
8ebc5c01 | 6381 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
6382 | compiling | |
cb1a09d0 | 6383 | |
14218588 | 6384 | =item SYNOPSIS |
cb1a09d0 | 6385 | |
8ebc5c01 | 6386 | =item DESCRIPTION |
cb1a09d0 | 6387 | |
8ebc5c01 | 6388 | =item SEE ALSO |
cb1a09d0 AD |
6389 | |
6390 | =head2 POSIX - Perl interface to IEEE Std 1003.1 | |
6391 | ||
6392 | =item SYNOPSIS | |
6393 | ||
cb1a09d0 AD |
6394 | =item DESCRIPTION |
6395 | ||
cb1a09d0 AD |
6396 | =item NOTE |
6397 | ||
8ebc5c01 | 6398 | =item CAVEATS |
cb1a09d0 AD |
6399 | |
6400 | =item FUNCTIONS | |
6401 | ||
8ebc5c01 | 6402 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
6403 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
6404 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
6405 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
6406 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
6407 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
6408 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
6409 | fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, | |
6410 | getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, | |
6411 | getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, | |
6412 | iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, | |
6413 | isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, | |
6414 | longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, | |
6415 | memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, | |
6416 | opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, | |
6417 | qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, | |
6418 | rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, | |
6419 | setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
6420 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
6421 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
6422 | strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr, | |
6423 | strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, | |
6424 | tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, | |
6425 | tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, | |
6426 | ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, | |
6427 | wcstombs, wctomb, write | |
cb1a09d0 AD |
6428 | |
6429 | =item CLASSES | |
6430 | ||
cb1a09d0 AD |
6431 | =over |
6432 | ||
cb1a09d0 AD |
6433 | =item POSIX::SigAction |
6434 | ||
cb1a09d0 AD |
6435 | new |
6436 | ||
6437 | =item POSIX::SigSet | |
6438 | ||
cb1a09d0 AD |
6439 | new, addset, delset, emptyset, fillset, ismember |
6440 | ||
6441 | =item POSIX::Termios | |
6442 | ||
cb1a09d0 AD |
6443 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
6444 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
6445 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
6446 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
6447 | values, c_oflag field values | |
6448 | ||
cb1a09d0 AD |
6449 | =back |
6450 | ||
6451 | =item PATHNAME CONSTANTS | |
6452 | ||
cb1a09d0 AD |
6453 | Constants |
6454 | ||
6455 | =item POSIX CONSTANTS | |
6456 | ||
cb1a09d0 AD |
6457 | Constants |
6458 | ||
6459 | =item SYSTEM CONFIGURATION | |
6460 | ||
cb1a09d0 AD |
6461 | Constants |
6462 | ||
6463 | =item ERRNO | |
6464 | ||
cb1a09d0 AD |
6465 | Constants |
6466 | ||
6467 | =item FCNTL | |
6468 | ||
cb1a09d0 AD |
6469 | Constants |
6470 | ||
6471 | =item FLOAT | |
6472 | ||
cb1a09d0 AD |
6473 | Constants |
6474 | ||
6475 | =item LIMITS | |
6476 | ||
cb1a09d0 AD |
6477 | Constants |
6478 | ||
6479 | =item LOCALE | |
6480 | ||
cb1a09d0 AD |
6481 | Constants |
6482 | ||
6483 | =item MATH | |
6484 | ||
cb1a09d0 AD |
6485 | Constants |
6486 | ||
6487 | =item SIGNAL | |
6488 | ||
cb1a09d0 AD |
6489 | Constants |
6490 | ||
6491 | =item STAT | |
6492 | ||
cb1a09d0 AD |
6493 | Constants, Macros |
6494 | ||
6495 | =item STDLIB | |
6496 | ||
cb1a09d0 AD |
6497 | Constants |
6498 | ||
6499 | =item STDIO | |
6500 | ||
cb1a09d0 AD |
6501 | Constants |
6502 | ||
6503 | =item TIME | |
6504 | ||
cb1a09d0 AD |
6505 | Constants |
6506 | ||
6507 | =item UNISTD | |
6508 | ||
cb1a09d0 AD |
6509 | Constants |
6510 | ||
6511 | =item WAIT | |
6512 | ||
cb1a09d0 AD |
6513 | Constants, Macros |
6514 | ||
6515 | =item CREATION | |
6516 | ||
14218588 GS |
6517 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
6518 | ||
6519 | =item SYNOPSIS | |
6520 | ||
6521 | =item OPTIONS/ARGUMENTS | |
6522 | ||
6523 | =item DESCRIPTION | |
6524 | ||
6525 | =item EXAMPLES | |
6526 | ||
6527 | =item AUTHOR | |
6528 | ||
193fb0af | 6529 | =head2 Pod::Html - module to convert pod files to HTML |
54310121 | 6530 | |
6531 | =item SYNOPSIS | |
6532 | ||
6533 | =item DESCRIPTION | |
6534 | ||
6535 | =item ARGUMENTS | |
6536 | ||
14218588 GS |
6537 | help, htmldir, htmlroot, infile, outfile, podroot, podpath, libpods, |
6538 | netscape, nonetscape, index, noindex, recurse, norecurse, title, verbose | |
54310121 | 6539 | |
6540 | =item EXAMPLE | |
6541 | ||
6542 | =item AUTHOR | |
6543 | ||
6544 | =item BUGS | |
6545 | ||
6546 | =item SEE ALSO | |
6547 | ||
6548 | =item COPYRIGHT | |
6549 | ||
14218588 GS |
6550 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
6551 | commands, etc. | |
6552 | ||
6553 | =item SYNOPSIS | |
6554 | ||
6555 | =item REQUIRES | |
6556 | ||
6557 | =item EXPORTS | |
6558 | ||
6559 | =item DESCRIPTION | |
6560 | ||
6561 | B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>, | |
6562 | B<Pod::ParseTree> | |
6563 | ||
6564 | =item B<Pod::InputSource> | |
6565 | ||
6566 | =over | |
6567 | ||
6568 | =item B<new()> | |
6569 | ||
6570 | =item B<name()> | |
6571 | ||
6572 | =item B<handle()> | |
6573 | ||
6574 | =item B<was_cutting()> | |
6575 | ||
6576 | =back | |
6577 | ||
6578 | =item B<Pod::Paragraph> | |
6579 | ||
6580 | =over | |
6581 | ||
6582 | =item B<new()> | |
6583 | ||
6584 | =item B<cmd_name()> | |
6585 | ||
6586 | =item B<text()> | |
6587 | ||
6588 | =item B<raw_text()> | |
6589 | ||
6590 | =item B<cmd_prefix()> | |
6591 | ||
6592 | =item B<cmd_separator()> | |
6593 | ||
6594 | =item B<parse_tree()> | |
6595 | ||
6596 | =item B<file_line()> | |
6597 | ||
6598 | =back | |
6599 | ||
6600 | =item B<Pod::InteriorSequence> | |
6601 | ||
6602 | =over | |
6603 | ||
6604 | =item B<new()> | |
6605 | ||
6606 | =item B<cmd_name()> | |
6607 | ||
6608 | =item B<prepend()> | |
6609 | ||
6610 | =item B<append()> | |
6611 | ||
6612 | =item B<nested()> | |
6613 | ||
6614 | =item B<raw_text()> | |
6615 | ||
6616 | =item B<left_delimiter()> | |
6617 | ||
6618 | =item B<right_delimiter()> | |
6619 | ||
6620 | =item B<parse_tree()> | |
6621 | ||
6622 | =item B<file_line()> | |
6623 | ||
6624 | =item B<DESTROY()> | |
6625 | ||
6626 | =back | |
6627 | ||
6628 | =item B<Pod::ParseTree> | |
6629 | ||
6630 | =over | |
6631 | ||
6632 | =item B<new()> | |
6633 | ||
6634 | =item B<top()> | |
6635 | ||
6636 | =item B<children()> | |
6637 | ||
6638 | =item B<prepend()> | |
6639 | ||
6640 | =item B<append()> | |
6641 | ||
6642 | =item B<raw_text()> | |
6643 | ||
6644 | =item B<DESTROY()> | |
6645 | ||
6646 | =back | |
6647 | ||
6648 | =item SEE ALSO | |
6649 | ||
6650 | =item AUTHOR | |
6651 | ||
6652 | =head2 Pod::Parser - base class for creating POD filters and translators | |
6653 | ||
6654 | =item SYNOPSIS | |
6655 | ||
6656 | =item REQUIRES | |
6657 | ||
6658 | =item EXPORTS | |
6659 | ||
6660 | =item DESCRIPTION | |
6661 | ||
6662 | =item QUICK OVERVIEW | |
6663 | ||
6664 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES | |
6665 | ||
6666 | =item B<command()> | |
6667 | ||
6668 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
6669 | ||
6670 | =item B<verbatim()> | |
6671 | ||
6672 | C<$text>, C<$line_num>, C<$pod_para> | |
6673 | ||
6674 | =item B<textblock()> | |
6675 | ||
6676 | C<$text>, C<$line_num>, C<$pod_para> | |
6677 | ||
6678 | =item B<interior_sequence()> | |
6679 | ||
6680 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES | |
6681 | ||
6682 | =item B<new()> | |
6683 | ||
6684 | =item B<initialize()> | |
6685 | ||
6686 | =item B<begin_pod()> | |
6687 | ||
6688 | =item B<begin_input()> | |
6689 | ||
6690 | =item B<end_input()> | |
6691 | ||
6692 | =item B<end_pod()> | |
6693 | ||
6694 | =item B<preprocess_line()> | |
6695 | ||
6696 | =item B<preprocess_paragraph()> | |
6697 | ||
6698 | =item METHODS FOR PARSING AND PROCESSING | |
6699 | ||
6700 | =item B<parse_text()> | |
6701 | ||
6702 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
6703 | I<code-ref>|I<method-name> | |
6704 | ||
6705 | =item B<interpolate()> | |
6706 | ||
6707 | =item B<parse_paragraph()> | |
6708 | ||
6709 | =item B<parse_from_filehandle()> | |
6710 | ||
6711 | =item B<parse_from_file()> | |
6712 | ||
6713 | =item ACCESSOR METHODS | |
6714 | ||
6715 | =item B<cutting()> | |
6716 | ||
6717 | =item B<output_file()> | |
6718 | ||
6719 | =item B<output_handle()> | |
6720 | ||
6721 | =item B<input_file()> | |
6722 | ||
6723 | =item B<input_handle()> | |
6724 | ||
6725 | =item B<input_streams()> | |
6726 | ||
6727 | =item B<top_stream()> | |
6728 | ||
6729 | =item PRIVATE METHODS AND DATA | |
6730 | ||
6731 | =item B<_push_input_stream()> | |
6732 | ||
6733 | =item B<_pop_input_stream()> | |
6734 | ||
6735 | =item SEE ALSO | |
6736 | ||
6737 | =item AUTHOR | |
6738 | ||
6739 | =head2 Pod::PlainText, pod2plaintext - function to convert POD data to | |
6740 | formatted ASCII text | |
6741 | ||
6742 | =item SYNOPSIS | |
6743 | ||
6744 | =item REQUIRES | |
6745 | ||
6746 | =item EXPORTS | |
6747 | ||
6748 | =item DESCRIPTION | |
6749 | ||
6750 | =item SEE ALSO | |
6751 | ||
6752 | =item AUTHOR | |
6753 | ||
6754 | =head2 Pod::Select, podselect() - extract selected sections of POD from | |
6755 | input | |
6756 | ||
6757 | =item SYNOPSIS | |
6758 | ||
6759 | =item REQUIRES | |
6760 | ||
6761 | =item EXPORTS | |
6762 | ||
6763 | =item DESCRIPTION | |
6764 | ||
6765 | =item SECTION SPECIFICATIONS | |
6766 | ||
6767 | =item RANGE SPECIFICATIONS | |
6768 | ||
6769 | =item OBJECT METHODS | |
6770 | ||
6771 | =item B<curr_headings()> | |
6772 | ||
6773 | =item B<select()> | |
6774 | ||
6775 | =item B<add_selection()> | |
6776 | ||
6777 | =item B<clear_selections()> | |
6778 | ||
6779 | =item B<match_section()> | |
6780 | ||
6781 | =item B<is_selected()> | |
6782 | ||
6783 | =item EXPORTED FUNCTIONS | |
6784 | ||
6785 | =item B<podselect()> | |
6786 | ||
6787 | B<-output>, B<-sections>, B<-ranges> | |
6788 | ||
6789 | =item PRIVATE METHODS AND DATA | |
6790 | ||
6791 | =item B<_compile_section_spec()> | |
6792 | ||
6793 | =over | |
6794 | ||
6795 | =item $self->{_SECTION_HEADINGS} | |
6796 | ||
6797 | =item $self->{_SELECTED_SECTIONS} | |
6798 | ||
6799 | =back | |
6800 | ||
6801 | =item SEE ALSO | |
6802 | ||
6803 | =item AUTHOR | |
6804 | ||
402d0d99 | 6805 | =head2 Pod::Text - convert POD data to formatted ASCII text |
6806 | ||
6807 | =item SYNOPSIS | |
6808 | ||
402d0d99 | 6809 | =item DESCRIPTION |
6810 | ||
402d0d99 | 6811 | =item AUTHOR |
6812 | ||
402d0d99 | 6813 | =item TODO |
6814 | ||
14218588 GS |
6815 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
6816 | documentation | |
6817 | ||
6818 | =item SYNOPSIS | |
6819 | ||
6820 | =item ARGUMENTS | |
6821 | ||
6822 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
6823 | C<-pathlist> | |
6824 | ||
6825 | =item DESCRIPTION | |
6826 | ||
6827 | =item EXAMPLES | |
6828 | ||
6829 | =over | |
6830 | ||
6831 | =item Recommended Use | |
6832 | ||
6833 | =back | |
6834 | ||
6835 | =item CAVEATS | |
6836 | ||
6837 | =item AUTHOR | |
6838 | ||
6839 | =item ACKNOWLEDGEMENTS | |
6840 | ||
8ebc5c01 | 6841 | =head2 SDBM_File - Tied access to sdbm files |
402d0d99 | 6842 | |
8ebc5c01 | 6843 | =item SYNOPSIS |
402d0d99 | 6844 | |
8ebc5c01 | 6845 | =item DESCRIPTION |
402d0d99 | 6846 | |
14218588 GS |
6847 | =head2 Safe - Compile and execute code in restricted compartments |
6848 | ||
6849 | =item SYNOPSIS | |
6850 | ||
6851 | =item DESCRIPTION | |
6852 | ||
6853 | a new namespace, an operator mask | |
6854 | ||
6855 | =item WARNING | |
6856 | ||
6857 | =over | |
6858 | ||
6859 | =item RECENT CHANGES | |
6860 | ||
6861 | =item Methods in class Safe | |
6862 | ||
6863 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
6864 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
6865 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
6866 | root (NAMESPACE), mask (MASK) | |
6867 | ||
6868 | =item Some Safety Issues | |
6869 | ||
6870 | Memory, CPU, Snooping, Signals, State Changes | |
6871 | ||
6872 | =item AUTHOR | |
6873 | ||
6874 | =back | |
6875 | ||
7d2bfb28 | 6876 | =head2 Search::Dict, look - search for key in dictionary file |
6877 | ||
6878 | =item SYNOPSIS | |
6879 | ||
7d2bfb28 | 6880 | =item DESCRIPTION |
6881 | ||
7d2bfb28 | 6882 | =head2 SelectSaver - save and restore selected file handle |
6883 | ||
6884 | =item SYNOPSIS | |
6885 | ||
7d2bfb28 | 6886 | =item DESCRIPTION |
6887 | ||
cb1a09d0 AD |
6888 | =head2 SelfLoader - load functions only on demand |
6889 | ||
6890 | =item SYNOPSIS | |
6891 | ||
cb1a09d0 AD |
6892 | =item DESCRIPTION |
6893 | ||
cb1a09d0 AD |
6894 | =over |
6895 | ||
6896 | =item The __DATA__ token | |
6897 | ||
cb1a09d0 AD |
6898 | =item SelfLoader autoloading |
6899 | ||
cb1a09d0 AD |
6900 | =item Autoloading and package lexicals |
6901 | ||
cb1a09d0 AD |
6902 | =item SelfLoader and AutoLoader |
6903 | ||
cb1a09d0 AD |
6904 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
6905 | ||
cb1a09d0 AD |
6906 | =item Classes and inherited methods. |
6907 | ||
cb1a09d0 AD |
6908 | =back |
6909 | ||
6910 | =item Multiple packages and fully qualified subroutine names | |
6911 | ||
8ebc5c01 | 6912 | =head2 Shell - run shell commands transparently within perl |
cb1a09d0 AD |
6913 | |
6914 | =item SYNOPSIS | |
6915 | ||
cb1a09d0 AD |
6916 | =item DESCRIPTION |
6917 | ||
8ebc5c01 | 6918 | =item AUTHOR |
cb1a09d0 | 6919 | |
8ebc5c01 | 6920 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
6921 | socket.h defines and structure manipulators | |
cb1a09d0 | 6922 | |
8ebc5c01 | 6923 | =item SYNOPSIS |
cb1a09d0 | 6924 | |
8ebc5c01 | 6925 | =item DESCRIPTION |
cb1a09d0 | 6926 | |
8ebc5c01 | 6927 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
6928 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in | |
6929 | SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in | |
6930 | SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN, | |
6931 | pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
cb1a09d0 | 6932 | |
7d2bfb28 | 6933 | =head2 Symbol - manipulate Perl symbols and their names |
6934 | ||
6935 | =item SYNOPSIS | |
6936 | ||
7d2bfb28 | 6937 | =item DESCRIPTION |
6938 | ||
cb1a09d0 AD |
6939 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
6940 | ||
6941 | =item SYNOPSIS | |
6942 | ||
cb1a09d0 AD |
6943 | =item DESCRIPTION |
6944 | ||
cb1a09d0 AD |
6945 | =item AUTHOR |
6946 | ||
8ebc5c01 | 6947 | =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl |
6948 | interface to the UNIX syslog(3) calls | |
7d2bfb28 | 6949 | |
6950 | =item SYNOPSIS | |
6951 | ||
7d2bfb28 | 6952 | =item DESCRIPTION |
6953 | ||
8ebc5c01 | 6954 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, |
fb9cefb4 GS |
6955 | setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), |
6956 | closelog | |
7d2bfb28 | 6957 | |
6958 | =item EXAMPLES | |
6959 | ||
7d2bfb28 | 6960 | =item DEPENDENCIES |
6961 | ||
7d2bfb28 | 6962 | =item SEE ALSO |
6963 | ||
7d2bfb28 | 6964 | =item AUTHOR |
6965 | ||
cb1a09d0 AD |
6966 | =head2 Term::Cap - Perl termcap interface |
6967 | ||
6968 | =item SYNOPSIS | |
6969 | ||
cb1a09d0 AD |
6970 | =item DESCRIPTION |
6971 | ||
cb1a09d0 AD |
6972 | =item EXAMPLES |
6973 | ||
cb1a09d0 AD |
6974 | =head2 Term::Complete - Perl word completion module |
6975 | ||
6976 | =item SYNOPSIS | |
6977 | ||
cb1a09d0 AD |
6978 | =item DESCRIPTION |
6979 | ||
3fe9a6f1 | 6980 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
cb1a09d0 AD |
6981 | |
6982 | =item DIAGNOSTICS | |
6983 | ||
cb1a09d0 AD |
6984 | =item BUGS |
6985 | ||
cb1a09d0 AD |
6986 | =item AUTHOR |
6987 | ||
8ebc5c01 | 6988 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. If |
6989 | no real package is found, substitutes stubs instead of basic functions. | |
7d2bfb28 | 6990 | |
6991 | =item SYNOPSIS | |
6992 | ||
7d2bfb28 | 6993 | =item DESCRIPTION |
6994 | ||
7d2bfb28 | 6995 | =item Minimal set of supported functions |
6996 | ||
7d2bfb28 | 6997 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>, |
9607fc9c | 6998 | C<MinLine>, C<findConsole>, Attribs, C<Features> |
6999 | ||
7000 | =item Additional supported functions | |
7d2bfb28 | 7001 | |
d516a115 JH |
7002 | C<tkRunning>, C<ornaments>, C<newTTY> |
7003 | ||
7d2bfb28 | 7004 | =item EXPORTS |
7005 | ||
9607fc9c | 7006 | =item ENVIRONMENT |
7007 | ||
14218588 | 7008 | =head2 Test - provides a simple framework for writing test scripts |
193fb0af GS |
7009 | |
7010 | =item SYNOPSIS | |
7011 | ||
7012 | =item DESCRIPTION | |
7013 | ||
7014 | =item TEST TYPES | |
7015 | ||
7016 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
7017 | ||
14218588 GS |
7018 | =item RETURN VALUE |
7019 | ||
193fb0af GS |
7020 | =item ONFAIL |
7021 | ||
7022 | =item SEE ALSO | |
7023 | ||
7024 | =item AUTHOR | |
7025 | ||
cb1a09d0 AD |
7026 | =head2 Test::Harness - run perl standard test scripts with statistics |
7027 | ||
7028 | =item SYNOPSIS | |
7029 | ||
cb1a09d0 AD |
7030 | =item DESCRIPTION |
7031 | ||
7d2bfb28 | 7032 | =over |
7033 | ||
7034 | =item The test script output | |
7035 | ||
7d2bfb28 | 7036 | =back |
7037 | ||
cb1a09d0 AD |
7038 | =item EXPORT |
7039 | ||
cb1a09d0 AD |
7040 | =item DIAGNOSTICS |
7041 | ||
7d2bfb28 | 7042 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
8ebc5c01 | 7043 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
7044 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
7045 | %s> | |
cb1a09d0 | 7046 | |
fb9cefb4 GS |
7047 | =item ENVIRONMENT |
7048 | ||
cb1a09d0 AD |
7049 | =item SEE ALSO |
7050 | ||
7d2bfb28 | 7051 | =item AUTHORS |
7052 | ||
cb1a09d0 AD |
7053 | =item BUGS |
7054 | ||
cb1a09d0 AD |
7055 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
7056 | ||
7057 | =item SYNOPSIS | |
7058 | ||
cb1a09d0 AD |
7059 | =item DESCRIPTION |
7060 | ||
cb1a09d0 AD |
7061 | =item EXAMPLE |
7062 | ||
193fb0af GS |
7063 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
7064 | arrays | |
cb1a09d0 | 7065 | |
8ebc5c01 | 7066 | =item SYNOPSIS |
cb1a09d0 | 7067 | |
8ebc5c01 | 7068 | =item DESCRIPTION |
cb1a09d0 | 7069 | |
193fb0af GS |
7070 | =item EXAMPLES |
7071 | ||
7072 | 0a simple word, 1multiple spaces are skipped because of our $delim, 2use of | |
7073 | quotes to include a space in a word, 3use of a backslash to include a space | |
7074 | in a word, 4use of a backslash to remove the special meaning of a | |
7075 | double-quote, 5another simple word (note the lack of effect of the | |
7076 | backslashed double-quote) | |
7077 | ||
8ebc5c01 | 7078 | =item AUTHORS |
cb1a09d0 | 7079 | |
8ebc5c01 | 7080 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
7081 | by Knuth | |
cb1a09d0 AD |
7082 | |
7083 | =item SYNOPSIS | |
7084 | ||
cb1a09d0 AD |
7085 | =item DESCRIPTION |
7086 | ||
cb1a09d0 AD |
7087 | =item EXAMPLES |
7088 | ||
cb1a09d0 AD |
7089 | =item LIMITATIONS |
7090 | ||
cb1a09d0 AD |
7091 | =item AUTHOR |
7092 | ||
8ebc5c01 | 7093 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
7094 | unexpand(1) | |
cb1a09d0 | 7095 | |
8ebc5c01 | 7096 | =item SYNOPSIS |
cb1a09d0 | 7097 | |
8ebc5c01 | 7098 | =item DESCRIPTION |
cb1a09d0 | 7099 | |
8ebc5c01 | 7100 | =item BUGS |
cb1a09d0 | 7101 | |
8ebc5c01 | 7102 | =item AUTHOR |
cb1a09d0 | 7103 | |
8ebc5c01 | 7104 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
cb1a09d0 | 7105 | |
8ebc5c01 | 7106 | =item SYNOPSIS |
cb1a09d0 AD |
7107 | |
7108 | =item DESCRIPTION | |
7109 | ||
8ebc5c01 | 7110 | =item EXAMPLE |
cb1a09d0 AD |
7111 | |
7112 | =item AUTHOR | |
7113 | ||
d516a115 JH |
7114 | =head2 Thread - multithreading |
7115 | ||
7116 | =item SYNOPSIS | |
7117 | ||
7118 | =item DESCRIPTION | |
7119 | ||
193fb0af GS |
7120 | =item FUNCTIONS |
7121 | ||
7122 | new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;, | |
7123 | Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE, | |
14218588 | 7124 | cond_broadcast VARIABLE, yield |
193fb0af GS |
7125 | |
7126 | =item METHODS | |
7127 | ||
14218588 | 7128 | join, eval, detach, equal, tid |
193fb0af GS |
7129 | |
7130 | =item LIMITATIONS | |
7131 | ||
d516a115 JH |
7132 | =item SEE ALSO |
7133 | ||
7134 | =head2 Thread::Queue - thread-safe queues | |
7135 | ||
7136 | =item SYNOPSIS | |
7137 | ||
193fb0af GS |
7138 | =item DESCRIPTION |
7139 | ||
7140 | =item FUNCTIONS AND METHODS | |
7141 | ||
7142 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
7143 | ||
7144 | =item SEE ALSO | |
7145 | ||
d516a115 JH |
7146 | =head2 Thread::Semaphore - thread-safe semaphores |
7147 | ||
7148 | =item SYNOPSIS | |
7149 | ||
193fb0af GS |
7150 | =item DESCRIPTION |
7151 | ||
7152 | =item FUNCTIONS AND METHODS | |
7153 | ||
7154 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
7155 | ||
7156 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably | |
7157 | ||
7158 | =item SYNOPSIS | |
7159 | ||
7160 | =item DESCRIPTION | |
7161 | ||
7162 | =item BUGS | |
7163 | ||
d516a115 JH |
7164 | =head2 Thread::Specific - thread-specific keys |
7165 | ||
7166 | =item SYNOPSIS | |
7167 | ||
14218588 GS |
7168 | =item DESCRIPTION |
7169 | ||
d516a115 JH |
7170 | =head2 Tie::Array - base class for tied arrays |
7171 | ||
14218588 | 7172 | =item SYNOPSIS |
d516a115 | 7173 | |
14218588 | 7174 | =item DESCRIPTION |
d516a115 JH |
7175 | |
7176 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
7177 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this, | |
7178 | DESTROY this, PUSH this, LIST, POP this, SHIFT this, UNSHIFT this, LIST, | |
7179 | SPLICE this, offset, length, LIST | |
7180 | ||
7181 | =item CAVEATS | |
7182 | ||
7183 | =item AUTHOR | |
7184 | ||
14218588 GS |
7185 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
7186 | handles | |
193fb0af GS |
7187 | |
7188 | =item SYNOPSIS | |
7189 | ||
7190 | =item DESCRIPTION | |
7191 | ||
7192 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
7193 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
14218588 GS |
7194 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
7195 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
193fb0af GS |
7196 | |
7197 | =item MORE INFORMATION | |
7198 | ||
8ebc5c01 | 7199 | =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes |
7200 | ||
7201 | =item SYNOPSIS | |
7202 | ||
7203 | =item DESCRIPTION | |
cb1a09d0 | 7204 | |
8ebc5c01 | 7205 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
7206 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this | |
cb1a09d0 | 7207 | |
8ebc5c01 | 7208 | =item CAVEATS |
cb1a09d0 | 7209 | |
8ebc5c01 | 7210 | =item MORE INFORMATION |
cb1a09d0 | 7211 | |
8ebc5c01 | 7212 | =head2 Tie::RefHash - use references as hash keys |
cb1a09d0 AD |
7213 | |
7214 | =item SYNOPSIS | |
7215 | ||
cb1a09d0 AD |
7216 | =item DESCRIPTION |
7217 | ||
8ebc5c01 | 7218 | =item EXAMPLE |
cb1a09d0 AD |
7219 | |
7220 | =item AUTHOR | |
7221 | ||
8ebc5c01 | 7222 | =item VERSION |
cb1a09d0 | 7223 | |
8ebc5c01 | 7224 | =item SEE ALSO |
cb1a09d0 | 7225 | |
8ebc5c01 | 7226 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
7227 | scalars | |
cb1a09d0 AD |
7228 | |
7229 | =item SYNOPSIS | |
7230 | ||
cb1a09d0 AD |
7231 | =item DESCRIPTION |
7232 | ||
8ebc5c01 | 7233 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
cb1a09d0 | 7234 | |
8ebc5c01 | 7235 | =item MORE INFORMATION |
cb1a09d0 | 7236 | |
8ebc5c01 | 7237 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
cb1a09d0 | 7238 | |
8ebc5c01 | 7239 | =item SYNOPSIS |
cb1a09d0 | 7240 | |
8ebc5c01 | 7241 | =item DESCRIPTION |
cb1a09d0 | 7242 | |
8ebc5c01 | 7243 | =item CAVEATS |
cb1a09d0 | 7244 | |
8ebc5c01 | 7245 | =head2 Time::Local - efficiently compute time from local and GMT time |
cb1a09d0 | 7246 | |
8ebc5c01 | 7247 | =item SYNOPSIS |
cb1a09d0 | 7248 | |
8ebc5c01 | 7249 | =item DESCRIPTION |
cb1a09d0 | 7250 | |
14218588 GS |
7251 | =item IMPLEMENTATION |
7252 | ||
7253 | =item BUGS | |
7254 | ||
8ebc5c01 | 7255 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
7256 | function | |
7d2bfb28 | 7257 | |
7258 | =item SYNOPSIS | |
7259 | ||
7d2bfb28 | 7260 | =item DESCRIPTION |
7261 | ||
8ebc5c01 | 7262 | =item NOTE |
7d2bfb28 | 7263 | |
8ebc5c01 | 7264 | =item AUTHOR |
7d2bfb28 | 7265 | |
8ebc5c01 | 7266 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
7267 | function | |
7d2bfb28 | 7268 | |
8ebc5c01 | 7269 | =item SYNOPSIS |
7d2bfb28 | 7270 | |
8ebc5c01 | 7271 | =item DESCRIPTION |
7d2bfb28 | 7272 | |
8ebc5c01 | 7273 | =item NOTE |
7d2bfb28 | 7274 | |
8ebc5c01 | 7275 | =item AUTHOR |
7d2bfb28 | 7276 | |
8ebc5c01 | 7277 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 7278 | |
7279 | =item SYNOPSIS | |
7280 | ||
8ebc5c01 | 7281 | =item DESCRIPTION |
7282 | ||
7283 | =item AUTHOR | |
7284 | ||
7285 | =head2 UNIVERSAL - base class for ALL classes (blessed references) | |
7286 | ||
7287 | =item SYNOPSIS | |
7d2bfb28 | 7288 | |
7289 | =item DESCRIPTION | |
7290 | ||
d516a115 JH |
7291 | isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa ( |
7292 | VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) | |
7d2bfb28 | 7293 | |
8ebc5c01 | 7294 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
7295 | functions | |
7d2bfb28 | 7296 | |
8ebc5c01 | 7297 | =item SYNOPSIS |
7d2bfb28 | 7298 | |
8ebc5c01 | 7299 | =item DESCRIPTION |
7d2bfb28 | 7300 | |
8ebc5c01 | 7301 | =item NOTE |
7d2bfb28 | 7302 | |
8ebc5c01 | 7303 | =item AUTHOR |
7d2bfb28 | 7304 | |
8ebc5c01 | 7305 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
7306 | functions | |
cb1a09d0 AD |
7307 | |
7308 | =item SYNOPSIS | |
7309 | ||
cb1a09d0 AD |
7310 | =item DESCRIPTION |
7311 | ||
8ebc5c01 | 7312 | =item NOTE |
cb1a09d0 | 7313 | |
8ebc5c01 | 7314 | =item AUTHOR |
cb1a09d0 AD |
7315 | |
7316 | =head1 AUXILIARY DOCUMENTATION | |
7317 | ||
8ebc5c01 | 7318 | Here should be listed all the extra programs' documentation, but they |
7319 | don't all have manual pages yet: | |
cb1a09d0 AD |
7320 | |
7321 | =item a2p | |
7322 | ||
7323 | =item s2p | |
7324 | ||
7325 | =item find2perl | |
7326 | ||
7327 | =item h2ph | |
7328 | ||
7329 | =item c2ph | |
7330 | ||
7331 | =item h2xs | |
7332 | ||
7333 | =item xsubpp | |
7334 | ||
7335 | =item pod2man | |
7336 | ||
7337 | =item wrapsuid | |
7338 | ||
cb1a09d0 AD |
7339 | =head1 AUTHOR |
7340 | ||
2ae324a7 | 7341 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
8ebc5c01 | 7342 | of other folks. |
cb1a09d0 | 7343 |