[][src]Function eosio_cdt_sys::assert_sha256

pub unsafe extern "C" fn assert_sha256(
    data: *const c_char,
    length: u32,
    hash: *const capi_checksum256
)

Tests if the sha256 hash generated from data matches the provided checksum.

@param data - Data you want to hash @param length - Data length @param hash - capi_checksum256* hash to compare to

@pre assert256 hash of data equals provided hash parameter. @post Executes next statement. If was not true, hard return.

@note This method is optimized to a NO-OP when in fast evaluation mode.

Example:

@code checksum hash; char data; uint32_t length; assert_sha256( data, length, hash ) //If the sha256 hash generated from data does not equal provided hash, anything below will never fire. eosio::print("sha256 hash generated from data equals provided hash"); @endcode