memclr

This macro replaces the specified number of characters in str1 with the NUL character (‘\0’) starting at the beginning of str1. If count is less than the length of str1, the macro returns a pointer that points to the address of the character following the area that is cleared.

Syntax:

char *memclr (*str1, count)
char *str1;
int count;

where:

str1                       This is a character pointer to the memory location of the first character byte in a string of characters that will be replaced by the NUL character.

count                    This is a variable of integer type, used to specify the number of consecutive bytes of memory in a character string that are to be replaced by the NUL character.

Return Value

char*                     Points to the first character byte after the string of characters overwritten with the NUL character.

Rules

None.