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 pesquisada.

  • _Ch
    O caractere a ser pesquisada no intervalo.

Valor de retorno

Um ponteiro para a primeira ocorrência do caractere especificado no intervalo se uma correspondência for encontrada; 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: <string>

namespace: STD

Consulte também

Referência

char_traits Struct