TOTVSTEC

Árvore de páginas

Retorna o alias de uma área de trabalho especificada.

Sintaxe

Alias( [ nWorkArea ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nWorkArea

numérico

Indica o número (entre 0 e 511) da área de trabalho que será verificada.



Retorno

Nome

Tipo

Descrição

cAlias

caractere

Retorna o alias da área de trabalho, no formato string, em letras maiúsculas. Caso o parâmetro (nWorkArea) não seja informado, o retorna será o alias da área de trabalho corrente ou, se não houver nenhum arquivo em uso, uma string vazia ("").

Observações

Alias() é uma função de banco de dados utilizada para determinar o alias da área de trabalho especificada. Alias é o nome atribuído a uma área de trabalho quando um arquivo de banco de dados está em uso. O nome atribuído é o nome real do arquivo de banco de dados ou um nome que foi explicitamente atribuído através da cláusula ALIAS usada na abertura da tabela através do comando USE ou da função DbUseArea()

Alias() é o inverso da função Select(). Alias() retorna o alias através do número da área de trabalho e Select() o número da área de trabalho através do alias.

Exemplos

FUNCTION Example()
  Local cTab1 := "T1TST"
  Local cAlias := "T01"
  TCLink()
  
  DBCreate(cTab1, {{"CAMPO1", "C", 10, 0}, ;
                   {"CAMPO2", "C", 10, 0}}, "TOPCONN")
                  
  DBUseArea(.F., 'TOPCONN', cTab1, cAlias1, .F., .T.)

  conout("Alias corrente = " + Alias() ) // Resultado deve ser "T01"
  
  DBCloseArea()
  
  conout("Alias corrente = " + Alias() ) // resultado deve ser "" string vazia

  TCUnlink()
RETURN

Veja também

  • Sem rótulos