ChinaPerl

函数名 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});