CKTIS / C++
std::basic_string::substr — subcadeia com dados próprios
Extrai um trecho para uma nova cadeia com dados próprios. Aprende como a contagem é limitada, quando a posição lança uma exceção e o que muda com a sobrecarga para rvalues em C++23.
Versão: ISO C++23; implementation support may vary
Sintaxe
// ISO C++23 — member declarations in std::basic_string (<string>)
constexpr basic_string substr(size_type pos = 0, size_type count = npos) const &;
constexpr basic_string substr(size_type pos = 0, size_type count = npos) &&;std::basic_string::substr é uma função membro declarada em <string>. s.substr(pos, count) devolve uma nova cadeia do mesmo tipo, que possui os seus próprios dados. pos é o índice inicial, contado a partir de zero; count é um número de elementos, não o índice do fim. Por omissão, pos vale 0 e count vale npos, ou seja, «até ao fim».
Se pos <= s.size(), o resultado contém std::min(count, s.size() - pos) elementos. Um count demasiado grande é limitado ao número de elementos disponíveis. pos == s.size() ou count == 0 com um pos válido produz uma cadeia vazia. pos > s.size() lança std::out_of_range mesmo quando count == 0. Valida as entradas negativas antes de as converter para o tipo sem sinal size_type e verifica o comprimento antes de calcular s.size() - 4, para evitar que a subtração sem sinal dê a volta abaixo de zero.
Antes de C++23 havia uma única sobrecarga const, que era constexpr desde C++20. Em C++23 ambas as sobrecargas são constexpr; o suporte da biblioteca pode variar. const & copia o intervalo sem alterar a origem. && é selecionada para um rvalue não constante, como std::move(s), e pode reutilizar a memória da origem, mas não há garantia de que evite uma alocação. Após uma chamada bem-sucedida, a origem continua válida, num estado não especificado. Ambas as sobrecargas constroem por omissão o alocador do resultado, em vez de copiar s.get_allocator(). Se for lançada uma exceção, a origem não é alterada.
As posições e os comprimentos contam elementos CharT: bytes em std::string e unidades de código UTF-8 do tipo char8_t em std::u8string. Um corte em UTF-8 pode separar as unidades de um ponto de código. substr preserva os elementos nulos internos; para copiar exatamente todo o intervalo, passa s.data() e s.size() ao construtor da cadeia, não apenas o ponteiro. Já o resultado de std::basic_string_view::substr não possui os dados; usa-o apenas enquanto a memória subjacente se mantiver válida.
Para letras e algarismos do conjunto de caracteres básico, s.substr(0, 3) obtém até três letras se estas estiverem no início, e s.substr(3) obtém o resto se s.size() >= 3. substr extrai um intervalo, não filtra. Se a cadeia já só contiver algarismos, usa digits.substr(digits.size() - 4) quando tiver pelo menos quatro elementos; caso contrário, acrescenta à esquerda os zeros de std::string(4 - digits.size(), '0').
Exemplos
#include <iostream>
#include <stdexcept>
#include <string>
std::string last_four(const std::string& digits) {
if (digits.size() < 4) {
return std::string(4 - digits.size(), '0') + digits;
}
return digits.substr(digits.size() - 4);
}
int main() {
const std::string label = "ABC12345";
std::cout << label.substr(0, 3) << '\n';
std::cout << label.substr(3, 99) << '\n';
std::cout << last_four(label.substr(3)) << '\n';
std::cout << last_four("7") << '\n';
std::cout << '[' << label.substr(label.size()) << "]\n";
try {
(void)label.substr(label.size() + 1, 0);
} catch (const std::out_of_range&) {
std::cout << "out_of_range\n";
}
}Resultado
ABC 12345 2345 0007 [] out_of_range
O exemplo mostra um prefixo, a limitação da contagem, como manter os últimos quatro algarismos ou preencher com zeros à esquerda e a diferença entre começar no fim e começar depois do fim.
Lições relacionadas
- C++ · Lição 49 · Avançado · Versão: 3
- C++ · Lição 53 · Avançado · Versão: 3