This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
This is patch.2b1g to perl5.002beta1.
[perl5.git] / pod / PerlDoc / Functions.pm
CommitLineData
cb1a09d0
AD
1package PerlDoc::Functions;
2
3#:vi:set ts=20
4
5require Exporter;
6
7@ISA = qw(Exporter);
8@EXPORT = qw(%Kinds %Type %Flavor %Type_Descriptions @Type_Order);
9
10%Type_Description = (
11 'ARRAY' => 'Functions for real @ARRAYs',
12 'Binary' => 'Functions for fixed length data or records',
13 'File' => 'Functions for filehandles, files, or directories',
14 'Flow' => 'Keywords related to control flow of your perl program',
15 'HASH' => 'Functions for real %HASHes',
16 'I/O' => 'Input and output functions',
17 'LIST' => 'Functions for list data',
18 'Math' => 'Numeric functions',
19 'Misc' => 'Miscellaneous functions',
20 'Modules' => 'Keywords related to perl modules',
21 'Network' => 'Fetching network info',
22 'Objects' => 'Keywords related to classes and object-orientedness',
23 'Process' => 'Functions for processes and process groups',
24 'Regexp' => 'Regular expressions and pattern matching',
25 'Socket' => 'Low-level socket functions',
26 'String' => 'Functions for SCALARs or strings',
27 'SysV' => 'System V interprocess communication functions',
28 'Time' => 'Time-related functions',
29 'User' => 'Fetching user and group info',
30 'Namespace' => 'Keywords altering or affecting scoping of identifiers',
31);
32
33@Type_Order = qw{
34 String
35 Regexp
36 Math
37 ARRAY
38 LIST
39 HASH
40 I/O
41 Binary
42 File
43 Flow
44 Namespace
45 Misc
46 Process
47 Modules
48 Objects
49 Socket
50 SysV
51 User
52 Network
53 Time
54};
55
56while (<DATA>) {
57 chomp;
58 s/#.*//;
59 next unless $_;
60 ($name, $type, $text) = split " ", $_, 3;
61 $Type{$name} = $type;
62 $Flavor{$name} = $text;
63 for $type ( split /[,\s]+/, $type ) {
64 push @{$Kinds{$type}}, $name;
65 }
66}
67
68unless (caller) {
69 foreach $type ( @Type_Order ) {
70 $list = join(", ", sort @{$Kinds{$type}});
71 $typedesc = $Type_Description{$type} . ":";
72 write;
73 }
74}
75
76format =
77
78^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
79 $typedesc
80~~ ^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
81 $typedesc
82 ~~ ^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
83 $list
84.
85
861
87
88__DATA__
89-X File a file test (-r, -x, etc)
90abs Math absolute value function
91accept Socket accept an incoming socket connect
92alarm Process schedule a SIGALRM
93atan2 Math arctangent of Y/X
94bind Socket binds an address to a socket
95binmode I/O prepare binary files on old systems
96bless Objects create an object
97caller Flow,Namespace get context of the current subroutine call
98chdir File change your current working directory
99chmod File changes the permissions on a list of files
100chomp String remove a trailing record separator from a string
101chop String remove the last character from a string
102chown File change the owership on a list of files
103chr String get character this number represents
104chroot File make directory new root for path lookups
105close I/O close file (or pipe or socket) handle
106closedir I/O close directory handle
107connect Socket connect to a remove socket
108continue Flow optional trailing block in a while or foreach
109cos Math cosine function
110crypt String one-way passwd-style encryption
111dbmclose Objects,I/O breaks binding on a tied dbm file
112dbmopen Objects,I/O create binding on a tied dbm file
113defined Misc test whether a value, variable, or function is defined
114delete HASH deletes a value from a hash
115die I/O,Flow raise an exception or bail out
116do Flow,Modules turn a BLOCK into a TERM
117dump Misc,Flow create an immediate core dump
118each HASH retrieve the next key/value pair from a hash
119endgrent User be done using group file
120endhostent User be done using hosts file
121endnetent User be done using networks file
122endprotoent Network be done using protocols file
123endpwent User be done using passwd file
124endservent Network be done using services file
125eof I/O test a filehandle for its end
126eval Flow,Misc catch exceptions or compile code
127exec Process abandon this program to run another
128exists HASH test whether a hash key is present
129exit Flow terminate this program
130exp Math raise I<e> to a power
131fcntl File file control system all
132fileno I/O return file descriptor from filehandle
133flock I/O lock an entire file with an advisory lock
134fork Process create a new process just like this one
135format I/O declare a picture format with use by the write() function
136formline Misc internal function used for formats
137getc I/O get the next character from the filehandle
138getgrent User get next group record
139getgrgid User get group record given group user ID
140getgrnam User get group record given group name
141gethostbyaddr Network get host record given its address
142gethostbyname Network get host record given name
143gethostent Network get next hosts record
144getlogin User return who logged in at this tty
145getnetbyaddr Network get network record given its address
146getnetbyname Network get networks record given name
147getnetent Network get next networks record
148getpeername Socket find the other hend of a socket connection
149getpgrp Process get process group
150getppid Process get parent process ID
151getpriority Process get current nice value
152getprotobyname Network get protocol record given name
153getprotobynumber Network get protocol record numeric protocol
154getprotoent Network get next protocols record
155getpwent User get next passwd record
156getpwnam User get passwd record given user login name
157getpwuid User get passwd record given user ID
158getservbyname Network get services record given its name
159getservbyport Network get services record given numeric port
160getservent Network get next services record
161getsockname Socket retrieve the sockaddr for a given socket
162getsockopt Socket get socket options on a given socket
163glob File expand filenames using wildcards
164gmtime Time convert UNIX time into record or string using Greenwich time
165goto Flow create spaghetti code
166grep LIST locate elements in a list test true against a given criterion
167hex Math,String convert a string to a hexadecimal number
168import Modules,Namespace patch a module's namespace into your own
169index String find a substring within a string
170int Math get the integer portion of a number
171ioctl File system-dependent device control system call
172join LIST join a list into a string using a separator
173keys HASH retrieve list of indices from a hash
174kill Process send a signal to a process or process group
175last Flow exit a block prematurely
176lc String return lower-case version of a string
177lcfirst String return a string with just the next letter in lower case
178length String return the number of bytes in a string
179link File create a hard link in the filesytem
180listen Socket register your socket as a server
181local Misc,Namespace create a temporary value for a global variable (dynamic scoping)
182localtime Time convert UNIX time into record or string using local time
183log Math retrieve the natural logarithm for a number
184lstat File stat a symbolic link
185m// Regexp match a string with a regular expression pattern
186map LIST apply a change to a list to get back a new list with the changes
187mkdir File create a directory
188msgctl SysV SysV IPC message control operations
189msgget SysV get SysV IPC message queue
190msgrcv SysV receive a SysV IPC message from a message queue
191msgsnd SysV send a SysV IPC message to a message queue
192my Misc,Namespace declare and assign a local variable (lexical scoping)
193next Flow iterate a block prematurely
194no Modules unimport some module symbols or semantics at compile time
195package Modules,Objects,Namespace declare a separate global namespace
196oct String,Math convert a string to an octal number
197open File open a file, pipe, or descriptor
198opendir File open a directory
199ord String find a character's numeric representation
200pack Binary,String convert a list into a binary representation
201pipe Process open a pair of connected filehandles
202pop ARRAY remove the last element from an array and return it
203pos Regexp find or set the offset for the last/next m//g search
204print I/O output a list to a filehandle
205printf I/O output a formatted list to a filehandle
206push ARRAY append one or more elements to an array
207q/STRING/ String singly quote a string
208qq/STRING/ String doubly quote a string
209quotemeta Regexp quote regular expression magic characters
210qw/STRING/ LIST quote a list of words
211qx/STRING/ Process backquote quote a string
212rand Math retrieve the next pseudorandom number
213read I/O,Binary fixed-length buffered input from a filehandle
214readdir I/O get a directory from a directory handle
215readlink File determine where a symbolic link is pointing
216recv Socket receive a message over a Socket
217redo Flow start this loop iteration over again
218ref Objects find out the type of thing being referenced
219rename File change a filename
220require Modules load in external functions from a library at runtime
221reset Misc clear all variables of a given name
222return Flow get out of a function early
223reverse String,LIST flip a string or a list
224rewinddir I/O reset directory handle
225rindex String right-to-left substring search
226rmdir File remove a directory
227s/// Regexp replace a pattern with a string
228scalar Misc force a scalar context
229seek I/O reposition file pointer for random-access I/O
230seekdir I/O reposition directory pointer
231select I/O reset default output or do I/O multiplexing
232semctl SysV SysV semaphore control operations
233semget SysV get set of SysV semaphores
234semop SysV SysV semaphore operations
235send Socket send a message over a socket
236setgrent User prepare group file for use
237sethostent Network prepare hosts file for use
238setnetent Network prepare networks file for use
239setpgrp Process set the process group of a process
240setpriority Process set a process's nice value
241setprotoent Network prepare protocols file for use
242setpwent User prepare passwd file for use
243setservent Network prepare services file for use
244setsockopt Socket set some socket options
245shift ARRAY remove the first element of an array, and return it
246shmctl SysV SysV shared memory operations
247shmget SysV get SysV shared memory segment identifier
248shmread SysV read SysV shared memory
249shmwrite SysV write SysV shared memory
250shutdown Socket close down just half of a socket connection
251sin Math return the sin of a number
252sleep Process block for some number of seconds
253socket Socket create a socket
254socketpair Socket create a pair of sockets
255sort LIST sort a list of values
256splice ARRAY add or remove elements anywhere in an array
257split Regexp split up a string using a regexp delimiter
258sprintf String formatted print into a string
259sqrt Math square root function
260srand Math seed the random number generator
261stat File get a file's status information
262study Regexp optimize input data for repeated searches
263sub Flow declare a subroutine, possibly anonymously
264substr String get or alter a portion of a stirng
265symlink File create a symbolic link to a file
266syscall I/O,Binary execute an arbitrary system call
267sysread I/O,Binary fixed-length unbuffered input from a filehandle
268system Process run a separate program
269syswrite I/O,Binary fixed-length unbuffered output to a filehandle
270tell I/O get current seekpointer on a filehandle
271telldir I/O get current seekpointer on a directory handle
272tie Objects bind a variable to an object class
273time Time return number of seconds since 1970
274times Process,Time return elapsed time for self and child processes
275tr/// String transliterate a string
276truncate I/O shorten a file
277uc String return upper-case version of a string
278ucfirst String return a string with just the next letter in upper case
279umask File set file creation mode mask
280undef Misc remove a variable or function definition
281unlink File remove one link to a file
282unpack Binary,LIST convert binary structure into normal perl variables
283unshift ARRAY prepend more elements to the beginning of a list
284untie Objects break a tie binding to a variable
285use Modules,Namespace load a module and import its namespace
286use Objects load in a module at compile time
287utime File set a file's last access and modify times
288values HASH return a list of the values in a hash
289vec Binary test or set particular bits in a string
290wait Process wait for any child process to die
291waitpid Process wait for a particular child process to die
292wantarray Misc,Flow get list vs array context of current subroutine call
293warn I/O print debugging info
294write I/O print a picture record
295y/// String transliterate a string