Namespaces
Variants

strstr

From cppreference.net
< c ‎ | string ‎ | byte
C
Strings library
Null-terminated byte strings
Functions
Character manipulation
Conversions to and from numeric formats
String manipulation
String examination
Memory manipulation
Miscellaneous
(C11) (C11)
Definiert im Header <string.h>
char * strstr ( const char * str, const char * substr ) ;
(1)
/*QChar*/ * strstr ( /*QChar*/ * str, const char * substr ) ;
(2) (seit C23)
1) Findet das erste Vorkommen der nullterminierten Byte-Zeichenkette, auf die substr zeigt, in der nullterminierten Byte-Zeichenkette, auf die str zeigt. Die abschließenden Nullzeichen werden nicht verglichen.
2) Typgenerische Funktionsäquivalent zu (1) . Sei T ein unqualifizierter Zeichenobjekttyp.
  • Falls str vom Typ const T * ist, ist der Rückgabetyp const char * .
  • Andernfalls, falls str vom Typ T * ist, ist der Rückgabetyp char * .
  • Andernfalls ist das Verhalten undefiniert.
Falls eine Makrodefinition jeder dieser generischen Funktionen unterdrückt wird, um auf eine tatsächliche Funktion zuzugreifen (z.B. wenn ( strstr ) oder ein Funktionszeiger verwendet wird), wird die tatsächliche Funktionsdeklaration (1) sichtbar.

Das Verhalten ist undefiniert, falls entweder str oder substr kein Zeiger auf eine nullterminierte Byte-Zeichenkette ist.

Inhaltsverzeichnis

Parameter

str - Zeiger auf den nullterminierten Byte-String zur Untersuchung
substr - Zeiger auf den nullterminierten Byte-String für die Suche

Rückgabewert

Zeiger auf das erste Zeichen der gefundenen Teilzeichenkette in str , oder ein Nullzeiger falls keine solche Teilzeichenkette gefunden wurde. Wenn substr auf eine leere Zeichenkette zeigt, wird str zurückgegeben.

Beispiel

Diesen Code ausführen 
#include <stdio.h>
#include <string.h>
void find_str(char const* str, char const* substr)
{
    char const* pos = strstr(str, substr);
    if (pos)
        printf(
            "Found the string [%s] in [%s] at position %td\n",
            substr, str, pos - str
        );
    else
        printf(
            "The string [%s] was not found in [%s]\n",
            substr, str
        );
}
int main(void)
{
    char const* str = "one two three";
    find_str(str, "two");
    find_str(str, "");
    find_str(str, "nine");
    find_str(str, "n");
    return 0;
}

Ausgabe: 

Found the string [two] in [one two three] at position 4
Found the string [] in [one two three] at position 0
The string [nine] was not found in [one two three]
Found the string [n] in [one two three] at position 1

Referenzen

  • C23-Standard (ISO/IEC 9899:2024):
  • 7.24.5.7 Die strstr-Funktion (S: TBD)
  • C17-Standard (ISO/IEC 9899:2018):
  • 7.24.5.7 Die strstr-Funktion (S: 269)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.24.5.7 Die strstr-Funktion (S: 369)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.21.5.7 Die strstr-Funktion (S: 332)
  • C89/C90 Standard (ISO/IEC 9899:1990):
  • 4.11.5.7 Die strstr-Funktion

Siehe auch

findet das erste Vorkommen eines Zeichens
(Funktion)
findet das letzte Vorkommen eines Zeichens
(Funktion)
C++-Dokumentation für strstr