parseJSONObject() / Reference / Processing.org

Name

parseJSONObject()

Description

Takes a String, parses its contents, and returns a JSONObject. If the String does not contain JSONObject data or cannot be parsed, a null value is returned.

parseJSONObject() is most useful when pulling data dynamically, such as from third-party APIs. Normally, API results would be saved to a String, and then can be converted to a structured JSONObject using parseJSONObject(). Be sure to check if null is returned before performing operations on the new JSONObject in case the String content could not be parsed.

If your data already exists as a JSON file in the data folder, it is simpler to use loadJSONObject().

Examples

String data = "{ \"id\": 0, \"species\": \"Panthera leo\", \"name\": \"Lion\"}";

void setup() {
  JSONObject json = parseJSONObject(data);
  if (json == null) {
    println("JSONObject could not be parsed");
  } else {
    String species = json.getString("species");
    println(species);
  }
}

// Sketch prints:
// Panthera leo

Syntax

parseJSONObject(input)

Parameters

input(String)String to parse as a JSONObject

Return

JSONObject

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Name