phplib7.2 模版功能函数说明

王朝php·作者佚名  2006-01-09
窄屏简体版  字體: |||超大  

Template($root = ".", $unknowns = "remove")

构造函数:root为存放模版文件的目录,默认为根目录

unknowns为对未知变量的处理方法,remove为删除模版中未知变量,keep为保留模版中的未知变量,comment为把未知变量转换为HTML注释,默认为remove。

set_root($root)

效验所给参数root是否为目录,如果是则把该目录设置为摸版文件放置的目录。

set_unknowns($unknowns = "keep")

设置对未知变量的处理方式

set_file($handle, $filename = "")

为每个模版文件定义初始化一个变量,在以后的处理中用该变量代替该模版文件。

函数调用参数可以为成对的handle/filename或是由下标为handle值为filename的数组

set_block($parent, $handle, $name = "")

参数parent中包含了由参数handle的值命名的块,该函数将该块删除并用参数name中的值生成新的模版块变量代替,同时设置handle只包含原块中的模版变量,如果name变量省略则认为该块和handle相同。

例:

在box模版中包含row块:

<!-- start box.ihtml -->

<table border=1 bgcolor="#cccccc" cellpadding=4 cellspacing=0>

<tr>

<td colspan=2><b>{TITLE}</b></td>

</tr>

<!-- BEGIN row -->

<tr>

<td>{NUM}</td>

<td>{BIGNUM}</td>

</tr>

<!-- END row -->

</table>

<!-- end box.ihtml -->

执行 $t->set_block("box", "row", "rows")后box变为:

<!-- start box.ihtml -->

<table border=1 bgcolor="#cccccc" cellpadding=4 cellspacing=0>

<tr>

<td colspan=2><b>{TITLE}</b></td>

</tr>

{rows}

</table>

<!-- end box.ihtml -->

row变为:{NUM}

{BIGNUM}

set_var($varname, $value = "")

设置模版变量的值,生成以模版变量名为键的数组,参数可以是成对的模版变量名+值对或是下标为$varname的数组

subst($handle)

模版变量置换函数,参数handle为包含要置换模版的句柄。函数总是先尝试加载handle表示的模版文件,在已经加载的情况下进行handle所包含的模版变量的置换。

psubst($handle)

调用subst函数并打印出结果

parse($target, $handle, $append = false)

该函数调用subst函数对handle模版句柄中的全部变量进行置换,并保存或添加到以target为句柄的模版变量中,参数append控制是仅保存还是添加到target中

pparse($target, $handle, $append = false)

调用parse函数并打印出结果。

get_vars()

返回所有定义了的模版句柄变量和值,实际上是遍历类的成员变量varkeys,varvals这两个数组最后返回以varkeys的值为键,varvals的值为值的数组

get_var($varname)

读取以varname为名的模版变量,参数varname可以为数组,则返回的是数字索引的模版变量数组

get_undefined($handle)

返回handle模版中没有被处理的模版变量

finish($str)

根据成员变量unknowns对传入的字符串中的未处理变量进行处理,生成输出前的可选项。

p($varname)

打印调用finish函数后的字符串

get($varname)

返回经调用finish()函数处理的由get_var($varname)取得的模版字符串

haltmsg($msg)

打印出错信息

Internal instance methods//内部方法

filename($filename)

返回模版文件filename的绝对路径,并检查文件是否存在。

varname($varname)

loadfile($handle)

装载模版文件,如handle为句柄的模版变量没有被设置则其所在的文件将被加载,同时设置该模版变量。

halt($msg)

发生错误时停止运行,显示出错信息。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
 
 
© 2005- 王朝網路 版權所有 導航