String (System function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 6: Line 6:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%value</th><td>This string is set to the current value of the named string, or it is set to null if the named string is not set.</td></tr>
<tr><th>%value</th><td>This string is set to the current value of the named string, or it is set to null if the named string is not set.</td></tr>
<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a shared method. <var>String</var> can also be invoked via a <var>System</var> object variable, which may be <var>null</var>.</td></tr>
<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a ÝÝNotation conventions for methods#Shared methods|shared¨¨ method. <var>String</var> can also be invoked via a <var>System</var> object variable, which may be <var>null</var>.</td></tr>
<tr><th>name</th> <td>A string that identifies the global string to be retrieved.</td></tr>
<tr><th>name</th> <td>A string that identifies the global string to be retrieved.</td></tr>
</table>
</table>

Revision as of 20:38, 1 July 2011

Get a system-wide string (System class)

The String read-only property returns the current value of a system-wide string.

Syntax

%value = %(System):String( name)

Syntax terms

%valueThis string is set to the current value of the named string, or it is set to null if the named string is not set.
%(System)The class name in parentheses denotes a ÝÝNotation conventions for methods#Shared methods|shared¨¨ method. String can also be invoked via a System object variable, which may be null.
name A string that identifies the global string to be retrieved.

Examples

  1. The following statement prints the value of the subsystem string called EMERALDS:

    print %(system):string('EMERALDS')

  2. A common use of system strings might be to hold a complex shared data-structure in the form of XML. Such a string can be loaded into an XmlDoc object fairly easily:

    %sharedDoc is object xmlDoc auto new ... %sharedDoc:loadXml(%(system):string('SharedDoc'))

See also