$Ent_Print
Set automatic character entity substitution
Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Ent_Print function.
This function retrieves or sets the current automatic character entity substitution setting for Print and Html/Text statements.
At the start of every request the $Ent_Print setting is OFF, meaning no character entity substitution is done for the output from Print or Html/Text statements.
$Ent accepts one argument and returns a string result.
Syntax
%result = $Ent_Print(val)
| %result | A String that is set to the $Ent_Print setting before the call. | ||||||
|---|---|---|---|---|---|---|---|
| val | The new setting of automatic character entity substitution; it must be one of these:
Note: This is an optional argument; if not specified or specified as null, the current $Ent_Print setting is not altered. Specifying an invalid value for $Ent_Print causes request cancellation. |
usage notes
- The $Ent_Print setting can be overridden in an Html/Text statement by the ENT_PRINT setting on that statement or by the special
*or!characters following the expression start string in an expression. - Character entity substitution replaces characters that have special meaning to an HTML or XML processor with their character entity representation. For example, the
<is represented as the<character entity.A default character entity substitution table is provided which does the basic required character entity mappings for HTML and XML of
&to&,<to<and the double quote character"to".The active character entity substitution table can be modified with $Ent_Tab.
- The return value for $Ent_Print is the $Ent_Print setting before the function call. This makes it easy to save the $Ent_Print setting and then restore it.
In this example, $Ent_Print is set to
ONand then restored to its previous setting:SUBROUTINE HEADER %ENT_PRINT IS STRING LEN 32 * I'm too lazy to type all those <'s %ENT_PRINT = $Ent_Print('ON') PRINT '<<<<<<<<<<<<<< Header >>>>>>>>>>>>>>' * But shouldn't mess with $Ent_Print setting %ENT_PRINT = $Ent_Print('ON')
- Generally, the most useful setting for $Ent_Print is VAR, because it is hard to be sure that variable data, whether it comes from a database field or from user input, doesn't contain special HTML or XML characters. Literal strings, on the other hand, are likely to contain XML or HTML tags, so they should not undergo character entity substitution.
Occasionally, it is useful to place HTML or XML tags in a %variable. If possible, that variable should be STATIC so a VAR setting for $Ent_Print will not modify it. If this is not possible, it is probably best to use the Html/Text statement, where a single character after the expression start character(s) (an
&or an!) can explicitly force or prevent character entity translation.