RealView Debugger Command Line Reference Guide: 3.2.33. strchr

Locates the first occurrence of a character in a string.

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 NUL character '\0' is part of the string, so it can be searched for.

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

char *: Points to the first memory location of the first occurrence of the character byte_value byte. If no instance of the character being searched for is found, then a NULL pointer is returned.

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

This example shows how to use strchr in a macro:

define /R void substr(character)
  char character;
{
  char *pos;
  pos = strchr("This is a string",character);
  $printf "position: %s\n",pos$;
}
.

Copyright © 2002-2010 ARM Limited. All rights reserved.	ARM DUI 0175M
Non-Confidential	ID102410
PDF version