`<string>` funções

O <string> cabeçalho fornece as seguintes funções:

`getline`

Extraia cadeias de caracteres do fluxo de entrada linha por linha.

// (1) delimiter as parameter
template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
    basic_istream<CharType, Traits>& in_stream,
    basic_string<CharType, Traits, Allocator>& str,
    CharType delimiter);

template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
    basic_istream<CharType, Traits>&& in_stream,
    basic_string<CharType, Traits, Allocator>& str,
    const CharType delimiter);

// (2) default delimiter used
template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
    basic_istream<CharType, Traits>& in_stream,
    basic_string<CharType, Traits, Allocator>& str);

template <class Allocator, class Traits, class Allocator>
basic_istream<Allocator, Traits>& getline(
    basic_istream<Allocator, Traits>&& in_stream,
    basic_string<Allocator, Traits, Allocator>& str);

Parâmetros

in_stream
O fluxo de entrada do qual uma cadeia de caracteres deve ser extraída.

str
A cadeia de caracteres na qual são lidos os caracteres do fluxo de entrada.

delimiter
O delimitador de linha.

Valor de retorno

O fluxo in_streamde entrada .

Observações

O par de assinaturas de função marcadas (1) extrai caracteres de in_stream até delimiter ser encontrado, armazenando-os em str.

O par de assinaturas de função marcadas (2) usam newline como o delimitador de linha padrão e se comportam como getline(in_stream, str, in_stream. widen('\n')).

A segunda função de cada par é análoga à primeira para suportar rvalue referências.

A extração para quando ocorre uma das seguintes situações:

No final do arquivo, caso em que a bandeira interna do estado de in_stream é definida como ios_base::eofbit.
Depois que a função extrai um elemento que compara igual a delimiter. O elemento não é colocado de volta ou anexado à sequência controlada.
Depois que a função extrai str.max_size elementos. A bandeira interna do estado de in_stream está definida como ios_base::failbit.
Algum outro erro além dos listados anteriormente; A bandeira interna do Estado de in_stream está definida como ios_base::badbit.

Para obter informações sobre sinalizadores de estado internos, consulte ios_base::iostate.

Se a função não extrair nenhum elemento, o sinalizador de estado interno de in_stream será definido como ios_base::failbit. Em qualquer caso, getline devoluções in_stream.

Se uma exceção for lançada, in_stream e str forem deixados em um estado válido.

Exemplo

O código a seguir demonstra getline() em dois modos: primeiro com o delimitador padrão (newline) e segundo com um espaço em branco como delimitador. O caractere de fim de arquivo (CTRL-Z no teclado) é usado para controlar a terminação dos loops while. Esse valor define o sinalizador de estado interno de cin como eofbit, que deve ser limpo antes basic_ios::clear() que o segundo loop funcione corretamente.

// compile with: /EHsc /W4
#include <string>
#include <iostream>
#include <vector>

using namespace std;

int main()
{
    string str;
    vector<string> v1;
    cout << "Enter a sentence, press ENTER between sentences. (Ctrl-Z to stop): " << endl;
    // Loop until end-of-file (Ctrl-Z) is input, store each sentence in a vector.
    // Default delimiter is the newline character.
    while (getline(cin, str)) {
        v1.push_back(str);
    }

    cout << "The following input was stored with newline delimiter:" << endl;
    for (const auto& p : v1) {
        cout << p << endl;
    }

    cin.clear();

    vector<string> v2;
    // Now try it with a whitespace delimiter
    while (getline(cin, str, ' ')) {
        v2.push_back(str);
    }

    cout << "The following input was stored with whitespace as delimiter:" << endl;
    for (const auto& p : v2) {
        cout << p << endl;
    }
}

`stod`

Converte uma sequência de caracteres em um doublearquivo .

double stod(
    const string& str,
    size_t* idx = 0);

double stod(
    const wstring& str,
    size_t* idx = 0);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

Valor de retorno

O valor double.

Observações

A função converte a sequência de elementos em str um valor de tipo double como se chamasse strtod( str.c_str(), _Eptr), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazena *_Eptr - str.c_str()*idx e retorna o valor.

`stof`

Converte uma sequência de caracteres em um flutuador.

float stof(
    const string& str,
    size_t* idx = 0);

float stof(
    const wstring& str,
    size_t* idx = 0);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

Valor de retorno

O valor float.

Observações

A função converte a sequência de elementos em str um valor de tipo float como se chamasse strtof( str.c_str(), _Eptr), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazena *_Eptr - str.c_str()*idx e retorna o valor.

`stoi`

Converte uma sequência de caracteres em um inteiro.

int stoi(
    const string& str,
    size_t* idx = 0,
    int base = 10);

int stoi(
    const wstring& str,
    size_t* idx = 0,
    int base = 10);

Valor de retorno

O valor inteiro.

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

base
A base numérica a ser usada.

Observações

A função stoi converte a sequência de caracteres em str em um valor de tipo int e retorna o valor. Por exemplo, quando passada uma sequência de caracteres "10", o valor retornado por stoi é o inteiro 10.

stoi comporta-se de forma semelhante à função strtol para caracteres de byte único quando é chamada da maneira strtol( str.c_str(), _Eptr, idx), onde _Eptr é um objeto interno à função, ou wcstol para caracteres largos, quando é chamada de maneira semelhante, wcstol(Str.c_str(), _Eptr, idx). Para obter mais informações, consulte strtol, wcstol, , _strtol_l_wcstol_l.

Se str.c_str() == *_Eptr, stoi lança um objeto do tipo invalid_argument. Se essa chamada definir errno, ou se o valor retornado não puder ser representado como um objeto do tipo int, ele lançará um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função será armazenada *_Eptr - str.c_str() em *idx.

`stol`

Converte uma sequência de caracteres em um longarquivo .

long stol(
    const string& str,
    size_t* idx = 0,
    int base = 10);

long stol(
    const wstring& str,
    size_t* idx = 0,
    int base = 10);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

base
A base numérica a ser usada.

Valor de retorno

O valor inteiro longo.

Observações

A função converte a sequência de elementos em str para um valor do tipo long como se chamasse strtol( str.c_str(), _Eptr, idx), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazena *_Eptr - str.c_str()*idx e retorna o valor.

`stold`

Converte uma sequência de caracteres em um long doublearquivo .

double stold(
    const string& str,
    size_t* idx = 0);

double stold(
    const wstring& str,
    size_t* idx = 0);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

Valor de retorno

O valor long double.

Observações

A função converte a sequência de elementos em str para um valor do tipo long double como se chamasse strtold( str.c_str(), _Eptr), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazena *_Eptr - str.c_str()*idx e retorna o valor.

`stoll`

Converte uma sequência de caracteres em um long longarquivo .

long long stoll(
    const string& str,
    size_t* idx = 0,
    int base = 10);

long long stoll(
    const wstring& str,
    size_t* idx = 0,
    int base = 10);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

base
A base numérica a ser usada.

Valor de retorno

O valor long long.

Observações

A função converte a sequência de elementos em str para um valor do tipo long long como se chamasse strtoll( str.c_str(), _Eptr, idx), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazenará *_Eptr - str.c_str()*idx e retornará o valor.

`stoul`

Converte uma sequência de caracteres em um longo não assinado.

unsigned long stoul(
    const string& str,
    size_t* idx = 0,
    int base = 10);

unsigned long stoul(
    const wstring& str,
    size_t* idx = 0,
    int base = 10);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

base
A base numérica a ser usada.

Valor de retorno

O valor inteiro longo não assinado.

Observações

A função converte a sequência de elementos em str para um valor do tipo unsigned long como se chamasse strtoul( str.c_str(), _Eptr, idx), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazenará *_Eptr - str.c_str()*idx e retornará o valor.

`stoull`

Converte uma sequência de caracteres em um unsigned long longarquivo .

unsigned long long stoull(
    const string& str,
    size_t* idx = 0,
    int base = 10);

unsigned long long stoull(
    const wstring& str,
    size_t* idx = 0,
    int base = 10);

Parâmetros

str
A sequência de caracteres a ser convertida.

idx
O valor de índice do primeiro caractere não convertido.

base
A base numérica a ser usada.

Valor de retorno

O valor unsigned long long.

Observações

A função converte a sequência de elementos em str para um valor do tipo unsigned long long como se chamasse strtoull( str.c_str(), _Eptr, idx), onde _Eptr é um objeto interno à função. Se str.c_str() == *_Eptr, ele lança um objeto do tipo invalid_argument. Se tal chamada definir errno, ele lança um objeto do tipo out_of_range. Caso contrário, se idx não for um ponteiro nulo, a função armazena *_Eptr - str.c_str()*idx e retorna o valor.

`swap`

Troca as matrizes de caracteres de duas cadeias de caracteres.

template <class Traits, class Allocator>
void swap(basic_string<CharType, Traits, Allocator>& left, basic_string<CharType, Traits, Allocator>& right);

Parâmetros

left
Uma cadeia de caracteres cujos elementos devem ser trocados com os elementos de outra cadeia de caracteres.

right
A outra cadeia de caracteres cujos elementos devem ser trocados com a primeira cadeia de caracteres.

Observações

A função template executa a função left.swapde membro especializada (right) para strings, o que garante complexidade constante.

Exemplo

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

int main( )
{
   using namespace std;
   // Declaring an object of type basic_string<char>
   string s1 ( "Tweedledee" );
   string s2 ( "Tweedledum" );
   cout << "Before swapping string s1 and s2:" << endl;
   cout << "The basic_string s1 = " << s1 << "." << endl;
   cout << "The basic_string s2 = " << s2 << "." << endl;

   swap ( s1 , s2 );
   cout << "\nAfter swapping string s1 and s2:" << endl;
   cout << "The basic_string s1 = " << s1 << "." << endl;
   cout << "The basic_string s2 = " << s2 << "." << endl;
}

Before swapping string s1 and s2:
The basic_string s1 = Tweedledee.
The basic_string s2 = Tweedledum.

After swapping string s1 and s2:
The basic_string s1 = Tweedledum.
The basic_string s2 = Tweedledee.

`to_string`

Converte um valor em um stringarquivo .

string to_string(int value);
string to_string(unsigned int value);
string to_string(long value);
string to_string(unsigned long value);
string to_string(long long value);
string to_string(unsigned long long value);
string to_string(float value);
string to_string(double value);
string to_string(long double value);

Parâmetros

value
O valor a ser convertido.

Valor de retorno

O string que representa o valor.

Observações

A função converte o valor em uma sequência de elementos armazenados em um objeto Buf de matriz interno à função como se chamasse sprintf(Buf, Fmt, value), onde Fmt está

"%d" se value for do tipo int
"%u" se value for do tipo unsigned int
"%ld" se value for do tipo long
"%lu" se value for do tipo unsigned long
"%lld" se value for do tipo long long
"%llu" se value for do tipo unsigned long long
"%f" se value for do tipo float ou double
"%Lf" se value for do tipo long double

A função retorna string(Buf).

`to_wstring`

Converte um valor em uma cadeia de caracteres ampla.

wstring to_wstring(int value);
wstring to_wstring(unsigned int value);
wstring to_wstring(long value);
wstring to_wstring(unsigned long value);
wstring to_wstring(long long value);
wstring to_wstring(unsigned long long value);
wstring to_wstring(float value);
wstring to_wstring(double value);
wstring to_wstring(long double value);

Parâmetros

value
O valor a ser convertido.

Valor de retorno

A cadeia de caracteres larga que representa o valor.

Observações

A função converte value em uma sequência de elementos armazenados em um objeto Buf de matriz interna à função como se chamasse swprintf(Buf, Len, Fmt, value), onde Fmt está

L"%d" se value for do tipo int
L"%u" se value for do tipo unsigned int
L"%ld" se value for do tipo long
L"%lu" se value for do tipo unsigned long
L"%lld" se value for do tipo long long
L"%llu" se value for do tipo unsigned long long
L"%f" se value for do tipo float ou double
L"%Lf" se value for do tipo long double

A função retorna wstring(Buf).

Ver também

<string>

Feedback

Esta página foi útil?

Last updated on 2025-11-07

Partilhar via

<string> funções

getline

Parâmetros

Valor de retorno

Observações

Exemplo

stod

Parâmetros

Valor de retorno

Observações

stof

Parâmetros

Valor de retorno

Observações

stoi

Valor de retorno

Parâmetros

Observações

stol

Parâmetros

Valor de retorno

Observações

stold

Parâmetros

Valor de retorno

Observações

stoll

Parâmetros

Valor de retorno

Observações

stoul

Parâmetros

Valor de retorno

Observações

stoull

Parâmetros

Valor de retorno

Observações

swap

Parâmetros

Observações

Exemplo

to_string

Parâmetros

Valor de retorno

Observações

to_wstring

Parâmetros

Valor de retorno

Observações

Ver também

Feedback

Recursos adicionais

`<string>` funções

`getline`

`stod`

`stof`

`stoi`

`stol`

`stold`

`stoll`

`stoul`

`stoull`

`swap`

`to_string`

`to_wstring`