4D Doc Center : FIRST SUBRECORD

4D v14.3

FIRST SUBRECORD


FIRST SUBRECORD ( subTabela )

Parâmetro	Tipo	Descrição
subTabela	Subtabela	Subtabela na qual vai mover o primeiro subregistro selecionado

Nota de compatibilidade

As subtabelas não são compatíveis a partir da versão 11 de 4D. Um mecanismo de compatibilidade garante o funcionamento de este comando em bancos compartilhadas; entretanto, é recomendável substituir as subtabelas com tabelas relacionadas padrão.

Descrição

FIRST SUBRECORD carrega o primeiro subregistro da subseleção atual de subTabela e o converte no subregistro atual. Todos os comandos de pesquisa, seleção, e ordenação também atribuem o subregistro atual ao primeiro subregistro. Se a subseleção atual estiver vazia, FIRST SUBRECORD não faz nada.

Exemplo

O exemplo abaixo concatena os nomes e sobrenomes das crianças armazenadas em uma subtabela, depois os copia no array arrNomes:

  ` Criação de um array para receber os nomes

 ARRAY TEXT(arrNomes;Records in subselection([Pessoas]Crianças))

 FIRST SUBRECORD([Pessoas]Crianças) ` Começa no primeiro subregistro e realiza um loop por criança

 For($vlSub;1;Records in subselection([Pessoas]Crianças))

    arrNomes{$vlSub}:=[Pessoas]NomeCriança+" "+[Pessoas]SobrenomeCriança

    NEXT SUBRECORD([Pessoas]Crianças)

 End for