Services_JSON
[ class tree: Services_JSON ] [ index: Services_JSON ] [ all elements ]
Packages:
linea21-core
linea21-externals
linea21-languages
linea21-modules
linea21-templates
linea21-utils
Services_JSON


Files:
JSON.php

Classes:
Services_JSON
Services_JSON_Error

Class: Services_JSON

Source Location: /library/connectors/php/inc/JSON.php

Class Overview




Converts to and from JSON format.









        






Methods
























Class Details



[line 115]

Converts to and from JSON format.

Brief example of use:
  1.  // create a new instance of Services_JSON
    2. 

  2.  $json = new Services_JSON();
    3. 

  3.  
    4. 

  4.  // convert a complexe value to JSON notation, and send it to the browser
    5. 

  5.  $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
    6. 

  6.  $output = $json->encode($value);
    7. 

  7.  
    8. 

  8.  print($output);
    9. 

  9.  // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
    10. 

  10.  
    11. 

  11.  // accept incoming POST data, assumed to be in JSON notation
    12. 

  12.  $input = file_get_contents('php://input', 1000000);
    13. 

  13.  $value = $json->decode($input);
    14. 






[ Top ]








Class Methods




  

	
	
constructor Services_JSON [line 133]

	

    

    

		Services_JSON Services_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 ]

  

  

	
	
method decode [line 484]

	

    

    

		mixed decode(
string
$str)
    

    


	
		decodes a JSON string into appropriate variable





Tags:





  

    return:  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
  









	
        
Parameters:

    

    

          

        string  
        $str  
        JSON-formatted string
      

        

    


        
[ Top ]

  

  

	
	
method encode [line 237]

	

    

    

		mixed encode(
mixed
$var)
    

    


	
		encodes an arbitrary variable into JSON format





Tags:





  

    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 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!
      

        

    


        
[ Top ]

  

  

	
	
method isError [line 766]

	

    

    

		void isError(

$data, [
$code = null])
    

    


	
		



Tags:





  

    todo:  Ultimately, this should just call PEAR::isError()
  









	
        
Parameters:

    

    

          

          
        $data  
        
      

          

          
        $code  
        
      

        

    


        
[ Top ]

  






        

		    

		    Documentation generated on Thu, 03 May 2012 15:05:17 +0200 by phpDocumentor 1.4.1