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

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