瀏覽代碼

Improved documentation

Yannick Warnier 14 年之前
父節點
當前提交
b209a0111b
共有 1 個文件被更改,包括 6 次插入3 次删除
  1. 6 3
      main/inc/lib/main_api.lib.php

+ 6 - 3
main/inc/lib/main_api.lib.php

@@ -3219,9 +3219,12 @@ function api_status_exists($status_asked) {
 }
 
 /**
- * Checks whether status given in parameter exists in the platform
- * @param mixed the status (can be either int either string)
- * @return true if the status exists, else returns false
+ * Checks whether status given in parameter exists in the platform. The function
+ * returns the status ID or false if it does not exist, but given the fact there
+ * is no "0" status, the return value can be checked against
+ * if(api_status_key()) to know if it exists.
+ * @param   mixed   The status (can be either int or string)
+ * @return  mixed   Status ID if exists, false otherwise
  */
 function api_status_key($status) {
 	global $_status_list;