ProductPromotion
Logo

Swift

made by https://0x3d.site

GitHub - lobodart/CheatyXML: CheatyXML is a Swift framework designed to manage XML easily
CheatyXML is a Swift framework designed to manage XML easily - lobodart/CheatyXML
Visit Site

GitHub - lobodart/CheatyXML: CheatyXML is a Swift framework designed to manage XML easily

GitHub - lobodart/CheatyXML: CheatyXML is a Swift framework designed to manage XML easily

CheatyXML

CocoaPods Build Status codecov

CheatyXML is a Swift framework designed to manage XML easily.

Requirements

  • iOS 8.0 or later
  • tvOS 9.0 or later

Installation

Cocoapods

If you're using cocoapods, just add pod 'CheatyXML' into your Podfile file.

Manual

To install this, simply add the .xcodeproj to your project, and do not forget to link the .framework.

Whenever you want to use it in your code, simply type:

import CheatyXML

Usage

Let's take the following XML content for all of our examples:

<blog version="1.0" creator="lobodart">
    <name>MyAwesomeBlog!</name>
    <users>
        <admin is_active="true">lobodart</admin>
        <moderator is_active="false">slash705</moderator>
        <moderator is_active="...">...</moderator>
        ...
    </users>
    <article>
        <title>My first article</title>
        <description>This is the first article</description>
        <infos>
            <date>2015-03-15 15:42:42</date>
            <rate>42</rate>
        </infos>
        ...
    </article>
    <article>
        ...
    </article>
    ...
</blog>

Creating parser instance

Using an URL
let parser: CXMLParser! = CXMLParser(contentsOfURL: ...) // URL
Using a string
let parser: CXMLParser! = CXMLParser(string: ...) // String
Using data
let parser: CXMLParser! = CXMLParser(data: ...) // Data

Retrieving an element using tags

Suppose we want to retrieve the name of our example:

let blogName: String! = parser["name"].stringValue // Returns a String
let blogName: String? = parser["name"].string // Returns an optional String

You can also use the rootElement if you to make your code clearer:

let element = parser.rootElement["name"] // is the same as the notation seen before

To access deeper elements, just chain :

let blogAdmin: String! = parser["users"]["admin"].stringValue
print(blogAdmin) // lobodart

Working with multiple elements

Now let's take a look at the article element. We can see that our blog contains a few articles.

Get an element using its index

If we want to get the title of the first article, we can do it like this:

let firstArticleTitle: String! = parser["article", 0]["title"].stringValue
let firstArticleTitle: String! = parser["article"][0]["title"].stringValue

Both notations have the same effect. Choose the one you like most.

Browse children of an element

To iterate over all children of an element, just use the for in classic syntax:

for element in parser.rootElement {
    print(element.tagName)
}

This code will give us :

name
users
article
article
...

Now, to iterate over specific children of an element, the code is almost the same:

for element in parser.rootElement.elementsNamed("article") {
    print(element.tagName)
}

This time, it will give us :

article
article
...

Of course, you can use this method on any deeper elements (like users for example).

Number of children of an element

If you want to get the total number of children contained in an element, you can use this code:

// Suppose we have 3 moderators in our example
let numberOfElements: Int = parser["users"].numberOfChildElements
print(numberOfElements) // 4 (3 moderators + 1 admin)

Note that this code counts all child elements contained in users. Now suppose we want to get the number of moderators only. There are 2 different syntaxes. Once again, choose your favorite:

let numberOfElements: Int = parser["users"]["moderator"].count
let numberOfElements: Int = parser["users"].elementsNamed("moderator").count

Type casting

CheatyXML allows you to cast tag/attribute values into some common types. You can get either optional or non-optional value for your cast.

let firstArticleRate = parser["article", 0]["rate"]
firstArticleRate.int // Optional(42)
firstArticleRate.intValue // 42
firstArticleRate.float // Optional(42.0)
firstArticleRate.floatValue // 42.0

If you are not sure about the type, use the optional cast. If you try to cast a value with an inappropriate caster, your app will crash.

let firstArticleTitle = parser["article", 0]["title"]
firstArticleTitle.string // Optional("My first article")
firstArticleTitle.stringValue // "My first article"
firstArticleTitle.int // nil
firstArticleTitle.intValue // CRASH!

Missing tags

Until now, we always retrieved existing tags but what would happen if a tag doesn't exist? Let's take an example:

let articleDate: String! = parser["article", 0]["infos"]["date"].stringValue
print(articleDate) // 2015-03-15 15:42:42
let articleDateFail: String! = parser["articles", 0]["infos"]["date"].string // I intentionally add an 's' to 'article'
print(articleDateFail) // nil
Note

If you have any doubt, keep in mind that using .string is safer than using .stringValue. In the previous example, using .stringValue on articleDateFail will result in your application to crash.

Attributes

Get one

let blogVersion = parser.rootElement.attribute("version")
let adminIsActive = parser["users"]["admin"].attribute("is_active")

You can also use the type casting on attributes:

let blogVersion = parser.rootElement.attribute("version").floatValue // 1.0
let creator = parser.rootElement.attribute("creator").stringValue // "lobodart"

Get all

let attributes = parser.rootElement.attributes // Will give you a [CXMLAttribute]
let dic = attributes.dictionary // Will give you a [String: String]

TO-DO

  • Add more Unit Tests
  • Class mapping
  • XML Generator

More Resources
to explore the angular.

mail [email protected] to add your project or resources here ๐Ÿ”ฅ.

Related Articles
to learn about angular.

FAQ's
to learn more about Angular JS.

mail [email protected] to add more queries here ๐Ÿ”.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory