Get a file list using wildcards from list as below. This instructs PTC ALD to prepare and sort a list of files which match the specified wildcard. It also fills in some predefined variables with various parts of the name of the first file in the sorted list.

A wildcard filename, including a path name if appropriate.

Example: If the file c:/3d/sample.3d were next in the list, the tflist macro would set up the following variables:

Example: The script below inserts the names of all files that match the specified wildcard into the current stream:

Similar techniques of looping are frequently used with tflist since it is only very rarely that you actually want the first item in a list to be listed.

Get a list of document tags, as specified by one or more options from list below. Each subsequent use of tflist with no parameters will return the next item in the same two variables.

The variables filled in for you are ^tflist and ^tflistn. These will be the same unless the T code is used, in which case in ^tflist each tag name will be preceded by a two-character type code (extension) and a space. Please refer to the Reference Chapter: PTC ALD tag types for details of tag extension codes.

Example: If the code used was xT, and the next item in the list is a style tag called body, the ^tflist variable will contain St body and the ^tflistn variable will contain body.

If the T code was not used then both variables would just contain body. The list is always sorted by the contents of ^tflist, so using the T code causes tags to be sorted by their type first.

The example below gets a list of style tags:

Example: The example below gets a list of all tags, together with their extensions. In ^tflist each tag name will be preceded a two-character type code and a space.

Example: Tag types can be combined, e.g. the example below gets a list of reference and text streams, together with their type code:

Example: List all tags except those from the text or color classes, but turn on Perl scripts, as it is one type from the type already turned off.

See the section Options for tflist below for further details about the options that can be included in a list request of this type.

Generate an original tag name by appending ascending numbers to the part of the name you supply until a name that does not already exist is found. This name is then entered into a list that contains only one item. The unique tag name will be returned in both the ^tflist and ^tflistn variables.

The part of the tag name to be used as a 'prefix'.

Example: The example below generates a unique tag name starting with og, for example og1. If og1 already exists, then og2 might me returned, and so on.

List installed fonts. Each call to tflist returns a font's long name in the ^tflist variable and its short name code in the ^tflistn variable. Each subsequent call to tflist with no parameters will return the next item in the same two variables.

Get a list of typefaces. This is the only string parameter available in this mode.

Example: There is only one possible example, because the string parameter never varies. This gets a list of installed fonts:

Suppose the next font in the list was Times, these assignments would be made:

List PTC ALD tokens from PTC ALDssys.3ad file. At present, 201 is the only list value which can be used and it returns a list of languages. Each call to tflist returns a language name in both the ^tflist and ^tflistn variables. Each subsequent call to tflist with no parameters will return the next item in the same two variables.

Example: This gets a list of supporting languages in PTC ALD :

List PTC ALD script variables that are named with a given prefix. This option was originally implemented to list PTC ALD file area names that use the prefix "_ar_". Each call to tflist returns a variable name in both the ^tflist and ^tflistn variables, with the given prefix removed. The name in the ^tflist variable will also have curly brackets around it. Each subsequent call to tflist with no parameters will return the next name in the same two variables.

A wildcard-style prefix for variable names to be listed: the prefix, followed by a single asterisk.

Example: This example will get a list of Arbortext PTC ALD area names:

Get a sub-directory list, using wildcards. This instructs PTC ALD to prepare and sort a list of sub-directories which match the specified wildcard. Each call to tflist returns a sub-directory name in the ^tflist variable, without a preceding path name. Each subsequent call to tflist with no parameters will return the next name in the same variable.

A wildcard name, including a path name if appropriate.

Example: This example will return a list of all the sub-directories from the root of drive C:

List printers available for use with the Windows printer driver. Each subsequent call to tflist with no parameters will return the next printer name in the same variable.

Not used with this mode (but needs to be present)

Example: This example lists the printers available to the Windows printer driver:

List the fonts that have been used in the current document. Each call to tflist returns a long or short font name in the ^tflist variable. Each subsequent call to tflist with no parameters will return the next name in the same variable.

Example: This example provides a list of long names of fonts which have been used in the current document: