Memory Utility Functions

Functions
void	memcpy32 (uint32_t *dst, uint32_t *src, unsigned int len)
int	memcmp32 (uint32_t *dst, uint32_t *src, unsigned int len)

Detailed Description

Function Documentation

memcmp32()

int memcmp32	(	uint32_t *	dst,
		uint32_t *	src,
		unsigned int	len
	)

Compares the first len bytes of src and dst and returns E_NO_ERROR if they match.

Parameters

	dst	Destination address
	src	Source address
[in]	len	Number of bytes to compare between the src and dst.

Note

The compare is done 32-bits at a time and len should be a multiple of 4 and any bytes beyond a multiple of 4 are ignored. For example, the following call to memcmp32() only compares the first 8 bytes (2 32-bit words) of dst and src and would return 0 indicating the memory is the same.

int retval;
int len = 11;
char src[len] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
char dst[len] = {0, 1, 2, 3, 4, 5, 6, 7, 0, 0, 0};
 
if (memcmp32(dst, src, len) != 0)
{
   printf("Memory compare failed\n");
}
else
{
   // memcmp32 passes even though the src and dst are
   // not identical starting at src[8] and dst[8]
   printf("memcmp32 passed.\n");
}

Return values

E_NO_ERROR	Contents of src and dst are equal
E_INVALID	Memory is not equal

memcpy32()

void memcpy32	(	uint32_t *	dst,
		uint32_t *	src,
		unsigned int	len
	)

32-bit wide memory copy.

Parameters

	dst	Pointer to the destination location
	src	Pointer to the source location
[in]	len	Number of bytes to copy which must be a multiple of 4.

Note

This function assumes the destination and source are 32-bit word aligned. A minimum of 1 word is copied (len = 4).