revXMLPreviousSibling

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
revXMLPreviousSibling(<treeID>, <siblingNode>, [incText])
Associationsxml library
Summary

Returns the path to a child node's previous sibling node.

Introduced2.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
treeID

The number returned by the revXMLCreateTree or revXMLCreateTreeFromFile function when you created the XML tree.

siblingNode

The path to the node where you want to start.

Example
revXMLPreviousSibling(22,"/City/Publisher")
put revXMLPreviousSibling(myDoc,thisNode) into thisNode
Values
NameTypeDescription
return

The revXMLPreviousSibling function returns a string consisting of the path to the previous node with the same parent as the siblingNode. If there is no previous sibling node, the revXMLPreviousSibling function returns empty.

RelatedProperty: nodes
Control Structure: function
Function: revXMLRootNode, revXMLFirstChild, revXMLCreateTree, revXMLCreateTreeFromFile
Library: XML library
Glossary: LiveCode custom library, Standalone Application Settings, return, standalone application
Securitydisk
Description

Use the revXMLPreviousSibling function to back up through the list of nodes on the current level.

If the revXMLPreviousSibling function encounters an error, it returns an error message starting with "xmlerr".

Note: If the incText form is specified and is true the function will return text nodes in processing. Text nodes can be accessed using the revXMLNodeContents function with the extended path format where text only nodes are numerically indexed eg summary/command/[1] is the first text node of the summary/command node.

Important: The incText form is experimental.

Important: The revXMLPreviousSibling function is part of the XML library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "XML" checkbox is checked.

Tagstext processing