The MAKE_ARRAY function enables you to dynamically create an array whose characteristics are not known until run time.

Examples


To create a 3-element by 4-element integer array with each element set to the value 5, enter:

M = MAKE_ARRAY(3, 4, /INTEGER, VALUE = 5)

Syntax


Result = MAKE_ARRAY ( [D1[, ..., D8]], DIMENSION=vector, INCREMENT=value, /INDEX, /NOZERO, SIZE=vector, START=value, TYPE=type_code, VALUE=value, /BOOLEAN, /BYTE, /COMPLEX, /DCOMPLEX, /DOUBLE, /FLOAT, /INTEGER, /L64, /LONG, /OBJ, /PTR, /STRING, /UINT, /UL64, /ULONG )

Return Value


Returns an array of the specified type, dimensions, and initialization.

Arguments


Di

Either an array or a series of scalar expressions specifying the dimensions of the result. If a single argument is specified, it can be either a scalar expression or an array of up to eight elements. If multiple arguments are specified, they must all be scalar expressions. Up to eight dimensions can be specified. If the dimension arguments are not integer values, IDL will convert them to integer values before creating the new array.

The Di arguments are optional if the dimensions of the result are specified using the DIMENSION keyword. Note that you should supply either the Di arguments or a value for the DIMENSION keyword, but not both.

Keywords


BOOLEAN

Set this keyword to create a boolean array.

BYTE

Set this keyword to create a byte array.

COMPLEX

Set this keyword to create a complex, single-precision, floating-point array.

DCOMPLEX

Set this keyword to create a complex, double-precision, floating-point array.

DIMENSION

An array of up to eight scalar elements, specifying the dimensions of the result. Note that you should supply either the Di arguments or a value for the DIMENSION keyword, but not both.

DOUBLE

Set this keyword to create a double-precision, floating-point array.

FLOAT

Set this keyword to create a single-precision, floating-point array.

INCREMENT

Set this keyword to a double-precision number giving the spacing between values in the array. The default is 1. Setting this keyword is equivalent to multiplying each array element by this value and then converting to the result type. This keyword is only applied if INDEX is set. This keyword is ignored for arrays of boolean, objects, or pointers.

INDEX

Set this keyword to initialize the array with each element set to the value of its one-dimensional subscript. This keyword cannot be used with arrays of boolean, objects, or pointers.

INTEGER

Set this keyword to create an integer array.

L64

Set this keyword to create a 64-bit integer array.

LONG

Set this keyword to create a longword integer array.

NOZERO

Set this keyword to prevent the initialization of the array. Normally, each element of the resulting array is set to zero.

Note: This keyword is ignored for arrays of boolean, strings, objects, or pointers. Arrays of these types will always be initialized to zero.

OBJ

Set this keyword to create an object reference array.

PTR

Set this keyword to create a pointer array.

SIZE

A size vector specifying the type and dimensions of the result. The format of a size vector is given in the description of the SIZE function.

START

Set this keyword to a double-precision number giving the value of the first element in the array when the array is initialized by index. The default is 0. Setting this keyword is equivalent to adding a constant offset to each element (after first multiplying by INCREMENT if necessary) and then converting to the result type. This keyword is only applied if INDEX is set. This keyword is ignored for arrays of boolean, objects, or pointers.

STRING

Set this keyword to create a string array.

TYPE

The type code to set the type of the result.

Type Code

Type Name

Data Type

0

UNDEFINED

Undefined

1

BYTE

Byte

2

INT

Integer

3

LONG

Longword integer

4

FLOAT

Floating point

5

DOUBLE

Double-precision floating

6

COMPLEX

Complex floating

7

STRING

String

8

STRUCT

Structure

9

DCOMPLEX

Double-precision complex

10

POINTER

Pointer

11

OBJREF

Object reference

12

UINT

Unsigned Integer

13

ULONG

Unsigned Longword Integer

14

LONG64

64-bit Integer

15

ULONG64

Unsigned 64-bit Integer

Note: All type code values except for TYPE=8 (structures) are valid. To create an array of structures, use the REPLICATE function.

UINT

Set this keyword to create an unsigned integer array.

UL64

Set this keyword to create an unsigned 64-bit integer array.

ULONG

Set this keyword to create an unsigned longword integer array.

VALUE

The value to initialize each element of the resulting array. VALUE can be a scalar of any type including structure types. The result type is taken from VALUE unless one of the other keywords that specify a type is also set. In that case, VALUE is converted to the type specified by the other keyword prior to initializing the resulting array.

Thread Pool Keywords

This routine is written to make use of IDL’s thread pool, which can increase execution speed on systems with multiple CPUs. The values stored in the !CPU system variable control whether IDL uses the thread pool for a given computation. In addition, you can use the thread pool keywords TPOOL_MAX_ELTS, TPOOL_MIN_ELTS, and TPOOL_NOTHREAD to override the defaults established by !CPU for a single invocation of this routine. See Thread Pool Keywords for details.

Version History


4.0

Introduced

8.2.1 Added START keyword
8.3 Added INCREMENT keyword
8.4 Added BOOLEAN keyword

See Also


BOOLARR, BYTARR, COMPLEXARR, DBLARR, DCOMPLEXARR, FLTARR, INTARR, LON64ARR, LONARR, REPLICATE, STRARR, UINTARR, ULON64ARR, ULONARR