CONTROL
- Introduction to CTRL
- CONTROL Classes
- Types of Control Functions
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
    - xmlAppendChild()
      Adds a new child node into the DOM tree as child of given node. Optionally the node's value can be set.
    - xmlChildNodes()
      Writes all child nodes of the given node into the nodes' reference parameter.
    - xmlCloseDocument()
      Closes the created XML document and destroys the occupied memory. After this call, the document ID is no longer valid.
    - xmlDocumentFromFile()
      Opens a file and reads the complete content building the DOM structure in memory.
    - xmlDocumentFromString()
      Reads the complete content from a string and builds the DOM structure in memory.
    - xmlDocumentToFile()
      Stores the internal DOM tree in an arbitrary XML file.
    - xmlDocumentToString()
      Returns the internal DOM tree as a string result.
    - xmlElementAttributes()
      Returns all node attributes as a mapping.
    - xmlFirstChild()
      Returns an internal ID to the first child node in the DOM tree.
    - xmlGetElementAttribute()
      Reads the value of the given attribute into the value reference parameter of the node.
    - xmlIsSameNode()
      Checks whether two node IDs are pointing to the same internal node within the DOM tree.
    - xmlNamedChild()
      This function allows you to easily find a child node in an xml document.
    - xmlNewDocument()
      Starts the creation of a new document in memory and returns the document ID.
    - xmlNextSibling()
      Returns an internal ID for the next sibling of the given node.
    - xmlNodeName()
      Returns the name of a node.
    - xmlNodePosition()
      The function returns the position of a node inside of an XML document.
    - xmlNodeType()
      Returns the type of the given node.
    - xmlNodeValue()
      Returns the value of the given node.
    - xmlParentNode()
      Returns the internal ID for the parent node of the given node.
    - xmlRemoveElementAttribute()
      Removes the given attribute from its node.
    - xmlRemoveNode()
      Removes the given node from its parent node.
    - xmlrpcCall()
      Calls the function "function" on the server with the arguments of the parameter "args". If "result" is specified, the function waits for the answer from the server and saves the answer in "result". This corresponds to the call result = function(args[1], ...);
    - xmlrpcClient
      Starts an XmlRpc client. The XmlRpc client is a Ctrl module that handles the calls in the background.
    - xmlrpcCloseServer()
      Closes the connection to the server.
    - xmlrpcConnectToServer()
      Establishes a connection to an XmlRpc server on host "host" and port "port". If "secure" is TRUE, a https connection is built. Under Windows the OpenSSL installation is required. The connection is valid only as long as it is open. This means if the connection is broken, the requests for the server will fail. Using the parameter "id", the server can be identified in the following calls.
    - xmlrpcDecodeRequest()
      Decodes the request and extracts the function name and arguments of it.
    - xmlrpcDecodeValue()
      Re-converts an XmlRpc-coded string to a variable.
    - xmlrpcEncodeResponse()
      Encodes the result in an XmlRpc message.
    - xmlrpcEncodeValue()
      Converts a "value" variable to an XmlRpc-coded string.
    - xmlrpcHandler()
      CtrlXmlRpc is a CTRL extension including XML-RPC functions. XML-RPC is a protocol for web services, similar to SOAP but much simpler.
    - xmlrpcSetGzipLimit()
      Defines from which size the contents of a request are compressed (gzip).
    - xmlSetElementAttribute()
      Sets the attribute of a node to given value.
    - xmlSetNodeValue()
      Sets the node's value to the given value.
  - Functions Y
  - Functions Z
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.
- CtrlExtension, basics

xmlChildNodes()

Writes all child nodes of the given node into the nodes' reference parameter.

Synopsis

int xmlChildNodes( unsigned doc, unsigned node, dyn_uint &nodes);

Parameters


Parameter	Description
doc	The document ID returned by e.g. xmlNewDocument().
node	Node ID
nodes	Child nodes (return parameter)

Return value

0 if the writing process was successful.

If an error occurs, -1 will be returned.

Description

EXAMPLE

This example creates a document through xmlNewDocument() and adds nodes to the document through xmlAppendChild(). The nodes are printed using xmlChildNodes.

#uses "CtrlXml"
main()
{
  dyn_uint nodes;
  string nNameP, nName1,nName2, nName3, nName4, nName5;
  unsigned docNum = xmlNewDocument();
  //Create a new document
  xmlAppendChild(docNum, -1, XML_COMMENT_NODE, "my fine new
  comment");
  //Add a new node
  int node = xmlAppendChild(docNum, -1, XML_ELEMENT_NODE, "Parent
  node");
  //Add a new node
  nNameP = xmlNodeName(docNum, node);
  int PNode = xmlParentNode(docNum, node);
  DebugN("Parent node:", nNameP);
  xmlAppendChild(docNum,PNode, XML_ELEMENT_NODE, "First
  element");
  nName1 = xmlNodeName(docNum, node);
  DebugN("Node 1:", nName1);
  int node2 = xmlAppendChild(docNum, -1, XML_ELEMENT_NODE, "Second
  element");
  nName2 = xmlNodeName(docNum, node2);
  DebugN("Node 2:", nName2);
  int j = xmlSetElementAttribute(docNum, node2, "Attribute1",
  "Example Attribute");
  //Set a new attribute
  int node3 = xmlAppendChild(docNum, node2, XML_ELEMENT_NODE,
  "Third element");
  nName3 = xmlNodeName(docNum,node3);
  DebugN("Node 3:", nName3);
  int i = xmlSetNodeValue(docNum, nName2, "And a node value");
  //Set a new value
  int node4 = xmlAppendChild(docNum, -1, XML_ELEMENT_NODE, "Fourth
  element");
  nName4 = xmlNodeName(docNum, node4);
  DebugN("Node 4:", nName4);
  int node3 = xmlAppendChild(docNum, -1, XML_ELEMENT_NODE, "Fifth
  element");
  xmlSetElementAttribute(docNum, node3, "Attribute2", "A second
  example attribute");
  int k = xmlChildNodes(docNum, PNode, nodes);
  DebugN("xmlChildNodes successful:", k, "List of the nodes:",
  nodes);
  //Print the child nodes
}

Assignment

XML Control Extension

Availability

In every script where the "CtrlXml" extension (#uses "CtrlXml") is used.