nl::Weave::TLV::Utilities

Esse namespace inclui tipos e interfaces utilitárias para gerenciar e trabalhar com o TLV do Weave.

Resumo

Typedefs

IterateHandler)(const TLVReader &aReader, size_t aDepth, void *aContext) typedef

remotas

Count(const TLVReader & aReader, size_t & aCount)
Conta o número de elementos TLV no leitor de TLV especificado, em ordem decrescente em matrizes ou estruturas.
Count(const TLVReader & aReader, size_t & aCount, const bool aRecurse)
Contar o número de elementos TLV no leitor de TLV especificado, opcionalmente de modo a decrescente em matrizes ou estruturas.
CountHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Incrementar o contador ao iterar os dados TLV.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult)
Pesquise a tag especificada no leitor de TLV fornecido.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult, const bool aRecurse)
Pesquisar a tag especificada no leitor de TLV fornecido, opcionalmente decrescente em matrizes ou estruturas.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult)
Pesquisar o primeiro elemento que corresponda ao predicado no leitor TLV, descendente em matrizes ou estruturas.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult, const bool aRecurse)
Pesquisar o primeiro elemento que corresponda ao predicado no leitor TLV, opcionalmente descida em matrizes ou estruturas.
FindHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Pesquise a tag especificada no leitor de TLV fornecido.
FindPredicateHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Iterate(TLVReader & aReader, size_t aDepth, IterateHandler aHandler, void *aContext, bool aRecurse)
Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext)
Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext, const bool aRecurse)
Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.

Estruturas

nl::Weave::TLV::Utilities::FindContext
nl::Weave::TLV::Utilities::FindPredicateContext

Typedefs

IterateHandler

WEAVE_ERROR(* IterateHandler)(const TLVReader &aReader, size_t aDepth, void *aContext)

remotas

Count

WEAVE_ERROR Count(
  const TLVReader & aReader,
  size_t & aCount
)

Conta o número de elementos TLV no leitor de TLV especificado, em ordem decrescente em matrizes ou estruturas.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor de TLV para contar o número de elementos TLV.
[in,out] aCount
Uma referência ao armazenamento para a contagem retornada. É inicializado como zero (0) antes da contagem e definido como o número de elementos contados como sucesso.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.

Count

WEAVE_ERROR Count(
  const TLVReader & aReader,
  size_t & aCount,
  const bool aRecurse
)

Contar o número de elementos TLV no leitor de TLV especificado, opcionalmente de modo a decrescente em matrizes ou estruturas.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor de TLV para contar o número de elementos TLV.
[in,out] aCount
Uma referência ao armazenamento para a contagem retornada. É inicializado como zero (0) antes da contagem e definido como o número de elementos contados como sucesso.
[in] aRecurse
Um booleano que indica se (verdadeiro) ou não (falso) alguma matriz ou estrutura encontrada precisa ser descendente.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.

CountHandler

WEAVE_ERROR CountHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

Incrementar o contador ao iterar os dados TLV.

Detalhes
Parâmetros
[in] aReader
Uma referência ao leitor de TLV contendo os dados de TLV para contar o número de elementos TLV.
[in] aDepth
A profundidade atual nos dados TLV.
[in,out] aContext
Um ponteiro para o contexto específico do gerenciador, que é um ponteiro para o armazenamento do valor de contagem.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_INVALID_ARGUMENT
Se aContext for NULL.

Localizar

WEAVE_ERROR Find(
  const TLVReader & aReader,
  const uint64_t & aTag,
  TLVReader & aResult
)

Pesquise a tag especificada no leitor de TLV fornecido.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor TLV em que é possível encontrar a tag especificada.
[in] aTag
Uma referência somente leitura à tag TLV a ser encontrada.
[out] aResult
Uma referência ao armazenamento para um leitor de TLV que será posicionado na tag especificada em caso de êxito.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Se a tag aTag especificada não for encontrada.

Localizar

WEAVE_ERROR Find(
  const TLVReader & aReader,
  const uint64_t & aTag,
  TLVReader & aResult,
  const bool aRecurse
)

Pesquisar a tag especificada no leitor de TLV fornecido, opcionalmente decrescente em matrizes ou estruturas.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor TLV em que é possível encontrar a tag especificada.
[in] aTag
Uma referência somente leitura à tag TLV a ser encontrada.
[out] aResult
Uma referência ao armazenamento para um leitor de TLV que será posicionado na tag especificada em caso de êxito.
[in] aRecurse
Um booleano que indica se (verdadeiro) ou não (falso) alguma matriz ou estrutura encontrada precisa ser descendente.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Se a tag aTag especificada não for encontrada.

Localizar

WEAVE_ERROR Find(
  const TLVReader & aReader,
  IterateHandler aPredicate,
  void *aContext,
  TLVReader & aResult
)

Pesquisar o primeiro elemento que corresponda ao predicado no leitor TLV, descendente em matrizes ou estruturas.

O aPredicate é aplicado a cada elemento TLV visitado. O aPredicate deve retornar WEAVE_ERROR_MAX para os elementos correspondentes, WEAVE_NO_ERROR para elementos não correspondentes e qualquer outro valor para encerrar a pesquisa.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor TLV em que é possível encontrar o elemento que corresponde ao predicado.
[in] aPredicate
Um predicado a ser aplicado a cada elemento TLV. Para oferecer suporte à reutilização do código, o aPredicate tem o tipo IterateHandler. O valor de retorno de aPredicate controla a pesquisa: um WEAVE_ERROR_MAX indica que o elemento desejado foi encontrado, WEAVE_NO_ERROR indica que o elemento desejado não foi encontrado e todos os outros valores indicam que o arquivo deve ser encerrado.
[in] aContext
Um ponteiro opcional para os dados de contexto fornecidos pelo autor da chamada.
[out] aResult
Uma referência ao armazenamento para um leitor de TLV que será posicionado na tag especificada em caso de êxito.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Se o aPredicate especificado não localizou o elemento especificado

Localizar

WEAVE_ERROR Find(
  const TLVReader & aReader,
  IterateHandler aPredicate,
  void *aContext,
  TLVReader & aResult,
  const bool aRecurse
)

Pesquisar o primeiro elemento que corresponda ao predicado no leitor TLV, opcionalmente descida em matrizes ou estruturas.

O aPredicate é aplicado a cada elemento TLV visitado. O aPredicate deve retornar WEAVE_ERROR_MAX para os elementos correspondentes, WEAVE_NO_ERROR para elementos não correspondentes e qualquer outro valor para encerrar a pesquisa.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor TLV em que é possível encontrar o elemento que corresponde ao predicado.
[in] aPredicate
Um predicado a ser aplicado a cada elemento TLV. Para oferecer suporte à reutilização do código, o aPredicate tem o tipo IterateHandler. O valor de retorno de aPredicate controla a pesquisa: um WEAVE_ERROR_MAX indica que o elemento desejado foi encontrado, WEAVE_NO_ERROR indica que o elemento desejado não foi encontrado e todos os outros valores indicam que o arquivo deve ser encerrado.
[in] aContext
Um ponteiro opcional para os dados de contexto fornecidos pelo autor da chamada.
[out] aResult
Uma referência ao armazenamento para um leitor de TLV que será posicionado na tag especificada em caso de êxito.
[in] aRecurse
É um booleano que indica se (verdadeiro) ou não (falso) alguma matriz ou estrutura encontrada precisa ser descendente.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Se o aPredicate especificado não localizou o elemento especificado

FindHandler

WEAVE_ERROR FindHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

Pesquise a tag especificada no leitor de TLV fornecido.

Detalhes
Parâmetros
[in] aReader
Uma referência somente leitura ao leitor TLV em que é possível encontrar a tag especificada.
[in] aDepth
A profundidade atual nos dados TLV.
[in,out] aContext
Um ponteiro para o contexto específico do gerenciador.
Valores de retorno
WEAVE_NO_ERROR
Se der certo.
WEAVE_ERROR_INVALID_ARGUMENT
Se aContext for NULL.
WEAVE_ERROR_MAX
Se a tag especificada for encontrada.

FindPredicateHandler

WEAVE_ERROR FindPredicateHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

Faça ajustes

WEAVE_ERROR Iterate(
  TLVReader & aReader,
  size_t aDepth,
  IterateHandler aHandler,
  void *aContext,
  bool aRecurse
)

Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.

A iteração é cancelada se aHandler retorna algo diferente de WEAVE_NO_ERROR

Detalhes
Parâmetros
[in] aReader
Uma referência ao leitor de TLV que contém os dados TLV a serem iterados.
[in] aDepth
A profundidade atual nos dados TLV.
[in] aHandler
Um callback para invocar o elemento TLV atual que está sendo visitado.
[in,out] aContext
Um ponteiro opcional para os dados de contexto fornecidos pelo autor da chamada.
[in] aRecurse
Um booleano que indica se (verdadeiro) ou não (falso) alguma matriz ou estrutura encontrada precisa ser descendente.
Valores de retorno
WEAVE_END_OF_TLV
Em uma iteração bem-sucedida ao final de uma codificação TLV ou de um contêiner TLV.
The
último valor retornado por aHandler, se for diferente de WEAVE_NO_ERROR

Faça ajustes

WEAVE_ERROR Iterate(
  const TLVReader & aReader,
  IterateHandler aHandler,
  void *aContext
)

Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.

A iteração é cancelada se aHandler retorna algo diferente de WEAVE_NO_ERROR

Detalhes
Parâmetros
[in] aReader
Uma referência ao leitor de TLV que contém os dados TLV a serem iterados.
[in] aHandler
Um callback para invocar o elemento TLV atual que está sendo visitado.
[in,out] aContext
Um ponteiro opcional para os dados de contexto fornecidos pelo autor da chamada.
Valores de retorno
WEAVE_END_OF_TLV
Em uma iteração bem-sucedida ao final de uma codificação TLV ou de um contêiner TLV.
WEAVE_ERROR_INVALID_ARGUMENT
Se aHandler for NULL.
The
último valor retornado por aHandler, se for diferente de WEAVE_NO_ERROR

Faça ajustes

WEAVE_ERROR Iterate(
  const TLVReader & aReader,
  IterateHandler aHandler,
  void *aContext,
  const bool aRecurse
)

Itere os dados de TLV referenciados por aReader e invoque aHandler para cada elemento TLV visitado no contexto de aContext.

A iteração é cancelada se aHandler retorna algo diferente de WEAVE_NO_ERROR

Detalhes
Parâmetros
[in] aReader
Uma referência ao leitor de TLV que contém os dados TLV a serem iterados.
[in] aHandler
Um callback para invocar o elemento TLV atual que está sendo visitado.
[in,out] aContext
Um ponteiro opcional para os dados de contexto fornecidos pelo autor da chamada.
[in] aRecurse
Um booleano que indica se (verdadeiro) ou não (falso) alguma matriz ou estrutura encontrada precisa ser descendente.
Valores de retorno
WEAVE_END_OF_TLV
Em uma iteração bem-sucedida ao final de uma codificação TLV ou de um contêiner TLV.
WEAVE_ERROR_INVALID_ARGUMENT
Se aHandler for NULL.
The
último valor retornado por aHandler, se for diferente de WEAVE_NO_ERROR