RainCode - XMLBooster

Element: ENTITY

This element describes one user-defined entity.

Attributes

Name Type Optional

Name	Type	Optional
NAME	STRING	No	This attribute holds the entity's name in the form of symbolic name which must refer to a constant value in the host language. For instance, if one defines an entity named `XMLB AMPERSAND`, there must be a declaration such as: #define XMLB_AMPERSAND '&' if used with the C code generator, and a declaration such as: 10 XMLB_AMPERSAND PIC X(1) VALUE '&'. if used with the COBOL code generator.
VALUE	STRING	No	This attribute holds the entity's value, that is, the text representation of the entity as it will be found in the incoming XML files, as "lt" for "<", for instance, without the leading "&" and trailing ";".
PARSEONLY	BOOLEAN	Yes	If set to TRUE, this attributes indicates that the entity must be considered when parsing only, not when unparsing. This proves typically useful to deal with entities such as &NBSP; that must be recognized in the input and translated to plain spaces, while it would not be sensible in all circumstances to convert all spaces back to the entity value when unparsing.

NAME

STRING

This attribute holds the entity's name in the form of symbolic name which must refer to a constant value in the host language. For instance, if one defines an entity named XMLB AMPERSAND, there must be a declaration such as:

#define XMLB_AMPERSAND '&'

if used with the C code generator, and a declaration such as:

  10 XMLB_AMPERSAND PIC X(1) VALUE '&'.

if used with the COBOL code generator.

VALUE STRING No This attribute holds the entity's value, that is, the text representation of the entity as it will be found in the incoming XML files, as "lt" for "<", for instance, without the leading "&" and trailing ";".

PARSEONLY BOOLEAN Yes If set to TRUE, this attributes indicates that the entity must be considered when parsing only, not when unparsing. This proves typically useful to deal with entities such as &NBSP; that must be recognized in the input and translated to plain spaces, while it would not be sensible in all circumstances to convert all spaces back to the entity value when unparsing.

Appears in

ENTITYCONFIG

DTD declaration

<!ELEMENT ENTITY EMPTY>

<!ATTLIST ENTITY
     NAME CDATA  #REQUIRED
     VALUE CDATA  #REQUIRED
     PARSEONLY (YES|yes|Y|y|ON|On|on|TRUE|true|True|1|NO|no|N|n|OFF|Off|off|FALSE|false|False|0)  #IMPLIED
>