Bin operations

You can use the Rust client API to perform separate operations on multiple bins in a record in a single command. This feature allows the application to modify and read bins of a record in a single transaction (that is, perform an atomic modification that returns the result).

Some record operations include:

Operation	Description	Conditions
`write`	Write a value to a bin.
`get`	Read the value of a bin.
`get_header`	Read only the metadata (generation and time-to-live) of the record.
`add`	Add an integer to the existing value of the bin.	The existing value must be integer.
`append`	Append a string to the existing value of the bin.	The existing value must be string.
`prepend`	Prepend a string to the existing value of the bin.	The existing value must be string.
`touch`	Rewrite the same record.	Generation and time-to-live are updated.

Operation specification

To specify operations on different bins in the same transaction, create the bins with the values to apply:

let key = as_key!("test", "demoset", "opkey");
let bin1 = as_bin!("optintbin", 7);
let bin2 = as_bin!("optstringbin", "string value");
match client.put(&policy, &key, &vec![&bin1, &bin2]).await {
    Ok(()) => println!("Record written"),
    Err(err) => println!("Error writing record: {}", err),
};

let bin3 = as_bin!(bin1.name, 4);
let bin4 = as_bin!(bin2.name, "new string");

📖 API Reference: Client::put

Create the appropriate operations using the bins and supply them to the operate() function:

let ops = vec![
    operations::add(&bin3),
    operations::put(&bin4),
    operations::get(),
];
match client.operate(&policy, &key, &ops).await {
    Ok(record) => match record.bins.get(bin1.name) {
        Ok(val) => println!("optintbin: {}", val),
        Err(err) => println!("Error while getting bin value: {}", err),
    }
    Err(err) => println!("Error writing record: {}", err),
}

📖 API Reference: Client::operate | operations::add | operations::put | operations::get