4D Doc Center : Structure file

4D v14.3

Structure file


Structure file {( * )} -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	Retorna o arquivo de estrutura do banco de dados local
Resultado	cadeia	Nome longo do arquivo de estrutura do banco de dados

Descrição

O comando Structure file retorna o nome completo do arquivo de estrutura do banco de dados com o qual você está trabalhando atualmente.

No Windows
Se, por exemplo, você está trabalhando com o banco de dados MeusCDs localizado em \DOCS\MeusCDs no volume G, o comando retorna G:\DOCS\MyCDs\MyCDs.4DB.

No Macintosh
Se, por exemplo, você está trabalhando com o banco de dados localizado na pasta Documentos:MeusCDsƒ: no disco Macintosh HD, o comando retorna Macintosh HD:Documentos:MeusCDsƒ:MeusCDs.

Nota: No caso específico de um banco de dados que foi compilado e se fundiu com 4D Desktop, este comando retorna o caminho do arquivo (da aplicação executável) no Windows e Mac OS. No Mac OS, este arquivo está localizado dentro do pacote de software, na pasta [Contents:Mac OS]. Isto deriva de um mecanismo antigo e é mantido por razões de compatibilidade. Se você deseja obter o nome completo do pacote de software em si, é preferível usar o comando Application file. A técnica consiste em testar o aplicativo usando o comando Application type, em seguida, a execução de Structure file ou Application file, dependendo do contexto.

ATENÇÃO: Se você chamar este comando durante a execução de 4D Client, apenas o nome do arquivo de estrutura é retornada; o nome completo não é devolvido.

O parâmetro opcional * é útil no caso de uma arquitetura usando componentes: ele pode ser usado para determinar a estrutura (host ou componente) para os quais você deseja obter o nome completo, dependendo do contexto em que o comando é chamado::

Quando o comando é chamado de um componente:

- Se o parâmetro * for passado, o comando retorna o nome completo do arquivo de estrutura do banco de dados do host,

- Se o parâmetro * não for passado, o comando retorna o nome completo do arquivo estrutura do componente.

O arquivo de estrutura do componente corresponde ao arquivo .4db or .4dc do componente encontrado na pasta "Components" do banco de dados. No entanto, um componente também pode ser instalado como um alias/atalho ou uma pasta/pacote .4dbase:

- No caso de um componente instalado como um alias/atalho, o comando retorna o caminho do db original .4db ou do arquivo .4dc (o alias ou atalho é resolvido).

- No caso de um componente instalado em uma pasta/pacote .4dbase, o comando retorna o caminho do arquivo .4db ou .4dc localizado dentro desta pasta/pacote.

• Quando o comando é chamado de um método de banco de dados do host, ele sempre retorna o nome completo do arquivo de estrutura do banco de dados de host, independentemente de haver ou não o parâmetro *.

Exemplo 1

Este exemplo exibe o nome e a localização do arquivo de estrutura atualmente em uso:

 If(Application type#4D Remote Mode)

    $vsNomeArquivoEstrutura:=Long name to file name(Structure file)

    $vsNomeEndereçoEstrutura:=Long name to path name(Structure file)

    ALERT("Está utilizando atualmente a base "+Char(34)+$vsNomeArquivoEstrutura+Char(34)+

    " ubicado en "+Char(34)+$vsNomeEndrecoEstrutura+Char(34)+".")

 Else

    ALERT("Está conectado a base "+Char(34)+Structure file+Char(34))

 End if

Nota: Os métodos de projeto Long name to file name e Long name to path name estão listados na seção Documentos de Sistema.

Exemplo 2

O exemplo a seguir pode ser usado para descobrir se o método é chamado de um componente:

 C_BOOLEAN($0)

 $0:=(Structure file#Structure file(*))

  ` $0=True se o método é chamado desde um componente