Partilhar via


basic_string::substr

Copia uma subcadeia de caracteres de, no máximo, qualquer número de caracteres do início de uma cadeia de caracteres de uma posição especificada.

basic_string<CharType, Traits, Allocator> substr(
    size_type _Off = 0,
    size_type _Count = npos
) const;

Parâmetros

  • _Off
    Um índice que posiciona o elemento na posição do qual a cópia da cadeia de caracteres é feita, com um valor padrão de 0.

  • _Count
    O número de caracteres que devem ser copiados se estiverem presentes.

Valor de retorno

Um objeto de subcadeia de caracteres que é uma cópia dos elementos do início do operando da cadeia de caracteres na posição especificada pelo primeiro argumento.

Exemplo

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

int main( ) 
{
   using namespace std;

   string  str1 ("Heterological paradoxes are persistent.");
   cout << "The original string str1 is: \n " << str1
        << endl << endl;

   basic_string <char> str2 = str1.substr ( 6 , 7 );
   cout << "The substring str1 copied is: " << str2
        << endl << endl;
   
   basic_string <char> str3 = str1.substr (  );
   cout << "The default substring str3 is: \n " << str3
        <<  "\n which is the entire original string." << endl;
}
  

Requisitos

Cabeçalho: <cadeia de caracteres>

Namespace: std

Consulte também

Referência

Classe basic_string