Str_Char_N()

Finds the first 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_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 first 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_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 strnchr() argument list.

Example Usage

          CPU_CHAR  *pstr;
           
          pstr = Str_Char_N("Hello World!", 5u, 'l');