$ListNewAI

From m204wiki
Revision as of 22:18, 8 February 2011 by 198.242.244.47 (talk) (Created page with "{{DISPLAYTITLE:$ListNewAI}} <span class="pageSubtitle"><section begin="desc" />Create array of empty $lists associated with image<section end="desc" /></span> <p class="warning"...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<section begin="desc" />Create array of empty $lists associated with image<section end="desc" />

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNewAI function is to be entered.

This function creates an array of empty $lists.

The $ListNewAI function accepts nine arguments and returns a numeric result. It is a callable $function (:hdref refid=callfun.).

Syntax

<section begin="syntax" /> [%RC =] $ListNewAI(%array, image_id, option, start_dim1, - size_dim1, start_dim2, size_dim2, - start_dim3, size_dim3 ) <section end="syntax" />

$ListNewAI Function

%RC is set to 0 or to an error indicator.

  • The first argument is the array which will contain the identifiers of the $lists which are created. This is a required argument.
  • The second argument can either be a string containing the name of an image or any image item from the required image. This is a required argument.
  • The third argument, if set to the string &OSQ.NOREL&CSQ., indicates that the contents of the $lists are not to be emptied when a RELEASE ALL RECORDS statement is executed. This is an optional argument.
  • The fourth argument is the start index for the created $list identifiers in the first dimension of the array. This is an optional argument; its default is 1. It must be between 1 and the size of the first dimension of the array.
  • The fifth argument is the number of indices for the created $list identifiers in the first dimension of the array. This is an optional argument; its default is the number of indices in the first dimension of the array minus the start index, minus 1 (that is, all of the indices starting with the start index). It must be between 1 and this default value.
  • The sixth argument is the start index for the created $list identifiers in the second dimension of the array. This is an optional argument; its default is 1. It must be between 1 and the size of the second dimension of the array.
  • The seventh argument is the number of indices for the created $list identifiers in the second dimension of the array. This is an optional argument; its default is the number of indices in the second dimension of the array minus the start index, minus 1 (that is, all of the indices starting with the start index). It must be between 1 and this default value.
  • The eighth argument is the start index for the created $list identifiers in the third dimension of the array. This is an optional argument; its default is 1. It must be between 1 and the size of the third dimension of the array.
  • The ninth argument is the number of indices for the created $list identifiers in the third dimension of the array. This is an optional argument; its default is the number of indices in the third dimension of the array minus the start index, minus 1 (that is, all of the indices starting with the start index). It must be between 1 and this default value.

0 - No errors 1 - Invalid array bound

$ListNewAI return codes


All invocations of a particular call to $ListNewAI will always set the same values to those elements of the array that are being set. Each time that call is executed, any previous $lists in those elements created by that call are deleted, and a new list is created.

$ListNewAI performs the same processing as $ListNewA (:hdref refid=lstnwa.) and a $ListImg (:hdref refid=listimg.) call for each $list maped to the array but does so in a single call.

$ListNewAI is available in Version 6.2 and later of the Sirius Mods.

Products authorizing $ListNewAI