Perl reference
Revision as of 21:56, 29 March 2006 by Woozle (talk | contribs) (→Pattern Matching (regex): three of these introduce significant overhead)
Reference for various things in Perl. See also Perl built-in functions.
Escape Sequences
| \a | bell (ctrl-G, 007 decimal) |
| \b | backspace (ctrl-H, 008 decimal) |
| \cn | ctrl-n |
| \e | ESC (027 decimal, 033 octal) |
| \f | FF |
| \l | converts next letter to lowercase |
| \n | newline - system-dependent (CRLF on DOS/Win) |
| \r | CR (013 decimal) |
| \t | TAB (ctrl-I, 009 decimal) |
| \u | converts next letter to uppercase |
| \L | converts all characters to lowercase, from here to next \E |
| \U | converts all characters to uppercase, from here to next \E |
| \E | ends case conversion started by \L or \U |
| \' | prints a literal single-quote |
| \" | prints a literal double-quote |
| \$ | prints a literal dollar sign |
| \\ | prints a literal backslash (not doubled) |
| \0nnn | prints the ASCII character numbered nnn in octal |
| \xnn | prints the ASCII character numbered nn in hexadecimal |
Operators
Arithmetic
| + | add | $x+$y |
| - | subtract | $x-$y |
| * | multiply | $x*$y |
| / | divide | $x/$y |
| % | modulo (remainder) | $x%$y -> remainder of x/y |
| ** | exponent | $x**$y -> xy |
| ++ | incrememt | $x++ or ++$x -> x is incremented by 1 |
| -- | decrement | $x-- or --$x -> x is decremented by 1 |
Comparisons | ||
| == | is equal | $x==$y returns true iff x equals y |
| != | is different | $x!=$y returns true iff x does not equal y |
| < | is less than | $x<$y returns true iff x is smaller than y |
| > | is more than | $x>$y returns true iff x is larger than y |
Strings | ||
| . | concatenate | $x.$y combines the strings in x and y |
| eq | strings are equal | $xeq$y returns true iff the two strings are identical |
| ne | strings are different | $xne$y returns true iff the two strings are different |
Other | ||
| ?: | conditional result | $a?$b:$c returns $b if $a is true, otherwise returns $c |
File Test Operators
All operators are used like this:
-x $filename
| -r | Is the file readable? |
| -w | Is the file writable? |
| -x | Is the file executable? |
| -e | Does the file exist? |
| -z | Is the file empty? (i.e. zero bytes) |
| -s | File length in bytes |
| -f | Is the file an ordinary file? |
| -d | Is the file a directory? |
| -l | Is the file a symbolic link? (UNIX/Linux only) |
| -p | Is file a named pipe? |
| -S | Is the file a socket? |
| -T | Is the file a text file? |
| -B | Is the file a binary file? (!-T) |
| -M | Number of days since file was last modified |
| -A | Number of days since file was last accessed |
Special Variables
| @ARGV | array of command-line arguments with which Perl was invoked |
| %ENV | hash of all environment variables (see http://vbz.net/cgi-bin/env for a sample listing) |
| $_ | The default input and pattern-searching space; default argument for many functions. |
| @_ | list of arguments passed to subroutine (usually in parentheses) |
| $0 | name of Perl program file (the outermost one; may or may not include path, depending on system (in Linux, it does not)) |
| $] | version number of the Perl interpreter |
| $[ | The index of the first element in an array, and of the first character in a substring. |
| $< | username of user running the Perl script (may not be very useful for CGI because Apache always executes as the same user) |
| $^X | filespec of the Perl interpreter |
| $/ | string to be used as input record separator; default = newline |
| $\ | string to be used as output record separator in print |
| ; | The subscript separator for multi-dimensional array emulation. |
| $. | The current input line number (or record number) of the last filehandle that was read. |
| $, | separator for printing arrays |
| $" | This is similar to "$," except that it applies to array values interpolated into a double-quoted string (or similar interpreted string) |
| $# | The output format for numbers display via print |
| $$ | The process number of the Perl running this script |
| $? | The status returned by the last pipe close, backtick(``) command or system operator. |
| $! | If used in a numeric context, yields the current value of errno, with all the usual caveats. (This means that you shouldn't depend on the value of $! to be anything in particular unless you've gotten a specific error return indicating a system error.) If used in a string context, yields the corresponding sysem error string. |
| $@ | The Perl syntax error or routine error message from the last eval, do-FILE, or require command. If set, either the compilation failed, or the die function was executed within the code of the eval. |
Output Flags | |
| If set to nonzero, forces a flush after every write or print | |
| $* | If set to zero, pattern-matching assumes that strings contain a single line (for optimization purposes). Default = 0 |
ReportingThese refer to the currently selected filehandle; each filehandle maintains its own set of variables. | |
| $% | Current page number |
| $= | Current page length |
| $- | Number of lines remaining on the page |
| $~ | Name of the current report format |
| $^ | Name of the current top-of-page format |
Pattern Matching (regex)These are associated with the last successful pattern match. | |
| $n | in the replacement section, indicate that the nth matched section in parentheses should be used here (first matched parentheses becomes $1, second becomes $2, etc., up through $9) |
| $& | Contains the string matched by the last pattern match. Introduces CPU/memory overhead for all regex operations in the script; avoid. |
| $` | The string preceding whatever was matched by the last pattern match, not counting patterns matched in nested blocks that have been exited already. Introduces CPU/memory overhead for all regex operations in the script; avoid. |
| $' | The string following whatever was matched by the last pattern match, not counting patterns matched in nested blockes that have been exited already. Introduces CPU/memory overhead for all regex operations in the script; avoid. |
| $+ | The last bracket matched by the last search pattern. This is useful if you don't know which of a set of alternative patterns matched. |
Portions of this were shamelessly copied from here, at least until more information can be found.