https://github.com/owensd/json-swift

A basic library for working with JSON in Swift.
https://github.com/owensd/json-swift

Last synced: 14 days ago
JSON representation

A basic library for working with JSON in Swift.

• Host: GitHub
• URL: https://github.com/owensd/json-swift
• Owner: owensd
• License: mit
• Created: 2014-06-21T08:22:30.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-05-26T04:45:59.000Z (over 7 years ago)
• Last Synced: 2024-07-31T18:17:31.977Z (3 months ago)
• Language: Swift
• Size: 24.6 MB
• Stars: 722
• Watchers: 21
• Forks: 75
• Open Issues: 2
• Metadata Files:
  • Readme: ReadMe.md
  • License: License

Awesome Lists containing this project

• awesome-swift-cn - json-swift - A basic library for working with JSON in Swift. (Libs / Data Management)
• awesome-swift - json-swift - A basic library for working with JSON in Swift. (JSON/XML Manipulation)

README

        
json-swift

==========

![build status badge](https://travis-ci.org/owensd/json-swift.svg?branch=master)

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`. This allows for easier use for deep indexing. In

addition, there is an `Optional` 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](http://owensd.io/2014/08/06/functional-json.html).

**Initializing a JSON value**

```swift

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

```swift

if let stat = json["stat"].string {

    println("stat = '\(stat)'")

    // prints: stat = 'ok'

}

```

**Retrieve error information from a missing key lookup**

```swift

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

 

```swift   

if let blogs = json["blogs"]["blog"].array {

    for blog in blogs {

        println("blog: \(blog)")

    }

}

```

  

See `JSValueTests.Usage.swift` for more usage samples.