strstr, wcsstr, _mbsstr, _mbsstr_l

Článek
06/09/2015

Vrací ukazatel na první výskyt hledaného řetězce v řetězci.

Důležité
_mbsstr a _mbsstr_l nelze použít v aplikacích, které jsou spouštěny v prostředí Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

char *strstr(
   const char *str,
   const char *strSearch 
); // C only
char *strstr(
   char *str,
   const char *strSearch 
); // C++ only
const char *strstr(
   const char *str,
   const char *strSearch 
); // C++ only
wchar_t *wcsstr(
   const wchar_t *str,
   const wchar_t *strSearch 
); // C only
wchar_t *wcsstr(
   wchar_t *str,
   const wchar_t *strSearch 
); // C++ only
const wchar_t *wcsstr(
   const wchar_t *str,
   const wchar_t *strSearch 
); // C++ only
unsigned char *_mbsstr(
   const unsigned char *str,
   const unsigned char *strSearch 
); // C only
unsigned char *_mbsstr(
   unsigned char *str,
   const unsigned char *strSearch 
); // C++ only
const unsigned char *_mbsstr(
   const unsigned char *str,
   const unsigned char *strSearch 
); // C++ only
unsigned char *_mbsstr_l(
   const unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C only
unsigned char *_mbsstr_l(
   unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C++ only
const unsigned char *_mbsstr_l(
   const unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C++ only

Parametry

str
Hledaný řetězec zakončený hodnotou null.
strSearch
Hledaný řetězec zakončený hodnotou null.
locale
Použité národní prostředí.

Vrácená hodnota

Vrací ukazatel na první výskyt strSearch v str nebo NULL, pokud strSearch není v str.Pokud strSearch ukazuje na řetězec nulové délky, vrátí funkce str.

Poznámky

Funkce strstr vrací ukazatel na první výskyt strSearch v str.Hledání nezahrnuje ukončovací znaky null.wcsstr je širokoznaká verze strstr a _mbsstr je vícebajtová verze.Argumenty a vrácené hodnoty wcsstr jsou širokoznaké řetězce. Hodnoty _mbsstr jsou vícebajtové znakové řetězce._mbsstr ověří jeho parametry.Pokud je str nebo strSearch rovno NULL, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, _mbsstr nastaví errno na EINVAL a vrátí 0.strstr a wcsstr neověří jejich parametry.Tyto tři funkce se chovají identicky jinak.

Poznámka k zabezpečení
Tyto funkce mohou způsobit hrozbu problému přetečení vyrovnávací paměti.Problémy přetečení vyrovnávací paměti lze použít k útoku na systém, protože mohou umožnit spuštění libovolného kódu, což může způsobit neoprávněné zvýšení úrovně oprávnění.Další informace naleznete v tématu Předcházení přetečení vyrovnávací paměti.

V C tyto funkce použijí ukazatel const pro první argument.V jazyce C++ jsou k dispozici dvě přetížení.Přetížení, které přijímá ukazatel na const, vrací ukazatel na const. Verze, která přijímá ukazatel na ne const, vrací ukazatel na ne const.Makro _CONST_CORRECT_OVERLOADS je definováno, pokud jsou verze const i ne const těchto funkcí k dispozici.Vyžadujete-li non-const chování pro obě přetížení C++, definujte symbol _CONST_RETURN.

Výstupní hodnota je ovlivněna nastavením kategorie LC_CTYPE. Další informace naleznete v tématu setlocale, _wsetlocale.Verze těchto funkcí, které nemají příponu _l, používají aktuální národní prostředí pro toto závislé chování. Verze, které mají příponu _l, jsou shodné, s výjimkou toho, že místo toho používají parametr národního prostředí, který je předán.Další informace naleznete v tématu Národní prostředí.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tcsstr	strstr	_mbsstr	wcsstr
není k dispozici	není k dispozici	_mbsstr_l	není k dispozici

Požadavky

Rutina	Požadované záhlaví
strstr	<string.h>
wcsstr	<string.h> nebo <wchar.h>
_mbsstr, _mbsstr_l	<mbstring.h>

Další informace o kompatibilitě naleznete v Kompatibilita.

Příklad

// crt_strstr.c

#include <string.h>
#include <stdio.h>

char str[] =    "lazy";
char string[] = "The quick brown dog jumps over the lazy fox";
char fmt1[] =   "         1         2         3         4         5";
char fmt2[] =   "12345678901234567890123456789012345678901234567890";

int main( void )
{
   char *pdest;
   int  result;
   printf( "String to be searched:\n   %s\n", string );
   printf( "   %s\n   %s\n\n", fmt1, fmt2 );
   pdest = strstr( string, str );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf( "%s found at position %d\n", str, result );
   else
      printf( "%s not found\n", str );
}