Pular para o conteúdo
officetuning.aiofficetuning.ai
TreinamentosConsultoriaBibliotecaFerramentasConteúdoPortfólio
Entrar
officetuning.aiofficetuning.ai

Treinamento, consultoria e mentoria para decidir, construir e aprender nas quatro frentes da marca.

AI · Data · Productivity · Dev · São Paulo
contato@officetuning.ai
TreinamentosPower BIExcelSQLPowerPointIA + ProdutividadeTodos os treinamentos
PortalConsultoriaBibliotecaPortfólioBackground BuilderDashboard CanvasConteúdo
InstitucionalPolítica de privacidadeInformações legais
© 2026 officetuning.ai · São Paulo
  1. Biblioteca
  2. Power Query (M)
  3. Funções M
  4. BinaryFormat.Group

BinaryFormat.Group

MBinário

Retorna um formato binário que lê um grupo de itens identificados por chave. binaryFormat define o formato da chave, group lista as definições dos itens conhecidos e extra indica o formato do valor que segue uma chave inesperada.

Sintaxe

M
BinaryFormat.Group(binaryFormat as function, group as list, optional extra as nullable function, optional lastKey as any) as function

Parâmetros

binaryFormatfunctionObrigatório

Formato binário do valor da chave.

M
BinaryFormat.Byte
grouplistObrigatório

Lista com as definições dos itens conhecidos do grupo.

extranullable functionOpcional

Função que retorna o formato binário do valor que segue uma chave inesperada.

M
(extra) => BinaryFormat.Byte
lastKeyanyOpcional

Chave opcional; o Learn não descreve este parâmetro.

Retorna

function

Exemplo

M
let
    b = #binary({
        1, 11,
        2, 22,
        2, 22,
        5, 55,
        1, 11
    }),
    f = BinaryFormat.Group(
        BinaryFormat.Byte,
        {
            {1, BinaryFormat.Byte, BinaryOccurrence.Required},
            {2, BinaryFormat.Byte, BinaryOccurrence.Repeating},
            {3, BinaryFormat.Byte, BinaryOccurrence.Optional},
            {4, BinaryFormat.Byte, BinaryOccurrence.Repeating}
        },
        (extra) => BinaryFormat.Byte
    )
in
    f(b)

Resultado

M
{11, {22, 22}, null, {}}

Observações

Cada item de group é uma lista de 3 a 5 valores: chave única, formato do item, ocorrência (BinaryOccurrence.Type), valor padrão (opcional) e função de transformação (opcional). Sem extra, chaves inesperadas geram erro; itens obrigatórios ausentes também geram erro. O padrão de itens opcionais é null e o de itens repetidos é a lista vazia {}.

Mais informações

Subgrupo
BinaryFormat
Referência
https://learn.microsoft.com/pt-br/powerquery-m/binaryformat-group
Função anteriorBinaryFormat.DoublePróxima função BinaryFormat.Length
Biblioteca