home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3171 / perl-descr.txt < prev    next >
Encoding:
Text File  |  1991-04-08  |  9.5 KB  |  312 lines

  1. # @(#)@ perl-descr.txt 1.7 - describe-perl-symbol [text] Perl 4.000
  2. !=    Numeric inequality.
  3. !~    Search pattern, substitution, or translation (negated).
  4. $!    If used in a numeric context, yields the current value of errno. If used in a string context, yields the corresponding error string.
  5. $"    The separator which joins elements of arrays interpolated in strings.
  6. $#    The output format for printed numbers. Initial value is %.20g.
  7. $$    The process number of the perl running this script. Altered (in the child process) by fork().
  8. $%    The current page number of the currently selected output channel.
  9. $&    The string matched by the last pattern match.
  10. $'    The string following what was matched by the last pattern match.
  11. $(    The real gid of this process.
  12. $)    The effective gid of this process.
  13. $*    Set to 1 to do multiline matching within a string, 0 to assume strings contain a single line. Default is 0.
  14. $+    The last bracket matched by the last search pattern.
  15. $,    The output field separator for the print operator.
  16. $-    The number of lines left on the page.
  17. $.    The current input line number of the last filehandle that was read.
  18. $/    The input record separator, newline by default.
  19. $0    The name of the file containing the perl script being executed. May be set
  20. $1..    Contains the subpattern from the corresponding set of parentheses in the last pattern matched.
  21. $:    The set of characters after which a string may be broken to fill continuation fields (starting with ^) in a format.
  22. $;    The subscript separator for multi-dimensional array emulation. Default is "\034".
  23. $<    The real uid of this process.
  24. $=    The page length of the current output channel. Default is 60 lines.
  25. $>    The effective uid of this process.
  26. $?    The status returned by the last backtick (``) command, pipe close or system operator.
  27. $@    The perl error message from the last eval or do @var{EXPR} command.
  28. $ARGV    The name of the current file used with <> .
  29. $[    The index of the first element in an array, and of the first character in a substring. Default is 0.
  30. $\    The output record separator for the print operator.
  31. $]    The perl version string as displayed with perl -v.
  32. $^    The name of the current top-of-page format. See also $^D, $^I, $^P, $^T, $^W
  33. $^D    The value of the perl debug (-D) flags.
  34. $^I    The value of the in-place edit extension (perl -i option).
  35. $^P    The name under which perl was invoked (argv[0]).
  36. $^T    The time the script was started. Used by -A/-M/-C file tests.
  37. $^W    True is warnings are requested (perl -w flag).
  38. $_    The default input and pattern-searching space.
  39. $`    The string preceding what was matched by the last pattern match.
  40. $|    If set to nonzero, forces a flush after every write or print on the currently selected output channel. Default is 0. The following variables are always local to the current block:
  41. $~    The name of the current report format.
  42. %    Modulo division.
  43. %ENV    Contains the current environment.
  44. %INC    List of files that have been require-d or do-ne.
  45. %SIG    Used to set signal handlers for various signals.
  46. &    Bitwise and.    && Logical and.
  47. &&    Logical and.
  48. *    Multiplication.    ** Exponentiation,
  49. **    Exponentiation.
  50. *NAME    Refers to all objects represented by NAME. *NAM1 = *NAM2 makes NAM1 a reference to NAM2.
  51. +    Addition.    ++ Auto-increment
  52. ++    Auto-increment (magical on strings).
  53. ,    Comma operator.
  54. -    Subtraction.    -- Auto-decrement.
  55. --    Auto-decrement.
  56. -A    Access time in days since script started.
  57. -B    File is a non-text (binary) file.
  58. -C    Creation time in days since script started.
  59. -M    Age in days since script started.
  60. -O    File is owned by real uid.
  61. -R    File is readable by real uid.
  62. -S    File is a socket .
  63. -T    File is a text file.
  64. -W    File is writable by real uid.
  65. -X    File is executable by real uid.
  66. -b    File is a block special file.
  67. -c    File is a character special file.
  68. -d    File is a directory.
  69. -e    File exists .
  70. -f    File is a plain file.
  71. -g    File has setgid bit set.
  72. -k    File has sticky bit set.
  73. -l    File is a symbolic link.
  74. -o    File is owned by effective uid.
  75. -p    File is a named pipe (FIFO).
  76. -r    File is readable by effective uid.
  77. -s    File has non-zero size.
  78. -t    Tests if filehandle (STDIN by default) is opened to a tty.
  79. -u    File has setuid bit set.
  80. -w    File is writable by effective uid.
  81. -x    File is executable by effective uid.
  82. -z    File has zero size.
  83. .    Concatenate strings.    ..    Alternation, also range operator.
  84. ..    Alternation, also range operator.
  85. /    Division.    /PATTERN/io    Pattern match
  86. /PATTERN/io    Pattern match.
  87. <    Numeric less than.    <<    Bitwise shift left.
  88. <<    Bitwise shift left.
  89. <=    Numeric less than or equal to.    <=> Numeric compare.
  90. <=>    Numeric compare.
  91. ==    Numeric equality.    =~    Search pattern, substitution, or translation
  92. >    Numeric greater than.    >=    Numeric greater than or equal to.
  93. >=    Numeric greater than or equal to.    >>    Bitwise shift right.
  94. >>    Bitwise shift right.
  95. ? :    Alternation (if-then-else) operator.    ?PATTERN?    Backwards pattern match
  96. @ARGV    Contains the command line arguments for the script (not including the command name). See $0 for the command name.
  97. @INC    Contains the list of places to look for perl scripts to be evaluated by the do EXPR command.
  98. @_    Parameter array for subroutines. Also used by split if not in array context.
  99. \0    Octal char, e.g. \033.
  100. \E    Case modification terminator. See \L and \U .
  101. \L    Lowercase until \E .
  102. \U    Upcase until \E .
  103. \a    Alarm character (octal 007).
  104. \b    Backspace character (octal 010).
  105. \c    Control character, e.g. \c[ .
  106. \e    Escape character (octal 033).
  107. \f    Formfeed character (octal 014).
  108. \l    Lowercase of next character. See also \L and \u,
  109. \n    Newline character (octal 012).
  110. \r    Return character (octal 015).
  111. \t    Tab character (octal 011).
  112. \u    Upcase  of next character. See also \U and \l,
  113. \x    Hex character, e.g. \x1b.
  114. ^    Bitwise exclusive or.
  115. accept(NEWSOCKET,GENERICSOCKET)
  116. alarm(SECONDS)
  117. atan2(X,Y)
  118. bind(SOCKET,NAME)
  119. binmode(FILEHANDLE)
  120. caller[(LEVEL)]
  121. chdir(EXPR)
  122. chmod(LIST)
  123. chop[(LIST|VAR)]
  124. chown(LIST)
  125. chroot(FILENAME)
  126. close(FILEHANDLE)
  127. closedir(DIRHANDLE)
  128. cmp    String compare.
  129. connect(SOCKET,NAME)
  130. cos(EXPR)
  131. crypt(PLAINTEXT,SALT)
  132. dbmclose(ASSOC_ARRAY)
  133. dbmopen(ASSOC,DBNAME,MODE)
  134. defined(EXPR)
  135. delete($ASSOC{KEY})
  136. die(LIST)
  137. do { ... }|SUBR while|until EXPR    executes at least once
  138. do(EXPR|SUBR([LIST]))
  139. dump(LABEL)
  140. each(ASSOC_ARRAY)
  141. endgrent
  142. endhostent
  143. endnetent
  144. endprotoent
  145. endpwent
  146. endservent
  147. eof[([FILEHANDLE])]
  148. eq    String equality.
  149. eval(EXPR)
  150. exec(LIST)
  151. exit(EXPR)
  152. exp(EXPR)
  153. fcntl(FILEHANDLE,FUNCTION,SCALAR)
  154. fileno(FILEHANDLE)
  155. flock(FILEHANDLE,OPERATION)
  156. for (EXPR;EXPR;EXPR) { ... }
  157. foreach [VAR] (@ARRAY) { ... }
  158. fork
  159. ge    String greater than or equal.
  160. getc[(FILEHANDLE)]
  161. getgrent
  162. getgrgid(GID)
  163. getgrnam(NAME)
  164. gethostbyaddr(ADDR,ADDRTYPE)
  165. gethostbyname(NAME)
  166. gethostent
  167. getlogin
  168. getnetbyaddr(ADDR,ADDRTYPE)
  169. getnetbyname(NAME)
  170. getnetent
  171. getpeername(SOCKET)
  172. getpgrp(PID)
  173. getppid
  174. getpriority(WHICH,WHO)
  175. getprotobyname(NAME)
  176. getprotobynumber(NUMBER)
  177. getprotoent
  178. getpwent
  179. getpwnam(NAME)
  180. getpwuid(UID)
  181. getservbyname(NAME,PROTO)
  182. getservbyport(PORT,PROTO)
  183. getservent
  184. getsockname(SOCKET)
  185. getsockopt(SOCKET,LEVEL,OPTNAME)
  186. gmtime(EXPR)
  187. goto(LABEL)
  188. grep(EXPR,LIST)
  189. gt    String greater than.
  190. hex(EXPR)
  191. if (EXPR) { ... } [ elsif (EXPR) { ... } ... ] [ else { ... } ] or EXPR if EXPR
  192. index(STR,SUBSTR[,OFFSET])
  193. int(EXPR)
  194. ioctl(FILEHANDLE,FUNCTION,SCALAR)
  195. join(EXPR,LIST)
  196. keys(ASSOC_ARRAY)
  197. kill(LIST)
  198. last[(LABEL)]
  199. le    String less than or equal.
  200. length(EXPR)
  201. link(OLDFILE,NEWFILE)
  202. listen(SOCKET,QUEUESIZE)
  203. local(LIST)
  204. localtime(EXPR)
  205. log(EXPR)
  206. lstat(EXPR|FILEHANDLE|VAR)
  207. lt    String less than.
  208. m/PATTERN/io
  209. mkdir(FILENAME,MODE)
  210. msgctl(ID,CMD,ARG)
  211. msgget(KEY,FLAGS)
  212. msgrcv(ID,VAR,SIZE,TYPE.FLAGS)
  213. msgsnd(ID,MSG,FLAGS)
  214. ne    String inequality.
  215. next[(LABEL)]
  216. oct(EXPR)
  217. open(FILEHANDLE[,EXPR])
  218. opendir(DIRHANDLE,EXPR)
  219. ord(EXPR)
  220. pack(TEMPLATE,LIST)
  221. package    Introduces package context.
  222. pipe(READHANDLE,WRITEHANDLE)
  223. pop(ARRAY)
  224. print[(FILEHANDLE [LIST])]
  225. printf([FILEHANDLE] LIST)
  226. push(ARRAY,LIST)
  227. q/STRING/    Synonym for 'STRING'
  228. qq/STRING/    Synonym for "STRING"
  229. qx/STRING/    Synonym for `STRING`
  230. rand[(EXPR)]
  231. read(FILEHANDLE,SCALAR,LENGTH[,OFFSET])
  232. readdir(DIRHANDLE)
  233. readlink(EXPR)
  234. recv(SOCKET,SCALAR,LEN,FLAGS)
  235. redo[(LABEL)]
  236. rename(OLDNAME,NEWNAME)
  237. require [FILENAME]
  238. reset[(EXPR)]
  239. return(LIST)
  240. reverse(LIST)
  241. rewinddir(DIRHANDLE)
  242. rindex(STR,SUBSTR[,OFFSET])
  243. rmdir(FILENAME)
  244. s/PATTERN/REPLACEMENT/gieo
  245. scalar(EXPR)
  246. seek(FILEHANDLE,POSITION,WHENCE)
  247. seekdir(DIRHANDLE,POS)
  248. select(FILEHANDLE | RBITS,WBITS,EBITS,TIMEOUT)
  249. semctl(ID,SEMNUM,CMD,ARG)
  250. semget(KEY,NSEMS,SIZE,FLAGS)
  251. semop(KEY,...)
  252. send(SOCKET,MSG,FLAGS[,TO])
  253. setgrent
  254. sethostent(STAYOPEN)
  255. setnetent(STAYOPEN)
  256. setpgrp(PID,PGRP)
  257. setpriority(WHICH,WHO,PRIORITY)
  258. setprotoent(STAYOPEN)
  259. setpwent
  260. setservent(STAYOPEN)
  261. setsockopt(SOCKET,LEVEL,OPTNAME,OPTVAL)
  262. shift[(ARRAY)]
  263. shmctl(ID,CMD,ARG)
  264. shmget(KEY,SIZE,FLAGS)
  265. shmread(ID,VAR,POS,SIZE)
  266. shmwrite(ID,STRING,POS,SIZE)
  267. shutdown(SOCKET,HOW)
  268. sin(EXPR)
  269. sleep[(EXPR)]
  270. socket(SOCKET,DOMAIN,TYPE,PROTOCOL)
  271. socketpair(SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL)
  272. sort([SUBROUTINE] LIST)
  273. splice(ARRAY,OFFSET[,LENGTH[,LIST]])
  274. split[(/PATTERN/[,EXPR[,LIMIT]])]
  275. sprintf(FORMAT,LIST)
  276. sqrt(EXPR)
  277. srand(EXPR)
  278. stat(EXPR|FILEHANDLE|VAR)
  279. study[(SCALAR)]
  280. substr(EXPR,OFFSET[,LEN])
  281. symlink(OLDFILE,NEWFILE)
  282. syscall(LIST)
  283. sysread(FILEHANDLE,SCALAR,LENGTH[,OFFSET])
  284. system(LIST)
  285. syswrite(FILEHANDLE,SCALAR,LENGTH[,OFFSET])
  286. tell[(FILEHANDLE)]
  287. telldir(DIRHANDLE)
  288. time
  289. times
  290. tr/SEARCHLIST/REPLACEMENTLIST/cds
  291. truncate(FILE|EXPR,LENGTH)
  292. umask[(EXPR)]
  293. undef[(EXPR)]
  294. unless (EXPR) { ... } [ else { ... } ] or EXPR unless EXPR
  295. unlink(LIST)
  296. unpack(TEMPLATE,EXPR)
  297. unshift(ARRAY,LIST)
  298. until (EXPR) { ... } or EXPR until EXPR
  299. utime(LIST)
  300. values(ASSOC_ARRAY)
  301. vec(EXPR,OFFSET,BITS)
  302. wait
  303. waitpid(PID,FLAGS)
  304. wantarray
  305. warn(LIST)
  306. while  (EXPR) { ... } or EXPR while EXPR
  307. write[(EXPR|FILEHANDLE)]
  308. x    Repeat string or array.
  309. y/SEARCHLIST/REPLACEMENTLIST/
  310. |    Bitwise or.    ||    Logical or.
  311. ||    Logical or.
  312.