Texas Instruments TI-89 - Strstr

1002
Appendix A: System Routines — Strings
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
strstr
Declaration:
char *
strstr
(const char *
s1
, const char *
s2
)
Category(ies):
Strings
Description:
Searches the string pointed to by
s1
for a substring matching the string
pointed to by
s2
.
Inputs:
s1
— Character string to search in.
s2
— Character string to search for.
Outputs:
Returns a pointer to the first character of the matching substring in
s1
, or a
null pointer if no matching substring is found.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: strchr, memchr
Example:
BOOL findstr( const char *str1, const char *str2, char *buf )
/* findstr - Find the first instance of string str2 in string str1.
Return TRUE if found str2 in str1 and build message in buf,
else return FALSE.
*/
{
char *ptr;
if( ( ptr = strstr(str1, str2)) == NULL )
return( FALSE ); /* str2 not found in str1 */
sprintf( buf, "Found '%s' at position %d in string: %s\n",
str2, (ptr - str1 + 1), str1);
return( TRUE );
}