4D Doc Center : SAVE VARIABLES

4D v14.3

SAVE VARIABLES


SAVE VARIABLES ( documento ; variavel {; variavel2 ; ... ; variavelN} )

Parâmetro	Tipo	Descrição
documento	cadeia	Documento no qual vai guardar as variáveis
variavel	Variável	Variáveis a guardar

Descrição

O comando SAVE VARIABLES guarda uma ou várias variáveis no documento cujo nome se passa em parâmetro documento.

As variáveis não devem ser do mesmo tipo, mas devem ser de tipo Cadeia, Texto, Numérico, Inteiro, Inteiro longo, Data, Hora, Booleano ou Imagem.

Se passar uma cadeia vazia em documento, aparece uma caixa de diálogo padrão de guardar arquivos; o usuário pode então escolher o documento a criar. Neste caso, a variável sistema Document toma o nome do documento se tiver sido criado.

Se as variáveis forem guardadas corretamente, a variável OK assume o valor 1. Se não, OK toma o valor 0.

Nota: quando escrever variáveis em documentos com SAVE VARIABLES, 4D utiliza um formato de dados interno. Pode recuperar as variáveis apenas com o comando LOAD VARIABLES. Não use RECEIVE PACKET ou RECEIVE VARIABLE para ler um documento criado por SAVE VARIABLES.

Aviso: este comando não é compatível com variáveis de tipo array. Para estas variáveis use os comandos do tema BLOB.

Exemplo

O exemplo abaixo guarda três variáveis em um arquivo chamado PrefsUsuario:

SAVE VARIABLES(" PrefsUsuario";vsNome;vlCodigo;vgIconImagem)

Variáveis e conjuntos do sistema

Se as variáveis são guardadas corretamente, a variável sistema OK assume o valor 1; do contrário assume o valor 0.