Count

Retorna o número de valores válidos que não estão em branco em um campo.

Formato 

Count ( campo {; campo...} )

Parâmetros 

campo - qualquer campo relacionado, campo de repetição ou conjunto de campos sem repetição; ou uma expressão que retorna um campo, campo de repetição ou conjunto de campos sem repetição.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

número

Originada na versão 

6.0 ou anterior

Descrição 

Campo pode ser qualquer um dos seguintes:

  • um campo de repetição (campoDeRepetição).
  • um campo em registros relacionados correspondentes especificados por (tabela::campo), se esses registros aparecerem ou não em um portal.
  • vários campos sem repetição em um registro (campo1;campo2;campo3...).
  • repetições correspondentes de campos de repetição em um registro (campoDeRepetição1;campoDeRepetição2;campoDeRepetição3), se o resultado for retornado em um campo de repetição com pelo menos o mesmo número de repetições.
  • vários campos no primeiro registro correspondente especificados por (tabela::campo1;tabela::campo2;...). Você pode incluir campos de diferentes tabelas (tabela 1::campo A;tabela 2::campo B...).

Notas 

  • Quando um campo mencionado é um campo de repetição, a função Count retorna o número total de valores válidos que não estão em branco no primeiro campo de repetição, depois o número de valores válidos que não estão em branco no segundo campo de repetição e assim por diante.

Exemplo 1 

O layout Contas tem um portal que mostra pagamentos feitos em prestações.

Count(Pagamentos::Pagamento) retorna o número de pagamentos efetuados em uma conta.

Exemplo 2 

Nos seguintes exemplos:

  • Campo1 contém duas repetições com valores de 1 e 2.
  • Campo2 contém quatro repetições com valores de 5, 6, 7 e 8.
  • Campo3 contém 6.

Count(Campo2) retorna 4 quando o cálculo não é um campo de repetição.

Count(Campo1;Campo2;Campo3) retorna 3, 2, 1, 1 quando o cálculo é um campo de repetição.

Tópicos relacionados