mensagem_lite.h

Encerre toda a biblioteca de buffers de protocolo, excluindo todos os objetos de duração estática alocados pela biblioteca ou por arquivos .pb.cc gerados.

Existem dois motivos para chamá-lo:

• Use uma definição drástica de "vazamento de memória" em que você espera que cada malloc() tenha um free() correspondente, mesmo para objetos que estejam até a saída do programa.
• Você está criando uma biblioteca carregada dinamicamente que precisa ser limpa depois de descarregada.

É seguro chamar isso várias vezes. No entanto, não é seguro usar nenhuma outra parte da biblioteca de buffers de protocolo depois que ShutdownProtobufLibrary() é chamado. Além disso, essa chamada não é thread-safe, e o usuário precisa sincronizar várias chamadas.

Caminho rápido quando as condições são atendidas (por exemplo,

não determinísticos) uint8* _InternalSerialize(uint8* ptr) const;

Retorna a arena, se houver, que é a proprietária direta da mensagem e da memória interna dela. Arena::Own é diferente porque a arena não é a proprietária direta da memória interna.

Esse método é usado na implementação do proto para troca, migração e configuração alocada, para decidir se a propriedade dessa mensagem ou da memória interna dela pode ser alterada.

Crie uma nova instância do mesmo tipo.

A propriedade é transmitida ao autor da chamada.

Crie uma nova instância na arena.

A propriedade será transmitida ao autor da chamada se a arena for NULL. Implementação padrão para compatibilidade com versões anteriores.

Receba um ponteiro que seja igual ou não à arena desta mensagem.

Se o valor retornado por esse método for igual a algum ponteiro de arena, a mensagem estará nela. No entanto, se essa mensagem estiver em uma arena, esse método poderá ou não retornar o ponteiro dessa arena. Como compensação, esse método pode ser mais eficiente do que GetArena(). A intenção é permitir representações subjacentes que usam, por exemplo, ponteiros de tag, às vezes, para armazenar o ponteiro da arena diretamente e, às vezes, de forma mais indireta, além de permitir uma comparação de caminho rápido com o ponteiro da área quando for fácil de conseguir.

Limpe todos os campos da mensagem e os defina para os valores padrão.

Clear() evita a liberação de memória, supondo que qualquer memória alocada para reter partes da mensagem seja necessária novamente para conter a próxima mensagem. Se você realmente quiser liberar a memória usada por uma Mensagem, é preciso excluí-la.

Isso não é implementado para mensagens do Lite, apenas retorna "(não é possível determinar campos ausentes para mensagem do Lite)".

No entanto, ele é implementado para mensagens completas. Consulte message.h.

Se |other| é exatamente a mesma classe que isso, chama MergeFrom().

Caso contrário, os resultados serão indefinidos e provavelmente vão falhar.

Esses métodos retornam um resumo legível da mensagem.

Como a interface MessageLite não é compatível com reflexão, há poucas informações que esses métodos possam fornecer. Elas são ocultadas por métodos de mesmo nome na interface Message que fornecem muito mais informações. Os métodos usados aqui são principalmente para facilitar a reutilização de códigos em uma lógica que precisa interoperar com protótipos completos e leves.

O formato da string retornada está sujeito a mudanças. Portanto, não presuma que ela vai permanecer estável ao longo do tempo.

MessageLite::DebugString já é segura para Utf8.

Isso é feito para aumentar a compatibilidade com Message.

Preencher a mensagem com um buffer de protocolo analisado a partir do stream de entrada especificado.

Retorna "false" em um erro de leitura ou se a entrada está no formato errado. Uma devolução bem-sucedida não indica que toda a entrada é consumida. É necessário chamar ConsumedFullMessage() para verificar isso, se aplicável.

Lê um buffer de protocolo do stream de entrada especificado de zero cópia.

Se for bem-sucedida, toda a entrada será consumida.

Analisa um buffer de protocolo de um descritor de arquivo.

Se for bem-sucedida, toda a entrada será consumida.

Analisar um buffer de protocolo de um istream C++.

Se for bem-sucedida, toda a entrada será consumida.

Lê um buffer de protocolo do determinado stream de entrada sem cópia, esperando que a mensagem tenha exatamente bytes de tamanho.

Se for bem-sucedido, exatamente esta quantidade de bytes terá sido consumida a partir da entrada.

Analisa um buffer de protocolo contido em uma string.

Retorna verdadeiro em caso de sucesso. Essa função usa uma string no formato de fio binário (não legível) correspondente à saída de codificação por MessageLite::SerializeToString(). Se você quiser converter uma string legível em um objeto de buffer de protocolo, consulte google::protobuf::TextFormat::ParseFromString().

Lê um buffer de protocolo do stream e o mescla nesta Message.

Os campos singulares lidos do que já está em Message e os campos repetidos são anexados aos que já estão presentes.

É responsabilidade do autor da chamada chamar input->LastTagWas() (para grupos) ou input->ConsumedFullMessage() (para não grupos) depois disso para verificar se o final da mensagem foi delimitado corretamente.

ParseFromCodedStream() é implementado como Clear() seguido por MergeFromCodedStream().

Semelhante a MergeFromCodedStream(), mas bem-sucedido mesmo se os campos obrigatórios estiverem ausentes na entrada.

MergeFromCodedStream() é implementado como MergePartialFromCodedStream() seguido por IsInitialized().

Grave um buffer de protocolo dessa mensagem na saída fornecida.

Retorna falso em um erro de gravação. Se a mensagem não tiver os campos obrigatórios, talvez o GOOGLE_CHECK falhe.

Grave a mensagem no stream de saída de cópia zero.

Todos os campos obrigatórios precisam ser definidos.

Serializa a mensagem e a armazena na string fornecida.

Todos os campos obrigatórios precisam ser definidos.

Serializa a mensagem e a armazena na matriz de bytes especificada.

Todos os campos obrigatórios precisam ser definidos.

Crie uma string que codifique a mensagem.

É equivalente a chamar SerializeToString() em uma string e usá-la. Retorna a string vazia se SerializeToString() retornar um erro. Observação: se você pretende gerar muitas dessas strings, reduza a fragmentação de heap reutilizando o mesmo objeto de string com chamadas para SerializeToString().

Serializa a mensagem e a grava no descritor de arquivo fornecido.

Todos os campos obrigatórios precisam ser definidos.

Serializa a mensagem e a grava no ostream C++ fornecido.

Todos os campos obrigatórios precisam ser definidos.

Semelhante a SerializeToString(), mas anexa aos dados ao conteúdo existente da string.

Todos os campos obrigatórios precisam ser definidos.

Calcula o tamanho serializado da mensagem.

Isso chama ByteSizeLong() recursivamente em todas as mensagens incorporadas.

Em geral, ByteSizeLong() é linear no número de campos definidos para o protótipo.

Serializa a mensagem sem recalcular o tamanho.

A mensagem não pode ter sido alterada desde a última chamada para ByteSize(), e o valor retornado por ByteSize não pode ser negativo. Caso contrário, os resultados são indefinidos.

Como SerializeWithCachedSizes, mas grava diretamente em *destino, retornando um ponteiro para o byte imediatamente após o último byte gravado.

"target" precisa apontar para uma matriz de bytes de pelo menos ByteSize(). O uso de serialização determinística, por exemplo, mapas em ordem classificada, é determinado por CodedOutputStream::IsDefaultSerializationDeterministic().

Retorna o resultado da última chamada para ByteSize().

O tamanho de uma mensagem incorporada é necessário para serializá-la (porque as mensagens incorporadas são delimitadas por comprimento) e calcular o tamanho da mensagem externa. O armazenamento em cache do tamanho evita que isso seja feito várias vezes.

O ByteSize() não usa automaticamente o tamanho em cache quando disponível porque isso exigiria a validação toda vez que a mensagem fosse modificada, o que seria muito difícil e caro. Por exemplo, se uma submensagem profundamente aninhada for alterada, todos os tamanhos em cache dos pais precisarão ser invalidados, o que é muito trabalho para um método setter in-line.