phplib7.2 模版功能函數說明

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)
發生錯誤時停止運行,顯示出錯信息。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章