Compartilhar via


char_traits::find

Procura a primeira ocorrência de um caractere especificado em um intervalo de caracteres.

static const char_type* find( 
   const char_type* _Str,  
   size_t _Num,  
   const char_type& _Ch  
);

Parâmetros

  • _Str
    O primeiro caractere na cadeia de caracteres a ser pesquisada.

  • _Num
    O número de posições, contando do primeiro, no intervalo a ser pesquisado.

  • _Ch
    O caractere a ser pesquisado no intervalo.

Valor de retorno

Um ponteiro para a primeira ocorrência de caractere especificado no intervalo se for encontrada uma correspondência; caso contrário, um ponteiro nulo.

Exemplo

// char_traits_find.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( ) 
{
   using namespace std;

   const char* s1 = "f2d-1234-abcd";
   const char* result1;
   cout << "The string to be searched is: " << s1 << endl;

   // Searching for a 'd' in the first 6 positions of string s1
   result1 = char_traits<char>::find ( s1 , 6 , 'd');
   cout << "The character searched for in s1 is: "
        << *result1 << endl;
   cout << "The string beginning with the first occurrence\n "
        << "of the character 'd' is: " << result1 << endl;

   // When no match is found the NULL value is returned
   const char* result2;
   result2 = char_traits<char>::find ( s1 , 3 , 'a');
   if ( result2 == NULL )
      cout << "The result2 of the search is NULL." << endl;
   else
      cout << "The result2 of the search  is: " << result1
           << endl;
}
  

Requisitos

Cabeçalho: <cadeia de caracteres>

Namespace: std

Consulte também

Referência

Struct char_traits