ASKEYS Function

Obtains the key names for a given associative array.

Usage

result = ASKEYS(asarr)

Input Parameters

The name of an associative array.

Returned Value

A string containing the key names in the given associative array. If the array is empty, an empty string is returned.

Keywords

Discussion

A key name is the name associated with an element in an associative array. ASKEYS returns the key names of the elements in an associative array. If the associative array is empty, an empty string is returned. To create an associative array, use the ASARR function.

Example

ASKEYS is used to obtain the key names in an associative array. The names are used to reference the values of the array to replace the original values with new integer values. The INFO command is then used to show the modified contents of the associative array.

asar = ASARR('byte', 1B, 'float', 2.2, 'string', '3.3', $
    'struct', {,a:1, b:lindgen(2)})
keys = ASKEYS(asar)
PRINT, keys

byte struct float string

; These key names appear later in the output of the INFO command.

FOR I = 0, N_ELEMENTS(asar1) - 1 DO $
    asar1(keys(i)) = i + 10
INFO, asar1, /Full

; Show the replaced values.

ASAR1	AS. ARR = Associative Array(4) 
    byte 	INT 	= 	10
    struct 	INT 	= 	11
    float 	INT 	= 	12
    string 	INT 	= 	13

See Also

doc@boulder.vni.com

Copyright © 1999, Visual Numerics, Inc. All rights reserved.