文檔中的每個函數都有快速參考,學會如何閱讀和理解文檔將使得 PHP 的使用更加簡單。和依賴賴於復制/粘貼範例比起來,您一定更希望知道如何閱讀函數的定義(函數原型):
函數定義告訴我們函數返回什麼類型的值,讓我們用函數 strlen() 的定義作為我們的第一個範例:
strlen (PHP 3, PHP 4 >= 4.0.0) strlen -- Get string length Description int strlen ( string str ) Returns the length of string. |
表格 S-1. 函數定義
組成部分 | 說明 |
---|---|
strlen | 函數名稱 |
(PHP 3, PHP 4 >= 4.0.0) | strlen() 在 PHP 3 和 PHP 4 中都存在 |
int | 該函數返回的值的類型,這裡為 integer。(例如,字符串的長度是以數字來衡量的) |
( string str ) | 第一個(本例中是唯一的)參數,在該函數中名為 str,且類型為 string。 |
我們可以將以上函數的定義寫成一般形式:
返回類型 函數名 ( 參數類型 參數名 ) |
很多函數都有多個變量,例如 in_array()。其函數原型如下:
bool in_array ( mixed needle, array haystack [, bool strict]) |
這是什麼意思?in_array() 返回一個“布爾”值,成功(即在參數 haystack 中能找到參數 needle)則返回 TRUE 或者失敗(即在參數 haystack 中找不到參數 needle)則返回 FALSE。第一個參數被命名為 needle 且其類型不定,因此我們將其稱為“混和”類型。該混和類型的 needle 參數(我們要找的對像)可以適一個純量的值(字符串、整數、或者浮點),或者一個數組。haystack (我們尋找的範圍)是第二個參數。第三個可選參數被命名為 strict。所有的可選參數都用 [ 方括號 ] 引用。手冊表明 strict 參數默認值為布爾值 FALSE。需要了解函數工作的細節,請參閱手冊中和該函數相關的頁面。