apidoc
[ class tree: apidoc ] [ index: apidoc ] [ all elements ]

Class: HTML_AJAX_JSON

Source Location: /HTML_AJAX-0.5.7/AJAX/JSON.php

Class Overview


Converts to and from JSON format.


Methods


Inherited Variables

Inherited Methods


Class Details

[line 126]
Converts to and from JSON format.

Brief example of use:

  1.  // create a new instance of HTML_AJAX_JSON
  2.  $json = new HTML_AJAX_JSON();
  3.  
  4.  // convert a complexe value to JSON notation, and send it to the browser
  5.  $value = array('foo''bar'array(12'baz')array(3array(4)));
  6.  $output $json->encode($value);
  7.  
  8.  print($output);
  9.  // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
  10.  
  11.  // accept incoming POST data, assumed to be in JSON notation
  12.  $input file_get_contents('php://input'1000000);
  13.  $value $json->decode($input);



[ Top ]


Method Detail

HTML_AJAX_JSON (Constructor)   [line 144]

HTML_AJAX_JSON HTML_AJAX_JSON( [int $use = 0])

constructs a new JSON instance

Parameters:

int   $use   — 

object behavior flags; combine with boolean-OR

possible values:

  • SERVICES_JSON_LOOSE_TYPE: loose typing. "{...}" syntax creates associative arrays instead of objects in decode().
  • SERVICES_JSON_SUPPRESS_ERRORS: error suppression. Values which can't be encoded (e.g. resources) appear as NULL instead of throwing errors. By default, a deeply-nested resource will bubble up with an error, so all return values from encode() should be checked with isError()


[ Top ]

decode   [line 486]

mixed decode( string $str)

decodes a JSON string into appropriate variable
  • Return: number, boolean, string, array, or object corresponding to given JSON input string. See argument 1 to HTML_AJAX_JSON() above for object-output behavior. Note that decode() always returns strings in ASCII or UTF-8 format!
  • Access: public

Parameters:

string   $str   —  JSON-formatted string

[ Top ]

encode   [line 246]

mixed encode( mixed $var)

encodes an arbitrary variable into JSON format
  • Return: JSON string representation of input var or an error if a problem occurs
  • Access: public

Parameters:

mixed   $var   —  any number, boolean, string, array, or object to be encoded. see argument 1 to HTML_AJAX_JSON() above for array-parsing behavior. if var is a strng, note that encode() always expects it to be in ASCII or UTF-8 format!

[ Top ]

isError   [line 763]

void isError( $data, [ $code = null])

  • Todo: Ultimately, this should just call PEAR::isError()

Parameters:

   $data   — 
   $code   — 

[ Top ]


Documentation generated on Mon, 11 Mar 2019 15:59:25 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.