Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::string — armazenar e modificar texto

std::string é uma sequência de elementos char, proprietária e de comprimento variável. Aprende a criar cadeias, acrescentar conteúdo, pesquisar e extrair subcadeias, bem como a diferença entre reserve e resize e as regras para utilizar data() em segurança.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <string>
std::string s;
std::string repeated(count, character);
s.reserve(capacity);
s.resize(count, character);
s += text;
s.push_back(character);
s.append(text);
s.assign(text);
auto position = s.find(text);
if (position != std::string::npos) {
    auto part = s.substr(position, count);
}

std::string de <string> é um alias de std::basic_string<char>; std::basic_string é o modelo para uma sequência proprietária com armazenamento contíguo. std::basic_string(count, character) constrói count cópias de character, por exemplo, std::string(3, '*'). std::basic_string::size() conta elementos char, não caracteres Unicode, e exclui o \0 final. std::basic_string::empty() (isto é, std::string::empty()) verifica se o tamanho é zero.

std::basic_string::reserve(n) garante uma capacidade de, pelo menos, n, mas não altera o tamanho nem cria elementos. std::basic_string::resize(n, c) encurta a cadeia ou acrescenta cópias de c; resize(n) acrescenta \0 ao aumentar o tamanho. std::basic_string::operator+= e std::basic_string::append acrescentam dados, std::basic_string::push_back acrescenta um elemento, e std::basic_string::assign substitui o conteúdo.

std::basic_string::find (isto é, std::string::find) devolve o índice da primeira correspondência na posição indicada ou depois dela, a partir de zero por omissão, ou std::basic_string::npos (std::string::npos). Guarda o resultado em auto e compara-o com npos antes de o utilizares como posição. std::basic_string::substr(pos, count) (isto é, std::string::substr) devolve uma cadeia separada com, no máximo, count elementos; o valor por omissão count = npos significa o resto da cadeia. Se pos > size(), lança std::out_of_range.

std::basic_string::data() expõe um buffer terminado em \0, mesmo quando a cadeia contém zeros internos. Num objeto que não seja const, podem modificar-se os elementos cujos índices sejam inferiores a size(); reservar armazenamento, por si só, não permite escrever para além deles. Não alteres o terminador para um valor diferente de \0. A realocação invalida os ponteiros; obtém-nos novamente após uma modificação, em vez de presumires que continuam válidos.

Âmbito da entrada: C++23; a opção do compilador do repositório não certifica o ambiente de execução de produção. A fonte é um projeto de norma em evolução, não um texto C++23 congelado; esta descrição limita-se às operações disponíveis em C++23.

Exemplos

#include <iostream>
#include <string>

int main() {
    std::string s(3, '*');
    s.reserve(32);
    s += "cat";
    s.push_back('!');
    s.append("?");
    s.resize(7);

    const auto position = s.find("cat");
    if (position != std::string::npos) {
        std::cout << s << '\n';
        std::cout << s.substr(position, 3) << '\n';
    }

    s.assign("ok");
    s.data()[0] = 'O';
    std::cout << s << ' ' << s.size() << ' '
              << std::boolalpha << s.empty() << '\n';
}

Resultado

***cat!
cat
Ok 2 false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes