DBRELATION()
 Retorna a expressao de uniao de um relacionamento específico
------------------------------------------------------------------------------

 Sintaxe

     DBRELATION(<nRelacionamento>) --> cExpUniao

 Argumentos

     <nRelacionamento> é a posiçao do relacionamento desejado na lista
     dos relacionamentos da área de trabalho corrente.  Os relacionamentos
     sao numerados de acordo com a ordem na qual estes foram definidos com o
     SET RELATION.

 Retorno

     DBRELATION() retorna uma cadeia de caracteres contendo a expressao de
     uniao do relacionamento especificado por <nRelacionamento>.  Caso nao
     haja nenhum relacionamento configurado (SET RELATION) para
     <nRelacionamento>, a funçao DBRELATION() retornará uma cadeia de
     caracteres nula ("").

 Descriçao

     DBRELATION() é uma funçao que atua em arquivos de dados que é utilizada
     em conjunto com a funçao DBRSELECT() para determinar a expressao de
     uniao e a área de trabalho de um relacionamento existente criado com o
     comando SET RELATION.

     DBRELATION() retorna a expressao de uniao definida pela cláusula TO.
     DBRSELECT() retorna a área de trabalho relacionada tal como está
     definida pela cláusula INTO.

     Por padrao, DBRELATION() opera na última área de trabalho selecionada.
     DBRELATION() pode ser utilizada para trabalhar em uma área de trabalho
     nao selecionada especificando-a em uma expressao com alias (veja o
     exemplo abaixo).

 Notas

       Variáveis declaradas: Uma cadeia de caracteres retornada
        pela funçao DBRELATION() pode nao operar corretamente quando forem
        recompiladas e executadas utilizando o operador macro (&) caso a
        expressao original contenha referências a variáveis locais ou
        estáticas, ou se depende de declaraçoes em tempo de compilaçao.

 Exemplos

       Este exemplo abre três arquivos de dados, configura dois
        relacionamentos filhos (secundários) a partir da área de trabalho
        pai (principal), e entao exibe a expressao de uniao para a segunda
        área de trabalho filho:

        USE Invoices INDEX Invoices NEW
        USE BackOrder INDEX BackOrder NEW
        USE Customer INDEX Customer NEW
        SET RELATION TO CustNum INTO Invoices, OrderNum INTO BackOrder
        //
        ? DBRELATION(2)                       // Resulta: OrderNum

       Mais tarde você pode pesquisar a mesma expressao de uniao a
        partir de uma área de trabalho nao selecionada utilizando uma
        expressao com alias tal como a que aparece a seguir:

        USE Archive NEW
        ? Customer->(DBRELATION(2))           // Resulta: OrderNum

       Este exemplo é uma funçao definida pelo usuário, Relation(),
        que retorna o resultado de ambas funçoes DBRELATION() e DBRSELECT()
        na forma de vetor:

        FUNCTION Relation( nRelation )
           RETURN { DBRELATION(nRelation), ALIAS(DBRSELECT(nRelation)) }

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: DBFILTER() DBRSELECT() SET RELATION