[−][src]Function eosio_cdt_sys::db_idx256_lowerbound
pub unsafe extern "C" fn db_idx256_lowerbound(
code: capi_name,
scope: u64,
table: capi_name,
data: *mut uint128_t,
data_len: u32,
primary: *mut u64
) -> i32
Find the table row in a secondary 256-bit index table that matches the lowerbound condition for a given secondary key The table row that matches the lowerbound condition is the first table row in the table with the lowest secondary key that is >= the given key (uses lexicographical ordering on the 256-bit keys)
@brief Find the table row in a secondary 256-bit index table that matches the lowerbound condition for a given secondary key
@param code - The name of the owner of the table
@param scope - The scope where the table resides
@param table - The table name
@param data - Pointer to the secondary key data (which is stored as an array of 2 uint128_t
integers) first used to determine the lowerbound and which is then replaced with the secondary key of the found table row
@param data_len - Must be set to 2
@param primary - Pointer to a uint64_t
variable which will have its value set to the primary key of the found table row
@post If and only if the table row is found, the buffer pointed to by data
will be filled with the secondary key of the found table row
@post If and only if the table row is found, *primary
will be replaced with the primary key of the found table row
@return iterator to the found table row or the end iterator of the table if the table row could not be found