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)
Definido en el encabezado <string.h>
char * strstr ( const char * str, const char * substr ) ;
(1)
/*QChar*/ * strstr ( /*QChar*/ * str, const char * substr ) ;
(2) (desde C23)
1) Encuentra la primera ocurrencia de la cadena de bytes terminada en nulo apuntada por substr en la cadena de bytes terminada en nulo apuntada por str . Los caracteres nulos de terminación no se comparan.
2) Función genérica de tipos equivalente a (1) . Sea T un tipo de objeto de carácter no calificado.
  • Si str es de tipo const T * , el tipo de retorno es const char * .
  • De lo contrario, si str es de tipo T * , el tipo de retorno es char * .
  • De lo contrario, el comportamiento es indefinido.
Si se suprime la definición de macro de cada una de estas funciones genéricas para acceder a una función real (por ejemplo, si se usa ( strstr ) o un puntero a función), la declaración de función real (1) se hace visible.

El comportamiento es indefinido si str o substr no son punteros a una cadena de bytes terminada en nulo.

Contenidos

Parámetros

str - puntero a la cadena de bytes terminada en nulo a examinar
substr - puntero a la cadena de bytes terminada en nulo a buscar

Valor de retorno

Puntero al primer carácter de la subcadena encontrada en str , o un puntero nulo si no se encuentra dicha subcadena. Si substr apunta a una cadena vacía, str es retornado.

Ejemplo

Ejecutar este código 
#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;
}

Salida: 

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

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.24.5.7 La función strstr (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.24.5.7 La función strstr (p: 269)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.24.5.7 La función strstr (p: 369)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.21.5.7 La función strstr (p: 332)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.11.5.7 La función strstr

Véase también

encuentra la primera ocurrencia de un carácter
(función)
encuentra la última ocurrencia de un carácter
(función)
Documentación de C++ para strstr