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

CKTIS / C++

std::string::empty — cadeia vazia e posição do separador

`std::string::empty` verifica se uma cadeia tem comprimento zero. Ao juntar argumentos, não indica se a primeira posição já foi processada.

Versão: ISO C++23; implementation support may vary

Sintaxe

constexpr bool empty() const noexcept;

// Call on a std::string object s declared using <string>:
s.empty()

std::string::empty é uma função-membro sem parâmetros de std::string, o alias de std::basic_string<char> disponibilizado pelo cabeçalho <string>. A chamada s.empty() devolve um bool: true se s.size() == 0 e false caso contrário. Um único espaço ou um \0 guardado como elemento da cadeia conta para o comprimento. A função não verifica a capacidade.

O teste demora tempo constante, não modifica a cadeia e pode ser invocado num objeto const. A função é noexcept desde C++11 e constexpr desde C++20, pelo que em C++23 pode ser usada numa avaliação constante se a expressão inteira cumprir os respetivos requisitos. Em s.empty() ? "" : "|", o operador condicional ?: usa o resultado da chamada para escolher uma de duas expressões. empty() limita-se a devolver um bool.

Para preservar todas as posições ao juntar argumentos, insere um separador antes de cada argumento, exceto o primeiro, mesmo que os anteriores estejam vazios. Depois de acrescentar um primeiro argumento vazio, o resultado continua a ter comprimento zero, pelo que o teste com empty() omite indevidamente o separador antes do segundo argumento. Com um índice que começa em zero, i != 0 testa a posição, não o conteúdo do resultado.

Exemplos

#include <array>
#include <cstddef>
#include <iostream>
#include <string>

int main() {
    const std::array<std::string, 3> fields{"", "beta", "gamma"};
    std::string by_content;
    std::string by_position;

    for (std::size_t i = 0; i < fields.size(); ++i) {
        by_content += (by_content.empty() ? "" : "|");
        by_content += fields[i];

        if (i != 0) {
            by_position += '|';
        }
        by_position += fields[i];
    }

    std::cout << "content: " << by_content << '\n'
              << "position: " << by_position << '\n';
}

Resultado

content: beta|gamma
position: |beta|gamma

O primeiro argumento está vazio. A primeira linha omite o separador antes de `beta`; a segunda mantém-no para marcar a primeira posição vazia.

Lições relacionadas

  • C++ · Lição 4 · Avançado · Versão: 3

Fontes