Close Menu

swxmlhash


What is SWXMLHash?

SWXMLHash is a powerful and lightweight XML parsing library for Swift. It allows you to easily parse and manipulate XML data using a simple and intuitive syntax. Whether you need to parse XML from a file, a web service, or any other data source, SWXMLHash is the perfect solution.

Key Features

  • Easy XML parsing with a convenient syntax
  • Support for parsing XML data from various sources
  • Automatic conversion to Swift native types
  • Simple navigation and manipulation of XML elements and attributes
  • Ability to handle complex XML structures
  • Support for XPath-like queries

Installation

To install SWXMLHash, follow these steps:

  1. Open your Xcode project.
  2. Go to “File” > “Swift Packages” > “Add Package Dependency”.
  3. Enter the URL of the SWXMLHash GitHub repository: https://github.com/drmohundro/SWXMLHash.git
  4. Select the desired version of SWXMLHash.
  5. Click “Next” and then “Finish” to complete the installation process.

Getting Started

After successfully installing SWXMLHash, you can start using it in your Swift project. Follow these steps to get started:

  1. Import the SWXMLHash module into your Swift file:
import SWXMLHash
  1. Use the XMLHash.parse(_:) function to parse your XML data:
// Example XML data
let xmlData = """
<root>
  <person>
    <name>John Doe</name>
    <age>25</age>
  </person>
</root>
"""

// Parse the XML data
let xml = XMLHash.parse(xmlData)

Examples

Example 1: Accessing XML Elements

SWXMLHash provides an easy way to access XML elements and their corresponding values:

// Assuming the parsed XML from the previous example

// Access the "name" element's value
let name = xml["root"]["person"]["name"].element?.text // "John Doe"

// Access the "age" element's value as an integer
let age = xml["root"]["person"]["age"].element?.text.flatMap(Int.init) // 25

Example 2: Handling Attributes

SWXMLHash allows you to access and manipulate XML attributes:

// Assuming the parsed XML from the previous example

// Access the "person" element's "id" attribute value
let id = xml["root"]["person"].element?.attribute(by: "id")?.text // nil (if not present)

// Set a new "id" attribute value for the "person" element
xml["root"]["person"].element?.setAttribute("id", value: "123")

Example 3: Querying with XPath

You can perform XPath-like queries on XML data using SWXMLHash:

// Assuming the parsed XML from the previous example

// Find all "name" elements anywhere in the XML structure
let names = xml.xpath(".//name")

// Iterate over the found "name" elements
for nameElement in names {
    if let name = nameElement.element?.text {
        print(name)
    }
}

Conclusion

SWXMLHash is a versatile and powerful XML parsing library for Swift. With its intuitive syntax and extensive features, it simplifies working with XML data in your Swift projects. Start using SWXMLHash today and unleash the power of XML parsing in Swift!