=====strstr=====
Syntax:

<code>
    #include <cstring>
    const char *strstr( const char *str1, const char *str2 );
          char *strstr(       char *str1, const char *str2 );
</code>

The function ''strstr'' returns a pointer to the first occurrence of ''str2'' in
''str1'', or ''NULL'' if no match is found. If the length of ''str2'' is zero, then ''strstr''
 will simply return ''str1''.

For example, the following code checks for the existence of one string within
another string:

<code>
    char* str1 = "this is a string of characters";
    char* str2 = "a string";
    char* result = strstr( str1, str2 );
    if( result == NULL ) printf( "Could not find '%s' in '%s'\n", str2, str1 );
    else printf( "Found a substring: '%s'\n", result );
</code>

When run, the above code displays this output:

<code>
    Found a substring: 'a string of characters'
</code>

Related Topics: [[memchr]], [[strchr]], [[strcspn]], [[strpbrk]], [[strrchr]], [[strspn]], [[strtok]]