PHP 手冊
前一頁 | 附錄 Q. 關於本手冊 | 下一頁

# 如何閱讀函數的定義（函數原型）

文檔中的每個函數都有快速參考，學會如何閱讀和理解文檔將使得 PHP 的使用更加簡單。和依賴賴於復制/粘貼範例比起來，您一定更希望知道如何閱讀函數的定義（函數原型）：

> 先決條件：對“變量類型”的基本理解: 盡管 PHP 是亞類型語言，但對“變量類型”有一個基本的理解也是非常重要的，因為它們有重要的意義。

函數定義告訴我們函數返回什麼類型的值，讓我們用函數 strlen() 的定義作為我們的第一個範例：

    strlen

      (PHP 3, PHP 4 >= 4.0.0)
      strlen -- Get string length

      Description
      int strlen ( string str )

      Returns the length of string.

表格 Q-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`。需要了解函數工作的細節，請參閱手冊中和該函數相關的頁面。

前一頁 | 內容 | 下一頁
關於用戶注釋 | 上一層 | 本手冊中所涉及的 PHP 版本