strchr

This macro locates the first occurrence of a character in a string.

Syntax:

char *strchr (str1, byte_value)
char *str1;
char byte_value;

where:

str1 This is a character pointer to the memory location of the first character byte in a string of characters.

byte_value             This is a variable of character type, used to specify the character that the strchr macro must search for. The terminating ‘\0’ is part of the string, so it can be searched for.

Return Value

char*                     Points to the first memory location of the first occurrence of the character byte_value byte. If this character is not found, a NULL pointer is returned.

Rules

For debugger variables only, a value of -1 (0xFFFFFFFF) is returned, when byte_value does not occur in the memory searched by strchr.