a!keys Function

Function

a!keys( value )

Returns the keys of the provided map, dictionary, CDT, or record.

Parameters

Returns

List

Usage considerations

• a!keys cannot be used on lists or scalar values, such as text, integers, and dates.
• The value parameter must be a collection such as a map, dictionary, CDT, or record.

Examples

Retrieving keys of a map or dictionary

1
a!keys(value: a!map(a: 1, b: 2) )
Copy

Returns {"a", "b"}.

1
a!keys(value: a!map() )
Copy

Returns {}.

1
a!keys(value: {c: 3, d: 4} )
Copy

Returns {"c", "d"}.

Retrieving keys of a CDT

In order to test the following CDT examples, you will need to create a CDT (Customer) with three fields (id, name, and age).

1
a!keys(value: type!Customer(id: 3, name: "John", age: 30))
Copy

Returns {"id", "name", "age"}.

1
a!keys(value: type!Customer())
Copy

Returns {"id", "name", "age"}. Since CDTs always have all of the fields in the data type, even when no values are set, all the keys of the CDT are returned.

Retrieving keys of a record

In order to test the following record examples, you will need to create a record type (Customer) with three fields (id, name, and age). For record examples, use record field references instead of strings shown in the examples below.

1
a!keys(value: recordType!Customer(id: 4, name: "Jane", age: 42))
Copy

Returns {recordType!Customer.fields.id, recordType!Customer.fields.name, recordType!Customer.fields.age}. When referencing record type, this function return a list of record field references, instead of returning a list of text keys like for maps, CDTs, or dictionaries.

1
a!keys(value: recordType!Customer())
Copy

Returns {}. Since the record has no values defined, there are no keys present in the data type.

In the next example, the record type Customer has a fourth field (Address), which has 1:1 relationship with the record type Address.

1
a!keys(value: recordType!Customer(id: 4, name: "Jane", age: 42, Address: recordType!Address( zip: 12345 )))
Copy

Returns {recordType!Customer.fields.id, recordType!Customer.fields.name, recordType!Customer.fields.age, recordType!Customer.relationships.Address}. Since this record contains a record relationship, the function returns a list of keys containing both the record field references and the record relationship reference.

Feature compatibility

Feedback