ObjFW
Instance Methods | Class Methods | List of all members
OFXMLElement Class Reference

A class which stores an XML element. More...

#import <ObjFW/OFXMLElement.h>

Inheritance diagram for OFXMLElement:
OFXMLNode OFObject <OFCopying> <OFSerialization> <OFObject>

Instance Methods

(id) - initWithName:
 Initializes an already allocated OFXMLElement with the specified name. More...
 
(id) - initWithName:stringValue:
 Initializes an already allocated OFXMLElement with the specified name and string value. More...
 
(id) - initWithName:namespace:
 Initializes an already allocated OFXMLElement with the specified name and namespace. More...
 
(id) - initWithName:namespace:stringValue:
 Initializes an already allocated OFXMLElement with the specified name, namespace and value. More...
 
(id) - initWithElement:
 Initializes an already allocated OFXMLElement with the specified element. More...
 
(id) - initWithXMLString:
 Parses the string and initializes an already allocated OFXMLElement with it. More...
 
(id) - initWithFile:
 Parses the specified file and initializes an already allocated OFXMLElement with it. More...
 
(void) - setName:
 Sets the name of the element. More...
 
(OFString *) - name
 Returns the name of the element. More...
 
(void) - setNamespace:
 Sets the namespace of the element. More...
 
(nullable OFString *) - namespace
 Returns the namespace of the element. More...
 
(void) - setPrefix:forNamespace:
 Sets a prefix for a namespace. More...
 
(void) - bindPrefix:forNamespace:
 Binds a prefix for a namespace. More...
 
(void) - setDefaultNamespace:
 Sets the default namespace for the element to be used if there is no parent. More...
 
(nullable OFString *) - defaultNamespace
 Returns the default namespace for the element to be used if there is no parent. More...
 
(nullable OFArray OF_GENERIC(OFXMLAttribute *) - attributes
 Returns an OFArray with the attributes of the element. More...
 
(void) - addAttribute:
 Adds the specified attribute. More...
 
(void) - addAttributeWithName:stringValue:
 Adds the specified attribute with the specified string value. More...
 
(void) - addAttributeWithName:namespace:stringValue:
 Adds the specified attribute with the specified namespace and string value. More...
 
(OFXMLAttribute *) - attributeForName:
 Returns the attribute with the specified name. More...
 
(OFXMLAttribute *) - attributeForName:namespace:
 Returns the attribute with the specified name and namespace. More...
 
(void) - removeAttributeForName:
 Removes the attribute with the specified name. More...
 
(void) - removeAttributeForName:namespace:
 Removes the attribute with the specified name and namespace. More...
 
(void) - setChildren:
 Removes all children and adds the children from the specified array. More...
 
(nullable OFArray OF_GENERIC(OFXMLNode *) - children
 Returns an array of OFXMLNodes with all children of the element. More...
 
(void) - addChild:
 Adds a child to the OFXMLElement. More...
 
(void) - insertChild:atIndex:
 Inserts a child at the specified index. More...
 
(void) - insertChildren:atIndex:
 Inserts the specified children at the specified index. More...
 
(void) - removeChild:
 Removes the first child that is equal to the specified OFXMLNode. More...
 
(void) - removeChildAtIndex:
 Removes the child at the specified index. More...
 
(void) - replaceChild:withNode:
 Replaces the first child that is equal to the specified OFXMLNode with the specified node. More...
 
(void) - replaceChildAtIndex:withNode:
 Replaces the child at the specified index with the specified node. More...
 
(OFArray OF_GENERIC(OFXMLElement *) - elements
 Returns all children that are elements. More...
 
(OFArray OF_GENERIC(OFXMLElement *) - elementsForNamespace:
 Returns all children that have the specified namespace. More...
 
(OFXMLElement *) - elementForName:
 Returns the first child element with the specified name. More...
 
(OFArray OF_GENERIC(OFXMLElement *) - elementsForName:
 Returns the child elements with the specified name. More...
 
(OFXMLElement *) - elementForName:namespace:
 Returns the first child element with the specified name and namespace. More...
 
(OFArray OF_GENERIC(OFXMLElement *) - elementsForName:namespace:
 Returns the child elements with the specified name and namespace. More...
 
(id) - objectByDeserializing
 Deserializes the receiver into an object. More...
 
- Instance Methods inherited from OFXMLNode
(OFString *) - stringValue
 Returns the contents of the receiver as a string value. More...
 
(void) - setStringValue:
 Sets the string value of the receiver to the specified string. More...
 
(intmax_t) - decimalValue
 Returns the contents of the receiver as a decimal value. More...
 
(uintmax_t) - hexadecimalValue
 Returns the contents of the receiver as a hexadecimal value. More...
 
(float) - floatValue
 Returns the contents of the receiver as a float value. More...
 
(double) - doubleValue
 Returns the contents of the receiver as a double value. More...
 
(OFString *) - XMLString
 Returns an OFString representing the OFXMLNode as an XML string. More...
 
(OFString *) - XMLStringWithIndentation:
 Returns an OFString representing the OFXMLNode as an XML string with indentation. More...
 
(OFString *) - XMLStringWithIndentation:level:
 Returns an OFString representing the OFXMLNode as an XML string with indentation for the specified level. More...
 
- Instance Methods inherited from OFObject
(id) - init
 Initializes an already allocated object. More...
 
(OFString *) - className
 Returns the name of the object's class. More...
 
(OFString *) - description
 Returns a description for the object. More...
 
(void *) - allocMemoryWithSize:
 Allocates memory and stores it in the object's memory pool. More...
 
(void *) - allocMemoryWithSize:count:
 Allocates memory for the specified number of items and stores it in the object's memory pool. More...
 
(nullable void *) - resizeMemory:size:
 Resizes memory in the object's memory pool to the specified size. More...
 
(nullable void *) - resizeMemory:size:count:
 Resizes memory in the object's memory pool to the specific number of items of the specified size. More...
 
(void) - freeMemory:
 Frees allocated memory and removes it from the object's memory pool. More...
 
(void) - dealloc
 Deallocates the object. More...
 
(void) - performSelector:afterDelay:
 Performs the specified selector after the specified delay. More...
 
(void) - performSelector:withObject:afterDelay:
 Performs the specified selector with the specified object after the specified delay. More...
 
(void) - performSelector:withObject:withObject:afterDelay:
 Performs the specified selector with the specified objects after the specified delay. More...
 
(void) - performSelector:onThread:waitUntilDone:
 Performs the specified selector on the specified thread. More...
 
(void) - performSelector:onThread:withObject:waitUntilDone:
 Performs the specified selector on the specified thread with the specified object. More...
 
(void) - performSelector:onThread:withObject:withObject:waitUntilDone:
 Performs the specified selector on the specified thread with the specified objects. More...
 
(void) - performSelectorOnMainThread:waitUntilDone:
 Performs the specified selector on the main thread. More...
 
(void) - performSelectorOnMainThread:withObject:waitUntilDone:
 Performs the specified selector on the main thread with the specified object. More...
 
(void) - performSelectorOnMainThread:withObject:withObject:waitUntilDone:
 Performs the specified selector on the main thread with the specified objects. More...
 
(void) - performSelector:onThread:afterDelay:
 Performs the specified selector on the specified thread after the specified delay. More...
 
(void) - performSelector:onThread:withObject:afterDelay:
 Performs the specified selector on the specified thread with the specified object after the specified delay. More...
 
(void) - performSelector:onThread:withObject:withObject:afterDelay:
 Performs the specified selector on the specified thread with the specified objects after the specified delay. More...
 
(nullable id) - forwardingTargetForSelector:
 This method is called when resolveClassMethod: or resolveInstanceMethod: returned false. It should return a target to which the message should be forwarded. More...
 
(void) - doesNotRecognizeSelector:
 Handles messages which are not understood by the receiver. More...
 
(OFString *) - stringBySerializing
 Creates a string by serializing the receiver. More...
 
- Instance Methods inherited from <OFObject>
(bool) - isKindOfClass:
 Returns a boolean whether the object of the specified kind. More...
 
(bool) - isMemberOfClass:
 Returns a boolean whether the object is a member of the specified class. More...
 
(bool) - respondsToSelector:
 Returns a boolean whether the object responds to the specified selector. More...
 
(nullable IMP) - methodForSelector:
 Returns the implementation for the specified selector. More...
 
(nullable const char *) - typeEncodingForSelector:
 Returns the type encoding for the specified selector. More...
 
(nullable id) - performSelector:
 Performs the specified selector. More...
 
(nullable id) - performSelector:withObject:
 Performs the specified selector with the specified object. More...
 
(nullable id) - performSelector:withObject:withObject:
 Performs the specified selector with the specified objects. More...
 
(bool) - isEqual:
 Checks two objects for equality. More...
 
(uint32_t) - hash
 Calculates a hash for the object. More...
 
(id) - retain
 Increases the retain count. More...
 
(unsigned int) - retainCount
 Returns the retain count. More...
 
(void) - release
 Decreases the retain count. More...
 
(id) - autorelease
 Adds the object to the topmost OFAutoreleasePool of the thread's autorelease pool stack. More...
 
(id) - self
 Returns the receiver. More...
 
(bool) - isProxy
 Returns whether the object is a proxy object. More...
 
- Instance Methods inherited from <OFCopying>
(id) - copy
 Copies the object. More...
 
- Instance Methods inherited from <OFSerialization>
(id) - initWithSerialization:
 Initializes the object with the specified XML element serialization. More...
 
(OFXMLElement *) - XMLElementBySerializing
 Serializes the object into an XML element. More...
 

Class Methods

(instancetype) + elementWithName:
 Creates a new XML element with the specified name. More...
 
(instancetype) + elementWithName:stringValue:
 Creates a new XML element with the specified name and string value. More...
 
(instancetype) + elementWithName:namespace:
 Creates a new XML element with the specified name and namespace. More...
 
(instancetype) + elementWithName:namespace:stringValue:
 Creates a new XML element with the specified name, namespace and string value. More...
 
(instancetype) + elementWithElement:
 Creates a new element with the specified element. More...
 
(instancetype) + elementWithXMLString:
 Parses the string and returns an OFXMLElement for it. More...
 
(instancetype) + elementWithFile:
 Parses the specified file and returns an OFXMLElement for it. More...
 
- Class Methods inherited from OFObject
(void) + load
 A method which is called once when the class is loaded into the runtime. More...
 
(void) + unload
 A method which is called when the class is unloaded from the runtime. More...
 
(void) + initialize
 A method which is called the moment before the first call to the class is being made. More...
 
(id) + alloc
 Allocates memory for an instance of the class and sets up the memory pool for the object. More...
 
(id) + new
 Allocates memory for a new instance and calls init on it. More...
 
(Class) + class
 Returns the class. More...
 
(OFString *) + className
 Returns the name of the class as a string. More...
 
(bool) + isSubclassOfClass:
 Returns a boolean whether the class is a subclass of the specified class. More...
 
(Class) + superclass
 Returns the superclass of the class. More...
 
(bool) + instancesRespondToSelector:
 Checks whether instances of the class respond to a given selector. More...
 
(bool) + conformsToProtocol:
 Checks whether the class conforms to a given protocol. More...
 
(nullable IMP) + instanceMethodForSelector:
 Returns the implementation of the instance method for the specified selector. More...
 
(nullable const char *) + typeEncodingForInstanceSelector:
 Returns the type encoding of the instance method for the specified selector. More...
 
(OFString *) + description
 Returns a description for the class, which is usually the class name. More...
 
(nullable IMP) + replaceClassMethod:withMethodFromClass:
 Replaces a class method with a class method from another class. More...
 
(nullable IMP) + replaceInstanceMethod:withMethodFromClass:
 Replaces an instance method with an instance method from another class. More...
 
(nullable IMP) + replaceClassMethod:withImplementation:typeEncoding:
 Replaces or adds a class method. More...
 
(nullable IMP) + replaceInstanceMethod:withImplementation:typeEncoding:
 Replaces or adds an instance method. More...
 
(void) + inheritMethodsFromClass:
 Adds all methods from the specified class to the class that is the receiver. More...
 
(bool) + resolveClassMethod:
 Try to resolve the specified class method. More...
 
(bool) + resolveInstanceMethod:
 Try to resolve the specified instance method. More...
 
(id) + copy
 Returns the class. More...
 

Detailed Description

A class which stores an XML element.

Method Documentation

- (void) addAttribute: (OFXMLAttribute*)  attribute

Adds the specified attribute.

If an attribute with the same name and namespace already exists, it is not added.

Parameters
attributeThe attribute to add
- (void) addAttributeWithName: (OFString *)  name
namespace: (nullable OFString *)  namespace_
stringValue: (OFString *)  stringValue 

Adds the specified attribute with the specified namespace and string value.

If an attribute with the same name and namespace already exists, it is not added.

Parameters
nameThe name of the attribute
namespace_The namespace of the attribute
stringValueThe value of the attribute
- (void) addAttributeWithName: (OFString*)  name
stringValue: (OFString*)  stringValue 

Adds the specified attribute with the specified string value.

If an attribute with the same name and namespace already exists, it is not added.

Parameters
nameThe name of the attribute
stringValueThe value of the attribute
- (void) addChild: (OFXMLNode*)  child

Adds a child to the OFXMLElement.

Parameters
childAn OFXMLNode which is added as a child
- (OFXMLAttribute *) attributeForName: (OFString*)  attributeName

Returns the attribute with the specified name.

Parameters
attributeNameThe name of the attribute
Returns
The attribute with the specified name
- (OFXMLAttribute*) attributeForName: (OFString *)  attributeName
namespace: (nullable OFString *)  attributeNS 

Returns the attribute with the specified name and namespace.

Parameters
attributeNameThe name of the attribute
attributeNSThe namespace of the attribute
Returns
The attribute with the specified name and namespace
- (OFArray *) attributes

Returns an OFArray with the attributes of the element.

Returns
An OFArray with the attributes of the element
- (void) bindPrefix: (OFString*)  prefix
forNamespace: (OFString*)  namespace_ 

Binds a prefix for a namespace.

Parameters
prefixThe prefix for the namespace
namespace_The namespace for which the prefix is bound
- (OFArray *) children

Returns an array of OFXMLNodes with all children of the element.

Returns
An array of OFXMLNodes with all children of the element
- (OFString *) defaultNamespace

Returns the default namespace for the element to be used if there is no parent.

Returns
The default namespace for the element to be used if there is no parent.
- (OFXMLElement *) elementForName: (OFString*)  elementName

Returns the first child element with the specified name.

Parameters
elementNameThe name of the element
Returns
The first child element with the specified name
- (OFXMLElement*) elementForName: (OFString *)  elementName
namespace: (nullable OFString *)  elementNS 

Returns the first child element with the specified name and namespace.

Parameters
elementNameThe name of the element
elementNSThe namespace of the element
Returns
The first child element with the specified name and namespace
- (OFArray *) elements

Returns all children that are elements.

Returns
All children that are elements
- (OFArray *) elementsForName: (OFString*)  elementName

Returns the child elements with the specified name.

Parameters
elementNameThe name of the elements
Returns
The child elements with the specified name
- (OFArray OF_GENERIC(OFXMLElement*) elementsForName: (OFString *)  elementName
namespace: (nullable OFString *)  elementNS 

Returns the child elements with the specified name and namespace.

Parameters
elementNameThe name of the elements
elementNSThe namespace of the elements
Returns
The child elements with the specified name and namespace
- (OFArray OF_GENERIC(OFXMLElement*) elementsForNamespace: (nullable OFString *)  elementNS

Returns all children that have the specified namespace.

Returns
All children that have the specified namespace
+ (instancetype) elementWithElement: (OFXMLElement*)  element

Creates a new element with the specified element.

Parameters
elementAn OFXMLElement to initialize the OFXMLElement with
Returns
A new autoreleased OFXMLElement with the contents of the specified element
+ (instancetype) elementWithFile: (OFString*)  path

Parses the specified file and returns an OFXMLElement for it.

Parameters
pathThe path to the file
Returns
A new autoreleased OFXMLElement with the contents of the specified file
+ (instancetype) elementWithName: (OFString*)  name

Creates a new XML element with the specified name.

Parameters
nameThe name for the element
Returns
A new autoreleased OFXMLElement with the specified element name
+ (instancetype) elementWithName: (OFString *)  name
namespace: (nullable OFString *)  namespace_ 

Creates a new XML element with the specified name and namespace.

Parameters
nameThe name for the element
namespace_The namespace for the element
Returns
A new autoreleased OFXMLElement with the specified element name and namespace
+ (instancetype) elementWithName: (OFString *)  name
namespace: (nullable OFString *)  namespace_
stringValue: (nullable OFString *)  stringValue 

Creates a new XML element with the specified name, namespace and string value.

Parameters
nameThe name for the element
namespace_The namespace for the element
stringValueThe value for the element
Returns
A new autoreleased OFXMLElement with the specified element name, namespace and value
+ (instancetype) elementWithName: (OFString *)  name
stringValue: (nullable OFString *)  stringValue 

Creates a new XML element with the specified name and string value.

Parameters
nameThe name for the element
stringValueThe value for the element
Returns
A new autoreleased OFXMLElement with the specified element name and value
+ (instancetype) elementWithXMLString: (OFString*)  string

Parses the string and returns an OFXMLElement for it.

Parameters
stringThe string to parse
Returns
A new autoreleased OFXMLElement with the contents of the string
- (id) initWithElement: (OFXMLElement*)  element

Initializes an already allocated OFXMLElement with the specified element.

Parameters
elementAn OFXMLElement to initialize the OFXMLElement with
Returns
A new autoreleased OFXMLElement with the contents of the specified element
- (id) initWithFile: (OFString*)  path

Parses the specified file and initializes an already allocated OFXMLElement with it.

Parameters
pathThe path to the file
Returns
An initialized OFXMLElement with the contents of the specified file
- (id) initWithName: (OFString*)  name

Initializes an already allocated OFXMLElement with the specified name.

Parameters
nameThe name for the element
Returns
An initialized OFXMLElement with the specified element name
- (id) initWithName: (OFString *)  name
namespace: (nullable OFString *)  namespace_ 

Initializes an already allocated OFXMLElement with the specified name and namespace.

Parameters
nameThe name for the element
namespace_The namespace for the element
Returns
An initialized OFXMLElement with the specified element name and namespace
- (id) initWithName: (OFString *)  name
namespace: (nullable OFString *)  namespace_
stringValue: (nullable OFString *)  stringValue 

Initializes an already allocated OFXMLElement with the specified name, namespace and value.

Parameters
nameThe name for the element
namespace_The namespace for the element
stringValueThe value for the element
Returns
An initialized OFXMLElement with the specified element name, namespace and value
- (id) initWithName: (OFString *)  name
stringValue: (nullable OFString *)  stringValue 

Initializes an already allocated OFXMLElement with the specified name and string value.

Parameters
nameThe name for the element
stringValueThe value for the element
Returns
An initialized OFXMLElement with the specified element name and value
- (id) initWithXMLString: (OFString*)  string

Parses the string and initializes an already allocated OFXMLElement with it.

Parameters
stringThe string to parse
Returns
An initialized OFXMLElement with the contents of the string
- (void) insertChild: (OFXMLNode*)  child
atIndex: (size_t)  index 

Inserts a child at the specified index.

Parameters
childAn OFXMLNode which is added as a child
indexThe index where the child is added
- (void) insertChildren: (OFArray OF_GENERIC(OFXMLNode *)*)  children
atIndex: (size_t)  index 

Inserts the specified children at the specified index.

Parameters
childrenAn array of OFXMLNodes which are added as children
indexThe index where the child is added
- (OFString*) name

Returns the name of the element.

Returns
The name of the element
- (OFString *) namespace

Returns the namespace of the element.

Returns
The namespace of the element
- (id) objectByDeserializing

Deserializes the receiver into an object.

Returns
The deserialized object
- (void) removeAttributeForName: (OFString*)  attributeName

Removes the attribute with the specified name.

Parameters
attributeNameThe name of the attribute
- (void) removeAttributeForName: (OFString *)  attributeName
namespace: (nullable OFString *)  attributeNS 

Removes the attribute with the specified name and namespace.

Parameters
attributeNameThe name of the attribute
attributeNSThe namespace of the attribute
- (void) removeChild: (OFXMLNode*)  child

Removes the first child that is equal to the specified OFXMLNode.

Parameters
childThe child to remove from the OFXMLElement
- (void) removeChildAtIndex: (size_t)  index

Removes the child at the specified index.

Parameters
indexThe index of the child to remove
- (void) replaceChild: (OFXMLNode*)  child
withNode: (OFXMLNode*)  node 

Replaces the first child that is equal to the specified OFXMLNode with the specified node.

Parameters
childThe child to replace
nodeThe node to replace the child with
- (void) replaceChildAtIndex: (size_t)  index
withNode: (OFXMLNode*)  node 

Replaces the child at the specified index with the specified node.

Parameters
indexThe index of the child to replace
nodeThe node to replace the child with
- (void) setChildren: (nullable OFArray OF_GENERIC(OFXMLNode *)*)  children

Removes all children and adds the children from the specified array.

Parameters
childrenThe new children to add
- (void) setDefaultNamespace: (nullable OFString *)  defaultNamespace

Sets the default namespace for the element to be used if there is no parent.

Parameters
defaultNamespaceThe default namespace for the element
- (void) setName: (OFString*)  name

Sets the name of the element.

Parameters
nameThe new name
- (void) setNamespace: (nullable OFString *)  namespace_

Sets the namespace of the element.

Parameters
namespace_The new namespace
- (void) setPrefix: (OFString*)  prefix
forNamespace: (OFString*)  namespace_ 

Sets a prefix for a namespace.

Parameters
prefixThe prefix for the namespace
namespace_The namespace for which the prefix is set

The documentation for this class was generated from the following files: