4D Doc Center : SAX GET XML ENTITY

Home

4D v14.3

SAX GET XML ENTITY


SAX GET XML ENTITY ( document ; name ; value )

Parameter	Type	Description
document	DocRef	Reference of open document
name	String	Entity name
value	String	Entity value

Description

The SAX GET XML ENTITY command allows you to get the name and value of an XML entity that exists in the XML document referenced in the document parameter. This command must be called with the XML Entity SAX event. For more information about SAX events, refer to the description of the SAX Get XML node command.

Example

Let's look at the following piece of XML code:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE body [
   <!ELEMENT body (element*)>
   <!ELEMENT element (#PCDATA)>
   <!ENTITY name "Replacement">
]>
<body>
   <element>Entity updated by &name;</element>
</body>

The following instruction will return “name” in vName and “Replacement” in vValue.

SAX GET XML ENTITY(DocRef;vName;vValue)

System variables and sets

If the command has been executed correctly, the system variable OK is set to 1. Otherwise, it is set to 0 and an error is generated.