strchr,wcschr,_mbschr,_mbschr_l

Hiermee zoekt u een teken in een tekenreeks met behulp van de huidige landinstelling of een opgegeven LC_CTYPE categorie voor conversiestatus.

Important

_mbschr en _mbschr_l kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime. Zie CRT-functies die niet worden ondersteund in Universeel Windows-platform-apps voor meer informatie.

Syntax

char *strchr(
   const char *str,
   int c
);  // C only
char *strchr(
   char * str,
   int c
); // C++ only
const char *strchr(
   const char * str,
   int c
); // C++ only
wchar_t *wcschr(
   const wchar_t *str,
   wchar_t c
); // C only
wchar_t *wcschr(
   wchar_t *str,
   wchar_t c
);  // C++ only
const wchar_t *wcschr(
   const wchar_t *str,
   wchar_t c
);  // C++ only
unsigned char *_mbschr(
   const unsigned char *str,
   unsigned int c
); // C only
unsigned char *_mbschr(
   unsigned char *str,
   unsigned int c
); // C++ only
const unsigned char *_mbschr(
   const unsigned char *str,
   unsigned int c
); // C++ only
unsigned char *_mbschr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C only
unsigned char *_mbschr_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only
const unsigned char *_mbschr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only

Parameters

str
Null-beëindigde brontekenreeks.

c
Het teken dat moet worden gevonden.

locale
Landinstelling die moet worden gebruikt.

Retourwaarde

Elk van deze functies retourneert een aanwijzer naar het eerste exemplaar van c in str, of NULL als c deze niet wordt gevonden.

Remarks

De strchr functie zoekt het eerste exemplaar van c in strof retourneert NULL als c deze niet wordt gevonden. Het null-afsluitteken wordt opgenomen in de zoekopdracht.

wcschr _mbschr_l en _mbschr zijn wide-character en multibyte-character versies van strchr. De argumenten en de retourwaarde zijn wcschr tekenreeksen met een breed teken. De argumenten en de retourwaarde zijn _mbschr tekenreeksen met meerdere tekens. _mbschr herkent reeksen met meerderebyte tekens. Als de tekenreeks een null-aanwijzer is, _mbschr roept u ook de ongeldige parameterhandler aan, zoals beschreven in parametervalidatie. Als de uitvoering mag worden voortgezet, _mbschr worden deze geretourneerd NULL en ingesteld errno op EINVAL. strchr en wcschr valideer hun parameters niet. Deze drie functies gedragen zich op dezelfde manier als anders.

De uitvoerwaarde wordt beïnvloed door de instelling van de LC_CTYPE categorie-instelling van de landinstelling. Zie setlocalevoor meer informatie. De versies van deze functies zonder achtervoegsel _l gebruiken de huidige landinstelling voor dit afhankelijke gedrag. De versies met het _l achtervoegsel zijn identiek, behalve dat ze de landinstellingparameter gebruiken die in plaats daarvan is doorgegeven. Zie Landinstellingen voor meer informatie.

In C hebben deze functies een const aanwijzer voor het eerste argument. In C++zijn er twee overbelastingen beschikbaar. De overbelasting die een aanwijzer neemt om een aanwijzer terug te const geven naar const; de versie die een aanwijzer naar niet-retourneertconstconst. De macro _CRT_CONST_CORRECT_OVERLOADS wordt gedefinieerd als zowel de const als niet-versiesconst van deze functies beschikbaar zijn. Als u het niet-gedrag voor beide C++-const overbelastingen vereist, definieert u het symbool _CONST_RETURN.

De globale status van deze functie is standaard gericht op de toepassing. Als u dit gedrag wilt wijzigen, raadpleegt u de globale status in de CRT.

Algemene routinetoewijzingen voor tekst

TCHAR.H Routine _UNICODE en _MBCS niet gedefinieerd _MBCS Gedefinieerd _UNICODE Gedefinieerd
_tcschr strchr _mbschr wcschr

Requirements

Routine Vereiste header
strchr <string.h>
wcschr <string.h> of <wchar.h>
_mbschr, _mbschr_l <mbstring.h>

Zie Compatibiliteit voor meer informatie over compatibiliteit.

Example

// crt_strchr.c
//
// This program illustrates searching for a character
// with strchr (search forward) or strrchr (search backward).
//

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

int  ch = 'r';

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_s( "String to be searched:\n      %s\n", string );
   printf_s( "      %s\n      %s\n\n", fmt1, fmt2 );
   printf_s( "Search char:   %c\n", ch );

   // Search forward.
   pdest = strchr( string, ch );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf_s( "Result:   first %c found at position %d\n",
              ch, result );
   else
      printf_s( "Result:   %c not found\n", ch );

   // Search backward.
   pdest = strrchr( string, ch );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf_s( "Result:   last %c found at position %d\n", ch, result );
   else
      printf_s( "Result:\t%c not found\n", ch );
}
String to be searched:
      The quick brown dog jumps over the lazy fox
               1         2         3         4         5
      12345678901234567890123456789012345678901234567890

Search char:   r
Result:   first r found at position 12
Result:   last r found at position 30

Zie ook

Tekenreeksmanipulatie
Locale
Interpretatie van reeksen met meerderebyte tekens
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncat, , _strncat_lwcsncat, _wcsncat_l, , , _mbsncat_mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, , _strncpy_lwcsncpy, _wcsncpy_l, , , _mbsncpy_mbsncpy_l
_strnicmp, , _wcsnicmp_mbsnicmp, _strnicmp_l, , , _wcsnicmp_l_mbsnicmp_l
strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
strstr, wcsstr, _mbsstr, _mbsstr_l