A basic library for working with JSON in Swift.
A practical JSON parsing library for Swift. It provides a fully typed and validated API surface for
working with JSON, including the ability to base64 items with your JSON.
All of the JSON APIs return back of Optional<T>
. This allows for easier use for deep indexing. In
addition, there is an Optional<JSValue>
wrapper for all indexers and accessors which removes all
of the ?
jumping that is normally required.
Also, there is a functional API set for the library as well. For an in-depth overview of that, see:
Functional JSON.
Initializing a JSON value
let json : JSON = [
"stat": "ok",
"blogs": [
"blog": [
[
"id" : 73,
"name" : "Bloxus test",
"needspassword" : true,
"url" : "http://remote.bloxus.com/"
],
[
"id" : 74,
"name" : "Manila Test",
"needspassword" : false,
"url" : "http://flickrtest1.userland.com/"
]
]
]
]
Retrieve data from JSON
if let stat = json["stat"].string {
println("stat = '\(stat)'")
// prints: stat = 'ok'
}
Retrieve error information from a missing key lookup
let stat = json["stats"]
if let value = stat.string {
println("stat = '\(value)'")
}
else if let error = stat.error {
println("code: \(error.code), domain: '\(error.domain)', info: '\(error.userInfo[LocalizedDescriptionKey]!)'")
// prints: code: 6, domain: 'com.kiadstudios.json.error', info: 'There is no value stored with key: 'stats'.'
}
Iterate over the contents of an array
if let blogs = json["blogs"]["blog"].array {
for blog in blogs {
println("blog: \(blog)")
}
}
See JSValueTests.Usage.swift
for more usage samples.