campo_repetido.h

Semelhante a AggregatedRepeatedPtrFieldBackInserter, usando UnsafeArenaAdd passará d em vez de AddAloced.

Isso é um pouco mais rápido se for importante. Ele também é útil em códigos legados que usam propriedade temporária para evitar cópias. Exemplo:

RepeatedPtrField<T> temp_field;
temp_field.AddAllocated(new T);
... // Do something with temp_field
temp_field.ExtractSubrange(0, temp_field.size(), nullptr);

Se você colocar temp_field na arena, isso falhará, porque a propriedade será transferida para a arena na chamada "AddDistributed" e não será mais liberada, causando uma exclusão dupla. Isso vai impedir isso.

Anexa um novo elemento e retorna um ponteiro para ele.

O novo elemento não vai ser inicializado se |Element| for um tipo de POD.

Extrair elementos com índices em "[[]start .. start+num-1]".

Copie-os em "elementos[[]0 .. num-1]" se "elementos" não for NULL. Cuidado: a implementação também move elementos com índices [[]start+num ..]. Chamar essa rotina em um loop pode causar um comportamento quadrático.

Reserve espaço para expandir o campo até o tamanho especificado.

Evite incluir in-line de Reserve(): os elementos novos, copiar e excluir[[]] geram uma quantidade significativa de código excessivo.

Se a matriz for aumentada, sempre terá o dobro do tamanho.

Anexa um novo elemento e retorna um ponteiro para ele.

O novo elemento não vai ser inicializado se |Element| for um tipo de POD. Só vai ser chamado se capacity() > Size().

Como o redimensionamento do STL.

Usa valor para preencher elementos anexados. Como Truncate() se new_size <= size(), caso contrário, é O(new_size - size()).

Recebe a matriz subjacente.

Esse ponteiro pode ser invalidado por qualquer operação de adição ou remoção.

Troque todo o conteúdo por "outro".

Se elas forem arenas separadas, copia os dados entre elas.

Troque todo o conteúdo por "outro".

Só vai ser chamado se o autor da chamada puder garantir que os dois campos repetidos estejam na mesma arena ou no heap. A troca entre arenas diferentes não é permitida e detectada por uma GOOGLE_DCHECK (consulte detalhes na API de documentos).

Remove o elemento referenciado pela posição.

Retorna um iterador para o elemento imediatamente após o elemento removido.

Invalida todos os iteradores no ou após o elemento removido, incluindo end().

Remove os elementos no intervalo [[]first, last).

Retorna um iterador para o elemento imediatamente após o intervalo removido.

Invalida todos os iteradores em ou após o intervalo removido, incluindo end().

Apenas para uso interno.

Isso é público, porque é chamado pelo código gerado.

Remova o último elemento da matriz.

A propriedade do elemento é retida pela matriz.

Exclua elementos com índices no intervalo [[]start .

. start+num-1] Cuidado: a implementação move todos os elementos com índices [[]start+num .. ]. Chamar essa rotina em um loop pode causar um comportamento quadrático.

Reserve espaço para expandir o campo até o tamanho especificado.

Isso apenas redimensiona a matriz de ponteiro; não aloca nenhum objeto. Se a matriz for aumentada, sempre terá o dobro do tamanho.

Recebe a matriz subjacente.

Esse ponteiro pode ser invalidado por qualquer operação de adição ou remoção.

Troque todo o conteúdo por "outro".

Se eles estiverem em arenas separadas, os dados serão copiados.

Troque todo o conteúdo por "outro".

O autor da chamada precisa garantir que ambos os campos estejam na mesma arena ou ambos estejam no heap. A troca entre arenas diferentes com essa função não é permitida e é detectada por GOOGLE_DCHECK.

Adicione um objeto já alocado e transmita a propriedade para o RepeatedPtrField.

Observe que alguns comportamentos especiais ocorrem em relação às arenas:

(i) if this field holds submessages, the new submessage will be copied if
the original is in an arena and this RepeatedPtrField is either in a
different arena, or on the heap.
(ii) if this field holds strings, the passed-in string *must* be
heap-allocated, not arena-allocated. There is no way to dynamically check
this at runtime, so User Beware.

Remova o último elemento e o retorne, transmitindo a propriedade ao autor da chamada.

Requer: size() > 0

Se este RepeatedPtrField estiver em uma arena, será necessário copiar um objeto para transmitir a propriedade de volta ao usuário (para semântica compatível). Use UnsafeArenaReleaseLast() se esse comportamento não for adequado.

Adicione um objeto já alocado e pule as verificações de propriedade de arena.

O usuário precisa garantir que o objeto especificado esteja na mesma arena que esse RepeatedPtrField. Ele também é útil em códigos legados que usam propriedade temporária para evitar cópias. Exemplo:

RepeatedPtrField<T> temp_field;
temp_field.AddAllocated(new T);
... // Do something with temp_field
temp_field.ExtractSubrange(0, temp_field.size(), nullptr);

Se você colocar temp_field na arena, isso falhará, porque a propriedade será transferida para a arena na chamada "AddDistributed" e não será mais liberada, causando uma exclusão dupla. UnsafeArenaAddAlemão impede isso.

Remova e retorne o último elemento.

Só funciona em uma arena. O ponteiro retornado é para o objeto original na arena, portanto, tem o ciclo de vida da arena. Requer: current_size_ > 0

Extraia elementos com índices no intervalo "[[]start .. start+num-1]".

O autor da chamada assume a propriedade dos elementos extraídos e é responsável por excluí-los quando não são mais necessários. Se "elementos" não for NULL, os ponteiros para os elementos extraídos serão armazenados em "elementos[[]0 .. num-1]" para facilitar o autor da chamada. Se "elementos" for NULL, o autor da chamada precisará usar algum outro mecanismo para executar outras operações (como exclusão) nesses elementos. Cuidado: a implementação também move elementos com índices [[]start+num ..]. Chamar essa rotina em um loop pode causar um comportamento quadrático.

O comportamento da cópia de memória é idêntico ao ReleaseLast() descrito acima: se esse RepeatedPtrField estiver em uma arena, uma cópia de objeto será realizada para cada elemento retornado, de modo que todos os ponteiros de elemento retornados sejam cópias alocadas em heap. Se essa cópia não for desejada, o usuário precisará chamar UnsafeArenaExtractSubrange().

Idêntico a ExtractSubrange() descrito acima, exceto que, quando este campo repetido está em uma arena, nenhuma cópia de objeto é realizada.

Em vez disso, os ponteiros de objeto bruto são retornados. Assim, se estiver em uma arena, os objetos retornados não poderão ser liberados, porque não serão objetos alocados por heap.

Adicione um elemento ao pool de objetos limpos, transmitindo a propriedade para o RepeatedPtrField.

O elemento precisa ser apagado antes de chamar esse método.

Este método não pode ser chamado quando o campo repetido está em uma arena ou quando |value| está; os dois casos acionarão uma falha GOOGLE_DCHECK.

Remova um único elemento do pool limpo e retorne-o, transmitindo a propriedade ao autor da chamada.

O elemento vai ser apagado. Requer: ClearedCount() > 0

Esse método não pode ser chamado quando o campo repetido está em uma arena. Isso acionará uma falha GOOGLE_DCHECK.

Remove o elemento referenciado pela posição.

Retorna um iterador para o elemento imediatamente após o elemento removido.

Invalida todos os iteradores no ou após o elemento removido, incluindo end().

Remove os elementos no intervalo [[]first, last).

Retorna um iterador para o elemento imediatamente após o intervalo removido.

Invalida todos os iteradores em ou após o intervalo removido, incluindo end().

Apenas para uso interno.

Isso é público, porque é chamado pelo código gerado.