Converts to and from JSON format. More...

Public Member Functions
	__construct ($use=0)
	constructs a new JSON instance
	decode ($str)
	decodes a JSON string into appropriate variable
	encode ($var, $pretty=false)
	encodes an arbitrary variable into JSON format
	encode2 ($var)
	encodes an arbitrary variable into JSON format
	isError ($data, $code=null)
	name_value ($name, $value)
	array-walking function for use in generating JSON-formatted name-value pairs
	reduce_string ($str)
	reduce a string by removing leading and trailing comments and whitespace
	utf162utf8 ($utf16)
	convert a string from one UTF-16 char to one UTF-8 char
	utf82utf16 ($utf8)
	convert a string from one UTF-8 char to one UTF-16 char
Static Private Member Functions
static	pearInstalled ()
	Returns cached result of class_exists('pear'), to avoid calling AutoLoader numerous times in cases when PEAR is not present.
Static Private Attributes
static	$mHavePear = null

Detailed Description

Converts to and from JSON format.

Brief example of use:

// create a new instance of Services_JSON $json = new Services_JSON();

// convert a complexe value to JSON notation, and send it to the browser $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4))); $output = $json->encode($value);

print($output); // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]

// accept incoming POST data, assumed to be in JSON notation $input = file_get_contents('php://input', 1000000); $value = $json->decode($input);

Definition at line 117 of file Services_JSON.php.

Constructor & Destructor Documentation

Services_JSON::__construct ( $ use = 0 )

constructs a new JSON instance

Parameters:

$use	Integer: 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()

Definition at line 135 of file Services_JSON.php.

Member Function Documentation

Services_JSON::decode ( $ str )

decodes a JSON string into appropriate variable

Parameters:

$str	String: JSON-formatted string

Returns:: mixed number, boolean, string, array, or object corresponding to given JSON input string. See argument 1 to Services_JSON() above for object-output behavior. Note that decode() always returns strings in ASCII or UTF-8 format!

Access:: public

Definition at line 539 of file Services_JSON.php.

References reduce_string(), and utf162utf8().

Here is the call graph for this function:

Services_JSON::encode	(	$	var,
		$	pretty = `false`
	)

encodes an arbitrary variable into JSON format

Parameters:

$var	Mixed: any number, boolean, string, array, or object to be encoded. see argument 1 to Services_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!
$pretty	Boolean: pretty-print output with indents and newlines

Returns:: mixed JSON string representation of input var or an error if a problem occurs

Access:: public

Definition at line 278 of file Services_JSON.php.

References encode2().

Referenced by MakeLanguageSpec\writeJavascriptFile().

Here is the call graph for this function:

Here is the caller graph for this function:

Services_JSON::encode2 ( $ var )

encodes an arbitrary variable into JSON format

Parameters:

$var	Mixed: any number, boolean, string, array, or object to be encoded. see argument 1 to Services_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!