perl 附录一 函数集(未定稿)

一、进程处理函数

1、进程启动函数

函数名 eval
调用语法 eval(string)
解说 将string看作Perl语句执行。
正确执行后，系统变量$@为空串，如果有错误，$@中为错误信息。
例子 $print = "print (\"hello,world\\n\");";
eval ($print);
结果输出 hello, world


函数名 system
调用语法 system(list)
解说 list中第一个元素为程序名，其余为参数。
system启动一个进程运行程序并等待其结束，程序结束后错误代码左移八位成为返回值。
例子 @proglist = ("echo", "hello,world!");
system(@proglist);
结果输出 hello, world!


函数名 fork
调用语法 procid = fork();
解说 创建程序的两个拷贝--父进程和子进程--同时运行。子进程返回零，父进程返回非零值，此值为子程序的进程ID号。
例子 $retval = fork();
if ($retval == 0) {
  # this is the child process
  exit; # this terminates the child process
} else {
  # this is the parent process
}
结果输出 无


函数名 pipe
调用语法 pipe (infile, outfile);
解说 与fork合用，给父进程和子进程提供通信的方式。送到outfile文件变量的信息可以通过infile文件变量读取。步骤：
1、调用pipe
2、用fork将程序分成父进程和子进程
3、一个进程关掉infile，另一个关掉outfile
例子 pipe (INPUT, OUTPUT);
$retval = fork();
if ($retval != 0) {
  # this is the parent process
  close (INPUT);
  print ("Enter a line of input:\n");
  $line = <STDIN>;
  print OUTPUT ($line);
} else {
  # this is the child process
  close (OUTPUT);
  $line = <INPUT>;
  print ($line);
  exit (0);
}

结果输出 $
program
Enter a line of input:
Here is a test line
Here is a test line
$


函数名 exec
调用语法 exec (list);
解说 与system类似，区别是启动新进程前结束当前程序。常与fork合用，当fork分成两个进程后，子进程用exec启动另一个程序。
例子   
结果输出  


函数名 syscall
调用语法 syscall (list);
解说 调用系统函数，list第一个元素是系统调用名，其余为参数。
如果参数是数字，就转化成C的整型数(type int)。否则传递字符串的指针。详见UNIX的帮助或Perl文档。
使用syscall必须包含文件syscall.pl，即：
require ("syscall.ph"); 
例子  
结果输出  


2、进程终止函数


函数名 die
调用语法 die (message);
解说 终止程序并向STDERR输出错误信息。message可以为字符串或列表。如果最后一个参数不包含换行符，则程序文件名和行号也被输出。
例子 die ("Cannot open input file");
结果输出 Cannot open input file at myprog line 6.


函数名 warn
调用语法 warn (message);
解说 与die类似，区别是不终止程序。
例子 warn("Danger! Danger!\n");
结果输出 Danger! Danger!


函数名 exit
调用语法 exit (retcode);
解说 终止程序并指定返回值。
例子 exit(2);
结果输出 无


函数名 kill
调用语法 kill (signal, proclist);
解说 给一组进程发送信号。
signal是发送的数字信号，9为杀掉进程。
proclist是进程ID列表。详见kill的UNIX帮助。
例子  
结果输出  


3、进程控制函数

函数名 sleep
调用语法 sleep (time);
解说 将程序暂停一段时间。time是停止的秒数。返回值为实际停止的秒数。
例子 sleep (5);
结果输出 无


函数名 wait
调用语法 procid = wait();
解说 暂停程序执行，等待子进程终止。
不需要参数，返回值为子进程ID，如果没有子进程，返回-1。
例子  
结果输出  


函数名 waitpid
调用语法 waitpid (procid, waitflag);
解说 暂停程序执行，等待特定的子进程终止。procid为等待的进程ID
例子 $procid = fork();
if ($procid == 0) {
  # this is the child process
  print ("this line is printed first\n");
  exit(0);
} else {
  # this is the parent process
  waitpid ($procid, 0);
  print ("this line is printed last\n");
}
结果输出 $ program
this line is printed first
this line is printed last
$


4、其它控制函数

函数名 caller
调用语法 subinfo = caller();
解说 返回调用者的程序名和行号，用于Perl Debugger。
返回值为三元素的列表：
1、调用处的包名
2、调用者文件名
3、调用处的行号
例子  
结果输出  


函数名 chroot
调用语法 chroot (dir);
解说 改变程序的根目录，详见chroot帮助。
例子  
结果输出  


函数名 local
调用语法 local($variable);
解说 在语句块(由大括号包围的语句集合)中定义局域变量，仅在此语句块中起作用，对其的改变不对块外同名变量造成影响。
千万不要在循环中使用，否则每次循环都定义一个新的局域变量！
例子  
结果输出  


函数名 times
调用语法 timelist = times
解说 返回该程序及所有子进程消耗的工作时间。
返回值为四个浮点数的列表：
1、程序耗用的用户时间
2、程序耗用的系统时间
3、子进程耗用的用户时间
4、子进程耗用的系统时间
例子  
结果输出  


二、数学函数

函数名 sin
调用语法 retval = sin (value);
解说 参数为弧度值。


函数名 cos
调用语法 retval = cos (value);
解说 参数为弧度值。


函数名 atan2
调用语法 retval = atan2 (value1, value2);
解说 运算并返回value1除以value2结果的arctan值，单位为弧度，范围在-PI~PI。
应用例：
角度转化成弧度子程序。 sub degrees_to_radians {
  local ($degrees) = @_;
  local ($radians);11:
  $radians = atan2(1,1) * $degrees / 45;
}


函数名 sqrt
调用语法 retval = sqrt (value);
解说 平方根函数。value为非负数。


函数名 exp
调用语法 retval = exp (value);
解说 返回e的value次方。


函数名 log
调用语法 retval = log (value);
解说 以e为底的自然对数。


函数名 abs
调用语法 retval = abs (value);
解说 绝对值函数。(Perl 4中没有)


函数名 rand
调用语法 retval = rand (num);
解说 随机数函数，返回0和整数num之间的一个浮点数。


函数名 srand
调用语法 srand (value);
解说 初始化随机数生成器。保证每次调用rand真正随机。


三、字符串处理函数

函数名 index
调用语法 position = index (string, substring, position);
解说 返回子串substring在字符串string中的位置，如果不存在则返回-1。参数position是可选项，表示匹配之前跳过的字符数，或者说从该位置开始匹配。


函数名 rindex
调用语法 position = rindex (string, substring, position);
解说 与index类似，区别是从右端匹配。


函数名 length
调用语法 num = length (string);
解说 返回字符串长度，或者说含有字符的数目。


函数名 pos
调用语法 offset = pos(string);
解说 返回最后一次模式匹配的位置。


函数名 substr
调用语法 substr (expr, skipchars, length)
解说 抽取字符串（或表达式生成的字符串）expr中的子串，跳过skipchars个字符，或者说从位置skipchars开始抽取子串（第一个字符位置为0），子串长度为length，此参数可忽略，意味着取剩下的全部字符。
当此函数出现在等式左边时，expr必须为变量或数组元素，此时其中部分子串被等式右边的值替换。


函数名 study
调用语法 study (scalar);
解说 用一种内部格式提高变量的访问速度，同一时刻只对一个变量起作用。


函数名 lc
uc
调用语法 retval = lc(string);
retval = uc(string);
解说 将字符串全部转换成小/大写字母。


函数名 lcfirst
ucfirst
调用语法 retval = lcfirst(string);
retval = ucfirst(string);
解说 将第一个字母转换成小/大写。


函数名 quotameta
调用语法 newstring = quotemeta(oldstring);
解说 将非单词的字母前面加上反斜线(\)。
语句 ： $string = quotemeta($string);
等效于：$string =~ s/(\W)/\\$1/g;
常用于模式匹配操作中，确保字符串中没有字符被看作匹配操作符。


函数名 join
调用语法 join (joinstr, list);
解说 把字符串列表(数组)组合成一个长的字符串，在每两个列表元素间插入串joinstr。


函数名 sprintf
调用语法 sprintf (string, fields);
解说 与printf类似，区别是结果不输出到文件，而作为返回值赋给变量。
例子 $num = 26;
$outstr = sprintf("%d = %x hexadecimal or %o octal\n",$num, $num, $num);
print ($outstr);
结果输出 26 = 1a hexadecimal or 32 octal


四、标量转换函数

函数名 chop
调用语法 $lastchar = chop (var);
解说 var可为变量或数组，当var为变量时，最后一个字符被删除并赋给$lastchar，当var为数组/列表时，所有元素的最后一个字符被删除，最后一个元素的最后一个字母赋给$lastchar。


函数名 chomp
调用语法 result = chomp(var);
解说 检查字符串或字符串列表中元素的最后一个字符是否为由系统变量$/定义的行分隔符，如果是就删除。返回值为实际删除的字符个数。


函数名 crypt
调用语法 result = crypt (original, salt);
解说 用DES算法加密字符串，original是将要加密的字符串，salt是两个字符的字符串，定义如何改变DES算法，以使更难解码。返回值为加密后的串。


函数名 hex
调用语法 decnum = hex (hexnum);
解说 将十六进制数(字符串形式)转化为十进制数。


函数名 int
调用语法 intnum = int (floatnum);
解说 将浮点数舍去小数部分转化为整型数。


函数名 oct
调用语法 decnum = oct (octnum);
解说 将八进制数(字符串形式)或十六进制数("0x.."形式)转化为十进制数。


函数名 ord
调用语法 asciival = ord (char);
解说 返回单个字符的ASCII值，与PASCAL中同名函数类似。


函数名 chr
调用语法 $char = chr (asciival);
解说 返回ASCII值的相应字符，与PASCAL中同名函数类似。


函数名 pack
调用语法 formatstr = pack(packformat, list);
解说 把一个列表或数组以在实际机器存贮格式或C等编程语言使用的格式转化（包装）到一个简单变量中。参数packformat包含一个或多个格式字符，列表中每个元素对应一个，各格式字符间可用空格或tab隔开，因为pack忽略空格。
  除了格式a、A和@外，重复使用一种格式多次可在其后加个整数，如：
   $twoints = pack ("i2", 103, 241);
  把同一格式应用于所有的元素则加个*号，如：
   $manyints = pack ("i*", 14, 26, 11, 83);
  对于a和A而言，其后的整数表示要创建的字符串长度，重复方法如下：
   $strings = pack ("a6" x 2, "test1", "test2");
  格式@的情况比较特殊，其后必须加个整数，该数表示字符串必须的长度，如果长度不够，则用空字符(null)补足，如：
   $output = pack ("a @6 a", "test", "test2");
  pack函数最常见的用途是创建可与C程序交互的数据，例如C语言中字符串均以空字符(null)结尾，创建这样的数据可以这样做：
   $Cstring = pack ("ax", $mystring);
  下表是一些格式字符与C中数据类型的等价关系：

字符    等价C数据类型
C char
d double
f float
i int
I unsigned int (or unsigned)
l long
L unsigned long
s short
S unsigned short

  完整的格式字符见下表。 


格式字符    描述
a 用空字符(null)补足的字符串
A 用空格补足的字符串
b 位串，低位在前
B 位串，高位在前
c 带符号字符（通常-128~127）
C 无符号字符（通常8位）
d 双精度浮点数
f 单精度浮点数
h 十六进制数串，低位在前
H 十六进制数串，高位在前
i 带符号整数
I 无符号整数
l 带符号长整数
L 无符号长整数
n 网络序短整数
N 网络序长整数
p 字符串指针
s 带符号短整数
S 无符号短整数
u 转化成uuencode格式
v VAX序短整数
V VAX序长整数
x 一个空字节
X 回退一个字节
@ 以空字节(null)填充


函数名 unpack
调用语法 @list = unpack (packformat, formatstr);
解说 unpack与pack功能相反，将以机器格式存贮的值转化成Perl中值的列表。其格式字符与pack基本相同（即上表），不同的有：A格式将机器格式字符串转化为Perl字符串并去掉尾部所有空格或空字符；x为跳过一个字节；@为跳过一些字节到指定的位置，如@4为跳过4个字节。下面看一个@和X合同的例子：    $longrightint = unpack ("@* X4 L", $packstring);
  此语句将最后四个字节看作无符号长整数进行转化。下面看一个对uuencode文件解码的例子：

1 : #!/usr/local/bin/perl
2 :
3 : open (CODEDFILE, "/u/janedoe/codefile") ||
4 : die ("Can't open input file");
5 : open (OUTFILE, ">outfile") ||
6 : die ("Can't open output file");
7 : while ($line = <CODEDFILE>) {
8 : $decoded = unpack("u", $line);
9 : print OUTFILE ($decoded);
10: }
11: close (OUTFILE);
12: close (CODEDFILE);
  当将pack和unpack用于uuencode时，要记住，虽然它们与UNIX中的uuencode、uudecode工具算法相同，但并不提供首行和末行，如果想用uudecode对由pack的输出创建的文件进行解码，必须也把首行和末行输出（详见UNIX中uuencode帮助）。



函数名 vec
调用语法 retval = vec (vector, index, bits);
解说 顾名思义，vec即矢量(vector)函数，它把简单变量vector的值看作多块(维)数据，每块含一定数目的位，合起来即一个矢量数据。每次的调用访问其中一块数据，可以读取，也可以写入。参数index就象数组下标一样，提出访问哪一块，0为第一块，依次类推，要注意的是访问次序是从右到左的，即第一块在最右边。参数bits指定每块中的位数，可以为1,2,4,8,16或32。
例子 1 : #!/usr/local/bin/perl
2 :
3 : $vector = pack ("B*", "11010011");
4 : $val1 = vec ($vector, 0, 4);
5 : $val2 = vec ($vector, 1, 4);
6 : print ("high-to-low order values: $val1 and $val2\n");
7 : $vector = pack ("b*", "11010011");
8 : $val1 = vec ($vector, 0, 4);
9 : $val2 = vec ($vector, 1, 4);
10: print ("low-to-high order values: $val1 and $val2\n"); 
结果 high-to-low order values: 3 and 13
low-to-high order values: 11 and 12


函数名 defined
调用语法 retval = defined (expr);
解说 判断一个变量、数组或数组的一个元素是否已经被赋值。expr为变量名、数组名或一个数组元素。
如果已定义，返回真，否则返回假。


函数名 undef
调用语法 retval = undef (expr);
解说 取消变量、数组或数组元素甚至子程序的定义，回收其空间。返回值始终为未定义值，此值与空串等效。


五、数组和列表函数

函数名 grep
调用语法 @foundlist = grep (pattern, @searchlist);
解说 与同名的UNIX查找工具类似，grep函数在列表中抽取与指定模式匹配的元素，参数pattern为欲查找的模式，返回值是匹配元素的列表。
例子 @list = ("This", "is", "a", "test");
@foundlist = grep(/^[tT]/, @list);
结果 @foundlist = ("This", "test");


函数名 splice
调用语法 @retval = splice (@array, slipelements, length, @newlist);
解说   拼接函数可以向列表（数组）中间插入元素、删除子列表或替换子列表。参数skipelements是拼接前跳过的元素数目，length是被替换的元素数，newlist是将要拼接进来的列表。当newlist的长度大于length时，后面的元素自动后移，反之则向前缩进。因此，当length=0时，就相当于向列表中插入元素，而形如语句
  splice (@array, -1, 0, "Hello");
则向数组末尾添加元素。而当newlist为空时就相当于删除子列表，这时，如果length为空，就从第skipelements个元素后全部删除，而删除最后一个元素则为：splice (@array, -1);这种情况下，返回值为被删去的元素列表。


函数名 shift
调用语法 element = shift (@arrayvar);
解说 删去数组第一个元素，剩下元素前移，返回被删去的元素。不加参数时，缺省地对@ARGV进行操作。


函数名 unshift
调用语法 count = unshift (@arrayver, elements);
解说 作用与shift相反，在数组arrayvar开头增加一个或多个元素，返回值为结果(列表)的长度。等价于splice (@array, 0, 0, elements);


函数名 push
调用语法 push (@arrayvar, elements);
解说 在数组末尾增加一个或多个元素。等价于slice (@array, @array, 0, elements);


函数名 pop
调用语法 element = pop (@arrayvar);
解说 与push作用相反，删去列表最后一个元素，并将其作为返回值，当列表已空，则返回“未定义值”(即空串)。


函数名 split
调用语法 @list = split (pattern, string, maxlength);
解说 将字符串分割成一组元素的列表。每匹配一次pattern，就开始一个新元素，但pattern本身不包含在元素中。maxlength是可选项，当指定它时，达到该长度就不再分割。


函数名 sort
调用语法 @sorted = sort (@list);
解说 按字母次序给列表排序。


函数名 reverse
调用语法 @reversed = reverse (@list);
解说 按字母反序给列表排序。


函数名 map
调用语法 @resultlist = map (expr, @list);
解说 此函数在Perl5中定义，可以把列表中的各个元素作为表达式expr的操作数进行运算，其本身不改变，结果作为返回值。在表达式expr中，系统变量$_代表各个元素。
例子 1、@list = (100, 200, 300);
   @results = map ($_+1, @list);
2、@results = map (&mysub($_), @list);
结果 1、(101, 201, 301)
2、无


函数名 wantarray
调用语法 result = wantarray();
解说 Perl中，一些内置函数的行为根据其处理简单变量还是数组有所不同，如chop。自定义的子程序也可以定义这样两种行为。当子程序被期望返回列表时，此函数返回值为非零值(真)，否则为零值(假)。
例子 1 : #!/usr/local/bin/perl
2 :
3 : @array = &mysub();
4 : $scalar = &mysub();
5 :
6 : sub mysub {
7 : if (wantarray()) {
8 : print ("true\n");
9 : } else {
10: print ("false\n");
11: }
12: } 
结果 $program
true
false
$


六、关联数组函数

函数名 keys
调用语法 @list = keys (%assoc_array);
解说 返回关联数组无序的下标列表。


函数名 values
调用语法 @list = values (%assoc_array);
解说 返回关联数组无序的值列表。


函数名 each
调用语法 @pair = each (%assoc_array);
解说 返回两个元素的列表--键值对（即下标和相应的值），同样无序。当关联数组已空，则返回空列表。


函数名 delete
调用语法 element = delete (assoc_array_item);
解说 删除关联数组中的元素，并将其值作为返回值。
例子 %array = ("foo", 26, "bar", 17");
$retval = delete ($array{"foo"});
结果 $retval = 26;


函数名 exists
调用语法 result = exists (element);
解说 在Perl5中定义，判断关联数组中是否存在某元素，若存在，返回非零值(真)，否则返回零值(假)。
例子 $result = exists ($myarray{$mykey});