XPath (property)

Provides a way to point to a specific element in the document.

Syntax

• Objective-C
• Swift

@property (nonatomic,readwrite,assign,getter=XPath,setter=setXPath:) NSString* XPath;
- (NSString*)XPath;
- (void)setXPath:(NSString*)newXPath;

public var XPath: String {
  get {...}
  set {...}
}

Default Value

""

Remarks

XPath implements a subset of the XML XPath specification, allowing you to point to specific elements in the XML response.

The path is a series of one or more element accessors separated by '/'. The path can be absolute (starting with '/') or relative to the current XPath location.

The following are possible values for an element accessor:

When XPath is set to a valid path, XElement points to the name of the element, with XChildren and XText providing other properties of the element.

Example (Setting XPath)

 Document root    
QBObjectControl.XPath = "/"
 Specific Element 
QBObjectControl.XPath = "/root/SubElement1/SubElement2/"
 i-th Child       
QBObjectControl.XPath = "/root/[i]"

You may use the HasXPath method to determine if an xpath exists before setting the XPath property.