Str_Char_Last_N()
Finds the last occurrence of a specific character in a string, up to a maximum number of characters.
Files
lib_str.h/lib_str.c
Prototype
CPU_CHAR *Str_Char_Last_N (const CPU_CHAR *pstr, CPU_SIZE_T len_max, CPU_CHAR srch_char);
Arguments
pstr
Pointer to the string to search for the specified character.
len_max
Maximum number of string characters to search.
srch_char
Character to search for in the string.
Returned Value
Pointer to last occurrence of character in string, if no errors;
Pointer to NULL
, otherwise.
Required Configuration
None.
Notes / Warnings
String buffer not modified.
String search terminates if string pointer points to or overlaps the NULL
address.
Ideally, Str_Char_Last_N()
’s len_max
argument would be the last argument in this function’s argument list for consistency with all other custom string library functions. However, the len_max
argument is sequentially ordered as the second argument to comply with most standard library’s strnrchr()
argument list.
Example Usage
CPU_CHAR *pstr; pstr = Str_Char_Last_N("Hello World!", 5u, 'l');