This reference is for Processing 2.0+. If you have a previous version, use the reference included with your software. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Javadoc.

Name | ### loadJSONArray()
Examples |
    // The following short JSON file called "data.json" is parsed
    // in the code below. It must be in the project's "data" folder.
    //
    // [
    //   {
    //     "id": 0,
    //     "species": "Capra hircus",
    //     "name": "Goat"
    //   },
    //   {
    //     "id": 1,
    //     "species": "Panthera pardus",
    //     "name": "Leopard"
    //   },
    //   {
    //     "id": 2,
    //     "species": "Equus zebra",
    //     "name": "Zebra"
    //   }
    // ]

    JSONArray values;

    void setup() {

      values = loadJSONArray("data.json");

      for (int i = 0; i < values.size(); i++) {

        JSONObject animal = values.getJSONObject(i);

        int id = animal.getInt("id");
        String species = animal.getString("species");
        String name = animal.getString("name");

        println(id + ", " + species + ", " + name);
      }
    }

    // Sketch prints:
    // 0, Capra hircus, Goat
    // 1, Panthera pardus, Leopard
    // 2, Equus zebra, Zebra
Description | Loads an array of JSON objects from the data folder or a URL, and returns a JSONArray. Per standard JSON syntax, the array must be enclosed in a pair of hard brackets [], and each object within the array must be separated by a comma. All files loaded and saved by the Processing API use UTF-8 encoding.
Syntax |
    loadJSONArray(filename)
    loadJSONArray(file)
Parameters |
filename | String: name of a file in the data folder or a URL
Returns | JSONArray
Related | JSONObject JSONArray loadJSONObject() saveJSONObject() saveJSONArray()

Updated on May 19, 2014 05:30:00pm PDT