strstr, wcsstr, _mbsstr, _mbsstr_l

Článek
03/26/2013

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

Důležité
_mbsstra _mbsstr_l nelze použít v aplikacích, které jsou spuštěny v systému 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
Řetězec zakončený hodnotou Null pro vyhledávání.
strSearch
Řetězec zakončený hodnotou Null vyhledávání.
locale
Chcete-li národní prostředí pro použití.

Vrácená hodnota

Vrací ukazatel na první výskyt strSearch v str, nebo NULL -li strSearch nezobrazí v str.Pokud strSearch odkazuje na řetězec nulové délky, vrátí funkce str.

Poznámky

strstr Funkce vrací ukazatel na první výskyt strSearch v str.Hledání nezahrnuje ukončení znaky null.wcsstra _mbsstr jsou verze širokého znaku a vícebajtové znakové sady strstr.Argumenty a vrácené hodnoty wcsstr jsou řetězci širokého znaku; u _mbsstr jsou vícebajtové znakové řetězce._mbsstrověřuje jeho parametry.Pokud str nebo strSearch je NULL, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů .Je-li pokračovat, je povoleno zpracování _mbsstr nastaví errno na EINVAL a vrátí hodnotu 0.strstra wcsstr nelze ověřit jejich parametry.Tyto tři funkce chovat identicky jinak.

Poznámka k zabezpečení
Tyto funkce při rozloženém potenciální ohrožení vyvolaných problému přetečení vyrovnávací paměti.Přetečení vyrovnávací paměti potíže jsou používaný způsob útoku systému, výsledkem bude vyplacena neoprávněně zvýšení úrovně oprávnění.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

C přijmout tyto funkce const ukazatel pro první argument.V jazyce C++ jsou k dispozici dvě přetížení.Přetížení, přičemž ukazatel na const vrací ukazatel na const; verze, která bere ukazatel na non-const vrací ukazatel na non-const._CONST_CORRECT_OVERLOADS makro je definováno, pokud oba const a non-const verze tyto funkce jsou k dispozici.Chcete-li non-const definovat chování pro obě přetížení C++ symbol _CONST_RETURN.

Výstupní hodnota je ovlivněna nastavenímLC_CTYPE kategorie nastavení národního prostředí; Další informace naleznete v tématu setlocale.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí pro toto chování závislé na národním prostředí; verze s _l s tím rozdílem, že používají místo něho předán parametr locale shodná přípona.Další informace naleznete v tématu Národní prostředí.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcsstr	strstr	_mbsstr	wcsstr
není k dispozici	není k dispozici	_mbsstr_l	není k dispozici

Požadavky

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

Další informace o kompatibilitě v tématu Compatibility.

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 );
}