CKTIS / C++
std::basic_string::size — contar os elementos de uma cadeia
`size()` conta os elementos armazenados, não os caracteres que o utilizador vê. Use-a para delimitar cópias, verificar índices e truncar campos.
Versão: ISO C++23; implementation support may vary
Sintaxe
#include <string>
// Member declaration inside std::basic_string<CharT, Traits, Allocator> (C++23):
constexpr size_type size() const noexcept;std::basic_string::size é uma função-membro const sem parâmetros, declarada em <string>. Devolve o número de elementos CharT como um valor do tipo sem sinal size_type. Executa-se em tempo constante O(1), não altera a cadeia, é noexcept e é constexpr desde C++20. length() devolve o mesmo valor; capacity() indica a capacidade de armazenamento, não o comprimento do conteúdo.
Os zeros internos contam, mas o terminador nulo final não. Em std::string contam-se elementos char, ou seja, bytes no sentido de C++; num std::u8string com texto UTF-8 contam-se unidades de código char8_t. O resultado não conta pontos de código Unicode nem caracteres percecionados pelo utilizador. Truncar pelo número de elementos pode cortar uma sequência UTF-8 a meio.
Para uma cópia exata, passe s.data() e s.size() a uma interface que aceite o número de elementos; uma interface que procure o terminador para no primeiro zero. Se o buffer de destino for medido em bytes, verifique o seu tamanho em bytes: o conteúdo ocupa s.size() * sizeof(CharT) bytes, sem o terminador. Não use um ponteiro obtido de data() depois de a cadeia ser destruída ou de uma operação invalidar o ponteiro.
Antes de ler um elemento com s[i], verifique i < s.size(); a posição s.size() contém o terminador, não um elemento do conteúdo. at(i) lança std::out_of_range se i >= s.size(). Para conservar, no máximo, os últimos quatro elementos, use s.substr(n - 4) apenas se n = s.size() for superior a 4; caso contrário, conserve a cadeia inteira. Assim evita que a subtração sem sinal dê a volta ao intervalo do tipo. Se um separador for obrigatório, compare o resultado de find() com npos antes de calcular o início do campo seguinte.
Exemplos
#include <iostream>
#include <string>
int main() {
const std::string record("ID\0:123456", 10);
const std::string copy(record.data(), record.size());
const auto separator = copy.find(':');
if (separator == std::string::npos) {
return 1;
}
const auto field = copy.substr(separator + 1);
constexpr std::string::size_type width = 4;
const auto n = field.size();
const auto tail = n > width ? field.substr(n - width) : field;
const std::u8string utf8 = u8"\u00E9";
std::cout << static_cast<unsigned int>(record.size()) << '\n'
<< (copy[2] == '\0') << '\n'
<< tail << '\n'
<< static_cast<unsigned int>(utf8.size()) << '\n';
}Resultado
10 1 3456 2
`10` inclui o zero interno e `1` confirma que este se manteve na cópia. `3456` são os últimos quatro elementos do campo e `2` é o número de unidades de código UTF-8 para U+00E9.
Lições relacionadas
- C++ · Lição 49 · Avançado · Versão: 3
- C++ · Lição 53 · Avançado · Versão: 3
- C++ · Lição 58 · Avançado · Versão: 3
Fontes
- C++ working draft — Capacity [string.capacity]
- C++ working draft — Class template basic_string, general [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Element access [string.access]
- C++ working draft — Accessors [string.accessors]
- C++ working draft — basic_string::substr [string.substr]
- C++ working draft — Searching [string.find]
- C++ working draft — String view searching [string.view.find]
- C++ working draft — String literals [lex.string]
- cppreference — std::basic_string::size and std::basic_string::length