ListOfObjects (System function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (system wide)
Line 1: Line 1:
{{Template:System:ListOfObjects subtitle}}
{{Template:System:ListOfObjects subtitle}}
The <var>ListOfObjects</var> method returns a <var>[[Stringlist class|Stringlist]]</var> containing information about <var>[[System_class#System-wide_objects|system-wide]]</var> objects. <var>ListOfObjects</var> is a shared method.
The <var>ListOfObjects</var> method returns a <var>[[Stringlist class|Stringlist]]</var> containing information about [[System_class#System-wide_objects|"system-wide objects"]]. <var>ListOfObjects</var> is a shared method.


==Syntax==
==Syntax==
Line 10: Line 10:
<td>The class name in parentheses denotes a shared method. <var>ListOfObjects</var> can also be invoked via a <var>[[System_class|system]]</var> object variable, which may be <var>null</var>.</td></tr>
<td>The class name in parentheses denotes a shared method. <var>ListOfObjects</var> can also be invoked via a <var>[[System_class|system]]</var> object variable, which may be <var>null</var>.</td></tr>
<tr><th>nameW</th>
<tr><th>nameW</th>
<td>An optional identifying string which may include wildcard characters.  Descriptions of the <var>system-wide</var> objects whose names match the <var class="term">nameW</var> pattern(s) are returned to the <var class="term">%sl</var> <var>Stringlist</var>.
<td>An optional identifying string which may include wildcard characters.  Descriptions of the system-wide objects whose names match the <var class="term">nameW</var> pattern(s) are returned to the <var class="term">%sl</var> <var>Stringlist</var>.
<p>This argument defaults to an asterisk (<code>*</code>), that is, all <var>system-wide</var> objects, and its eligible wildcard characters are shown below:</p>
<p>This argument defaults to an asterisk (<code>*</code>), that is, all system-wide objects, and its eligible wildcard characters are shown below:</p>
<ul><li><code>*</code> Matches any group of 0 or more characters
<ul><li><code>*</code> Matches any group of 0 or more characters
<li><code>?</code> Matches any single character
<li><code>?</code> Matches any single character

Revision as of 06:45, 25 March 2011

List of system objects (System class)

The ListOfObjects method returns a Stringlist containing information about "system-wide objects". ListOfObjects is a shared method.

Syntax

%sl = %(System):ListOfObjects[( [string])]

Syntax terms

%slThe Stringlist variable that contains the data about the objects selected according to the nameW pattern.
%(System) The class name in parentheses denotes a shared method. ListOfObjects can also be invoked via a system object variable, which may be null.
nameW An optional identifying string which may include wildcard characters. Descriptions of the system-wide objects whose names match the nameW pattern(s) are returned to the %sl Stringlist.

This argument defaults to an asterisk (*), that is, all system-wide objects, and its eligible wildcard characters are shown below:

  • * Matches any group of 0 or more characters
  • ? Matches any single character
  • " An escape, which means the next character is treated literally, even if it is a double quotation mark ("), question mark (?), or asterisk (*)

Usage notes

  • All errors result in request cancellation.
  • The items placed on the target Stringlist are put there in no particular order.
  • ListOfObjects is available in "Sirius Mods" Version 6.7 and later.

Examples

See also