Skip to content

Delete First

Description

This operation deletes values from the beginning of the list and returns them in the response.

Method

Backendless.Hive(hiveName).ListStore(keyName).deleteFirst(count): Promise<values[]>;

where:

Argument                Description
hiveName Name of a hive where the operation is performed. String value.
keyName Key name identifying a list. String value.
count Optional parameter. Identifies the number of items to delete from the list. Defaults to 1.

Return Value

An array containing deleted value(s).

Example

The example below deletes the first 2 values from the 'fruits' list.

await Backendless.Hive('groceryStore').ListStore('fruits').deleteFirst(2)

where:

Argument                Description
'groceryStore' Name of a hive where the operation is performed.
'fruits' Key name identifying a list.

Codeless Reference

list_api_delete_first

where:

Argument                Description
hive name Name of a hive where the operation is performed.
key name Key name identifying a list.
position: first Instructs Hive to delete the first value from the beginning of the list.
count Specifies the number of items to delete.

Returns a list of the deleted values.

Consider the following List storage:

list_api_example_get_values_2

The example below deletes the first value from the beginning of the "fruits" list:
list_api_example_delete_first

The list will look as shown below after the Codeless logic runs:

list_api_example_delete_first_2