Merge branch '4.5' of https://github.com/civicrm/civicrm-core

[civicrm-core.git] / api / class.api.php

diff --git a/api/class.api.php b/api/class.api.php
index 04032c876961affcc1babd7799c62ff94551bb0a..7112996141c197594ec90edccb20bd48b5b620cc 100644 (file)
--- a/api/class.api.php
+++ b/api/class.api.php
@@ -126,14 +126,14 @@ class civicrm_api3 {
   }
 
   /**
-   *
+   * @return string
    */
   public function __toString() {
     return json_encode($this->lastResult);
   }
 
   /**
-   *
+   * Perform action
    */
   public function __call($action, $params) {
     // @TODO Check if it's a valid action.
@@ -154,7 +154,8 @@ class civicrm_api3 {
   }
 
   /**
-   *
+   * Call via rest
+   * @return stdClass
    */
   function remoteCall($entity, $action, $params = array()) {
     $fields = "key={$this->key}&api_key={$this->api_key}";
@@ -198,6 +199,13 @@ class civicrm_api3 {
     return $res;
   }
 
+  /**
+   * @param $entity
+   * @param string $action
+   * @param array $params
+   *
+   * @return bool
+   */
   function call($entity, $action = 'Get', $params = array()) {
     if (is_int($params)) {
       $params = array('id' => $params);
@@ -246,20 +254,21 @@ class civicrm_api3 {
 
   /**
    * Return the last error message.
+   * @return string
    */
   function errorMsg() {
     return $this->lastResult->error_message;
   }
 
   /**
-   *
+   * Initialize
    */
   function init() {
     CRM_Core_DAO::init($this->cfg->dsn);
   }
 
   /**
-   *
+   * @return $this
    */
   public function attr($name, $value = NULL) {
     if ($value === NULL) {
@@ -274,21 +283,22 @@ class civicrm_api3 {
   }
 
   /**
-   *
+   * @return bool
    */
   public function is_error() {
     return (property_exists($this->lastResult, 'is_error') && $this->lastResult->is_error);
   }
 
   /**
-   *
+   * @param string $name
+   * @return bool
    */
   public function is_set($name) {
     return (isset($this->lastResult->$name));
   }
 
   /**
-   *
+   * @return $this
    */
   public function __get($name) {
     // @TODO Test if valid entity.
@@ -313,6 +323,7 @@ class civicrm_api3 {
 
   /**
    * Or use $api->value.
+   * @return array
    */
   public function values() {
     if (is_array($this->lastResult)) {
@@ -325,6 +336,7 @@ class civicrm_api3 {
 
   /**
    * Or use $api->result.
+   * @return array
    */
   public function result() {
     return $this->lastResult;