Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

VAXTPU CREATE_ARRAY — VMS 5.2

 CREATE_ARRAY

    Creates an array.  You can add elements indexed by values of any data
    type except pattern, learn, program, and unspecified.  To add an
    element whose index is not specified by the parameters, simply assign a
    value to an element of an existing array.

 Syntax

    [array_variable :=] CREATE_ARRAY [(integer1 [,integer2])]

 Parameters

    integer1             Optionally, the number of integer-indexed elements
                         you want the array to have.  You can index
                         elements with integers even if you do not specify
                         this parameter.  You can also specify integer
                         indexes that are not within the range created by
                         integer1 and integer2.  However, processing is
                         much faster for integer-indexed elements that are
                         within the range created by integer1 and integer2.

    integer2             Optionally, the lowest integer value you want
                         VAXTPU to use as an index in the array.  The
                         default value is 1.  You can specify a value for
                         integer2 only if you have specified a value for
                         integer1.

 Examples
        The following assignment statement creates an array with 11
        integer-indexed elements.  The first integer-indexed array element
        in the range created by the two parameters is indexed by the value
        -5; the last integer-indexed array element in the range is indexed
        by the value 5.

        array_variable := CREATE_ARRAY (11, -5);

    1.  The following assignment statement creates a dynamic element in the
        array FOO.  The element is indexed by the string BAR.  The value 10
        is assigned to the element.

        foo{"bar"} := 10

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026