if_perl.cnx

Vim 中文文档

*if_perl.txt*   For Vim version 6.2.  原文最后更新: 2001年10月25日


		  VIM REFERENCE MANUAL    by Sven Verdoolaege
					 and Matt Gerassimof
			    (译者：[e-mail])


Perl 与 Vim						*perl* *Perl*

1. 编辑 Perl 文档		|perl-editing|
2. 编译带 Perl 接口的 VIM	|perl-comiling|
3. Perl 接口的使用		|perl-using|

{Vi 没有上述这些功能}
Perl 接口只有在编译 Vim 时加入 |+perl| 才能使用。

==============================================================================
1. 编辑 Perl 文件					*perl-editing*

Vim 语法高亮显示支持 Perl和POD文件。Vim假设后缀为.pl和.pm的文件时Perl文件。Vim
同时不管文件后缀而测试文件的首行来检查一个文件是否为Perl脚本(参见Vim的语法目录
下的scripts.vim)。Vim假设带后缀.POD的文件是POD文本。

要使用Perl标签，你需要Exuberant ctags的最新版本。在这里可以找到它们:
	http://ctags.sourceforge.net
当然，作为选择你还可以用一个叫pltags.pl的Perl脚本，它是和Vim一起发行的，他的藏
身之处位于$VIMRUNTIME/tools目录。现在这个脚本比Exuberant ctags的Perl支持具有更
多的功能。

==============================================================================
2. 编译带Perl接口的VIM					*perl-compiling*

为了能编译带Perl接口的Vim，你需要Perl5.004(或者更新)的版本。Perl必须在你编译Vim
前安装。Vim的Perl接口不能和官方发行的Perl5.003一起正常工作！它也许能和Perl5.003
_05或者更新版本一起正常工作。_[译者注]到翻译的时候，这个问题已经不会时大问题了_

Vim的Perl补丁由Sven Verdoolaege<[e-mail]>和Matt Gerassimof制
作。

Perl的 MS-Windows 版本可以在下面这个网址找到：
http://www.perl.com/CPAN/ports/nt/Standard/x86/

==============================================================================
3. Perl接口的使用					*perl-using*

							*:perl* *:pe*
:pe[rl] {cmd}		执行Perl命令{cmd}。当前包是“main”。

:pe[rl] << {endpattern}
{script}
{endpattern}
			执行Perl脚本{script}。
			{endpattern}不能由任何前导空格。如果忽略了{endpattern}，
			就会像|:append|和|:insert|命令那样默认到达一个点'.'。
			|:perl|命令的这种形式主要是用来在vim脚本里面包含perl代
			码。
			Note:当Perl没有被编译进vim了这条命令不能工作。为了避
			免出错请参考|script-here|。
vim脚本示例: >

	function! WhitePearl()
	perl << EOF
		VIM::Msg("pearls are nice for necklaces");
		VIM::Msg("rubys for rings");
		VIM::Msg("pythons for bags");
		VIM::Msg("tcls????");
	EOF
	endfunction
<

							*:perldo* *:perld*
:[range]perld[o] {cmd}  对[range]中的每行执行Perl命令{cmd},同时$_依次被设定
			为每行的文本，但不包括行尾的<EOL>。改变$_会改变每行
			的内容，但是用这个命令不能添加或者删除行。[range]的
			缺省值是整个文件:"1，$"。

可以试一下下面的代码: >

  :perl $a=1
  :perldo $_ = reverse($_);1
  :perl VIM::Msg("hello")
  :perl $line = $curbuf->Get(42)
<

							*E299*
在|sandbox|执行Perl命令是受限制的。":perldo"根本就不能执行。如果可能，":perl"
会在安全环境下被执行。

							*perl-overview*
下面是在Perl下可用的函数概要: >

  :perl VIM::Msg("Text")		# 显示信息
  :perl VIM::Msg("Error", "ErrorMsg")	# 显示错误信息
  :perl VIM::Msg("remark", "Comment")	# 显示突出的信息
  :perl VIM::SetOption("ai")		# 设定一个vim选项
  :perl $nbuf = VIM::Buffers()		# 返回缓冲区的个数
  :perl @buflist = VIM::Buffers()	# 返回所有缓冲区的数组
  :perl $mybuf = (VIM::Buffers('qq.c'))[0] # 返回一个'qq.c'的缓冲区对象
  :perl @winlist = VIM::Windows()	# 返回所有窗口的数组
  :perl $nwin = VIM::Windows()		# 返回窗口的个数
  :perl ($success, $v) = VIM::Eval('&path') # $v: option 'path', $success: 1
  :perl ($success, $v) = VIM::Eval('&xyz')  # $v: '' and $success: 0
  :perl $v = VIM::Eval('expand("<cfile>")') # 展开文件<cfile>
  :perl $curwin->SetHeight(10)		# 设定窗口高度
  :perl @pos = $curwin->Cursor()	# 返回坐标(row, col)
  :perl @pos = (10, 10)
  :perl $curwin->Cursor(@pos)		# 把光标位置设为@pos
  :perl $curwin->Cursor(10,10)		# 把光标位置设为第10行第10列
  :perl $mybuf = $curwin->Buffer()	# 返回窗口的缓冲区对象
  :perl $curbuf->Name()			# 返回缓冲区名字
  :perl $curbuf->Number()		# 返回缓冲区号码
  :perl $curbuf->Count()		# 返回行数
  :perl $l = $curbuf->Get(10)		# 返回第10行
  :perl @l = $curbuf->Get(1 .. 5)	# 返回第1到第5行
  :perl $curbuf->Delete(10)		# 删除第10行
  :perl $curbuf->Delete(10, 20)		# 删除第10－20行
  :perl $curbuf->Append(10, "Line")	# 在第10行后面添加一行
  :perl $curbuf->Append(10, "Line1", "Line2", "Line3") # 在第10行后面添加三行
  :perl @l = ("L1", "L2", "L3")
  :perl $curbuf->Append(10, @l)		# 添加 L1, L2 和 L3
  :perl $curbuf->Set(10, "Line")	# 替换第10行
  :perl $curbuf->Set(10, "Line1", "Line2")      # 替换第10行和第11行
  :perl $curbuf->Set(10, @l)		# 分别用L1，L2和L3替换10－12行
<
							*perl-Msg*
VIM::Msg({msg}, {group}?)
			显示消息{msg}。可选{group}参数指定用来显示这个消息的
			突出方式。

							*perl-SetOption*
VIM::SetOption({arg})
			设置一个vim选项。{arg}可以是任何":set"命令能接受的参数。
			这就意味着参数里面不允许有空格！见|:set|。

							*perl-Buffers*
VIM::Buffers([{bn}...]) 没有参数的时候，在列表上下文里面返回所有缓冲区的列表
			或者在标量上下文是返回缓冲区的个数。对于一个缓冲区名字
			列表或者数量{bn},返回匹配{bn}的缓冲区列表，与Vim内部函
			数|bufname()|使用同样的规则。

							*perl-Windows*
VIM::Windows([{wn}...]) 没有参数的时候，在列表上下文里面返回所有窗口的列表或者在
			标量上下文是返回窗口的个数。对于一个窗口名字数量列表{wn},
			返回匹配{wn}的窗口列表。

							*perl-DoCommand*
VIM::DoCommand({cmd})   执行 Ex 命令 {cmd}.

							*perl-Eval*
VIM::Eval({expr})       对{expr}求值并返回(success,val)。success=1表示val包含{expr}
			的值。success=0表示表达式求值失败。‘@x’返回寄存器x的内容，
			'&x'返回选项x的值，'x'返回内部变量x的值,'$x'等价鱼perl中的
			$ENV{x}。所有再命令行可以访问的函数都对{expr}有效。

							*perl-SetHeight*
Window->SetHeight({height})
			在屏幕允许的前提下把窗口的高度设定为{height}。

							*perl-GetCursor*
Window->Cursor({row}?, {col}?)
			在没有参数的情况下，返回窗口光标所处位置的坐标(row,col)。
			当有参数{row}和{col}的情况下，把窗口光标的位置设为{row}
			和{col}。注意{col}是Perl风格的，从0数起的，比Vim的尺度
			小1。

Window->Buffer()					*perl-Buffer*
			返回给定窗口的缓冲区对象。

							*perl-Name*
Buffer->Name()		返回缓冲区的文件名。

							*perl-Number*
Buffer->Number()	返回缓冲区的数量。

							*perl-Count*
Buffer->Count()		返回缓冲区中的行数。

							*perl-Get*
Buffer->Get({lnum}, {lnum}?, ...)
			对每个指定的{lnum},返回缓冲区中第{lnum}行的文本字符
			串。通过指定一个{lnum}列表可以传递一个数组。

							*perl-Delete*
Buffer->Delete({lnum}, {lnum}?)
			删除缓冲区的第{lnum}行。当有第二个参数{lnum}时，删除
			由第一个{lnum}到第二个{lnum}指定的范围。

							*perl-Append*
Buffer->Append({lnum}, {line}, {line}?, ...)
			把每个{line}字符串添加到缓冲区的第{lnum}行后面。{line}
			列表可以时一个数组。

							*perl-Set*
Buffer->Set({lnum}, {line}, {line}?, ...)
			替代缓冲区从第{lnum}行开始，由{lines}指定的一行或者躲行。
			{line}列表可以是一个数组。如果参数无效，替代就不会发生。
$main::curwin
			当前窗口对象。
$main::curbuf
			当前缓冲区对象。

							*script-here*
当使用嵌入式脚本语言是，你可能想在语言不支持时跳过这些。但是这个机制不能工作: >
   if has('perl')
     perl << EOF
       this will NOT work!
   EOF
   endif
取而代之，把Perl/Python/Ruby/等的命令放在一个函数里面并调用他: >
    if has('perl')
      function DefPerl()
	perl << EOF
	  this works
    EOF
      endfunction
      call DefPerl()
    endif
Note: "EOF"必须在行首(前面不能有前导空格)。

 vim:tw=78:ts=8:ft=help:norl: