Delete Values

Description

This operation deletes specific elements from the set.

Method

Objective-CSwift

// Delete One Value
[[[Backendless.shared hive:(NSString *)hiveName] setStore:(NSString *)keyName] deleteWithValue:(id)value responseHandler:^(NSInteger)responseHandler errorHandler:^(Fault *)errorHandler];

// Delete Multiple Values
[[[Backendless.shared hive:(NSString *)hiveName] setStore:(NSString *)keyName] deleteWithValues:(NSArray *)values responseHandler:^(NSInteger)responseHandler errorHandler:^(Fault *)errorHandler];

// Delete One Value
Backendless.shared.hive(hiveName: String).setStore(keyName: String).delete(value: Any, responseHandler: ((Int) -> Void)!, errorHandler: ((Fault) -> Void)!)

// Delete Multiple Values
Backendless.shared.hive(hiveName: String).setStore(keyName: String).delete(values: [Any], responseHandler: ((Int) -> Void)!, errorHandler: ((Fault) -> Void)!)

where:

Argument	Description
hiveName	Name of a hive where the operation is performed. String value.
keyName	Key name identifying a set. String value.
value	A value to delete from the set. Value can be of any data type.
values	An array of values to delete from the set. Values can be of any data type.

Return Value

The number of deleted items. Otherwise, returns 0 if the specified values do not exist.

Example

Delete One Value

The example below deletes the "Crossover" value from the "cars" set.

Objective-CSwift

[[[Backendless.shared hive:@"transport"] setStore:@"cars"] deleteWithValue:@"Crossover" responseHandler:^(NSInteger response) {
    // handle response
} errorHandler:^(Fault *fault) {
    // handle error
}];

Backendless.shared.hive("transport").setStore("cars").delete(value: "Crossover", responseHandler: { response in
    // handle response
}, errorHandler: { fault in
    // handle error
})

where:

Argument	Description
"transport"	Name of a hive where the operation is performed.
"cars"	Key name identifying a set.

Delete Multiple Values

The example below deletes the "Sedan" and "Crossover" items from the "cars" set.

Objective-CSwift

[[[Backendless.shared hive:@"transport"] setStore:@"cars"] deleteWithValues:@[@"Sedan", @"Crossover"] responseHandler:^(NSInteger response) {
    // handle response
} errorHandler:^(Fault *fault) {
    // handle error
}];

Backendless.shared.hive("transport").setStore("cars").delete(values: ["Sedan", "Crossover"], responseHandler: { response in
    // handle response
}, errorHandler: { fault in
    // handle error
})

where:

Argument	Description
"transport"	Name of a hive where the operation is performed.
"cars"	Key name identifying a set.

Codeless Reference

where:

Argument	Description
hive name	Name of a hive where the operation is performed.
key name	Key name identifying a set.
items	A list of items that must be deleted from the set.

Returns the number of deleted values.

Consider the following Set storage:

The example below deletes two items "Sedan" and "Crossover" from the "cars" set:

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