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
- Working Draft — Programming Languages — C++
- [string.classes] String classes
- [basic.string] Class template basic_string
- [string.cons] Constructors and assignment operators
- [string.capacity] Capacity
- [string.modifiers] Modifiers
- [string.accessors] Accessors
- [string.find] Searching
- [string.substr] basic_string::substr