Merge branch 'rcsheets-docstring-cleanup'

[civicrm-core.git] / api / v3 / examples / Contact / FormatIsSuccess_Fail.php

diff --git a/api/v3/examples/Contact/FormatIsSuccess_Fail.php b/api/v3/examples/Contact/FormatIsSuccess_Fail.php
index 481580e94fbc3ba3d2460e7f8df1222e1f641751..c8241ae9fcaebb56e4ef50c1d664368e2ab0c27e 100644 (file)
--- a/api/v3/examples/Contact/FormatIsSuccess_Fail.php
+++ b/api/v3/examples/Contact/FormatIsSuccess_Fail.php
@@ -1,29 +1,37 @@
 <?php
-
-/*
- This demonstrates use of the 'format.is_success' param.
-    This param causes only the success or otherwise of the function to be returned as BOOLEAN
+/**
+ * Test Generated example of using contact create API
+ * This demonstrates use of the 'format.is_success' param.
+    This param causes only the success or otherwise of the function to be returned as BOOLEAN *
  */
 function contact_create_example(){
 $params = array(
-  'version' => 3,
   'id' => 500,
   'format.is_success' => 1,
 );
 
-  $result = civicrm_api( 'contact','create',$params );
+try{
+  $result = civicrm_api3('contact', 'create', $params);
+}
+catch (CiviCRM_API3_Exception $e) {
+  // handle error here
+  $errorMessage = $e->getMessage();
+  $errorCode = $e->getErrorCode();
+  $errorData = $e->getExtraParams();
+  return array('error' => $errorMessage, 'error_code' => $errorCode, 'error_data' => $errorData);
+}
 
-  return $result;
+return $result;
 }
 
-/*
+/**
  * Function returns array of result expected from previous function
  */
 function contact_create_expectedresult(){
 
   $expectedResult = 0;
 
-  return $expectedResult  ;
+  return $expectedResult;
 }
 
 
@@ -31,20 +39,20 @@ function contact_create_expectedresult(){
 * This example has been generated from the API test suite. The test that created it is called
 *
 * testContactCreateFormatIsSuccessFalse and can be found in
-* http://svn.civicrm.org/civicrm/trunk/tests/phpunit/CiviTest/api/v3/ContactTest.php
+* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/ContactTest.php
 *
 * You can see the outcome of the API tests at
-* http://tests.dev.civicrm.org/trunk/results-api_v3
+* https://test.civicrm.org/job/CiviCRM-master-git/
 *
 * To Learn about the API read
-* http://book.civicrm.org/developer/current/techniques/api/
+* http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
 *
-* and review the wiki at
-* http://wiki.civicrm.org/confluence/display/CRMDOC/CiviCRM+Public+APIs
+* Browse the api on your own site with the api explorer
+* http://MYSITE.ORG/path/to/civicrm/api/explorer
 *
 * Read more about testing here
 * http://wiki.civicrm.org/confluence/display/CRM/Testing
 *
 * API Standards documentation:
 * http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
-*/
\ No newline at end of file
+*/