Base/code/exports/librr/memory.h

#ifndef RR_RUNES_H
#define RR_RUNES_H

#include <librr/types.h>


/// @brief Tests if two memory regions overlap partially or completely.
/// @param block1 Block to check for overlapping with block2.
//  If the address of this block is higher than that of block2, the blocks will be swapped internally.
/// @param length1 The length of the first block.
/// @param block2 The second block to check for overlapping. 
/// @param length2 
/// @return Whether the two blocks overlap.
bool_t rr_mem_overlap(void *block1, usz_t length1, void *block2, usz_t length2);

/// @brief Checks if two memory blocks contain the equal data. 
/// @param block1 Address of the data to be checked for equality with 'block2'
/// @param block2 Address of the other memory block. In cases where there is a clear correct version,
///  this should be the correct data to be checked against.
/// @param count How many bytes will be checked.
/// @return Whether the two memory regions are equal
bool_t rr_memequ(void *block1, void *block2, usz_t count);

/// @brief Sets all bytes in a memory region all to one byte
/// @param destination Address to the memory region to fill with one byte
/// @param count Number of bytes to set; length of 'destination'
/// @param value Value to write to every bte of 'destination'.
void rr_memset(void *destination, usz_t count, u8_t value);

/// @brief Repeats a sequence until a number of bytes was filled, potentially only writing a sequence half-way.
/// @attention The sequence cannot be contained in the destination.
/// @param destination Address in memory in which the sequence will be repeated.
/// @param num_bytes How many bytes of the destination should be filled. The last sequence can be partially finished.
/// @param sequence Sequence of bytes which will be written to destination.
/// @param len_sequence Length of 'sequence'
/// @return The number of attempted or partial repetitions which have been performed.
usz_t rr_memrep(void *destination, usz_t num_bytes, void *sequence, usz_t len_sequence);


#endif // LIBRR_RUNES_H