llDeleteKeyValue

Requires Experience

key llDeleteKeyValue(string Key)

Starts an asychronous transaction to delete a key-value pair. The dataserver callback will be executed with the key returned from this call and a string describing the result. The result is a two element commma-delimited list. The first item is an integer specifying if the transaction succeeded (1) or not (0). In the failure case, the second item will be an integer corresponding to one of the XP_ERROR_... constants. In the success case the second item will be the value associated with the key.

Parameters

Key (string)

Technical Details

Return Type: key
Energy: 10

key trans;
default
{
    state_entry()
    {
        trans = llDeleteKeyValue("FOO");
    }

    dataserver(key t, string value)
    {
        if (t == trans)
        {
            // our llDeleteKeyValue transaction is done
            list result = llCSV2List(value);
            if (llList2Integer(result, 0) == 1)
            {
                // the key-value pair was successfully deleted
                llSay(0, "New key-value pair was deleted");
            }
            else
            {
                // the key-value pair was not deleted
                llSay(0, "Key-value failed to delete: " + llList2String(result, 1) );
            }
        }
    }
}

Notes

If the key does not exist, the dataserver event will return a failure with the error XP_ERROR_STORAGE_EXCEPTION
This is an asynchronous operation that uses the dataserver event to return results
Use llGetExperienceErrorMessage to get human-readable error messages

llDeleteKeyValue

Notes

See Also