SAVE VARIABLES

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

Parâmetro	Tipo		Descrição
documento	Text	→	Documento no qual vai guardar as variáveis
variavel	Variable	→	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.

Ver também

BLOB TO DOCUMENT
BLOB TO VARIABLE
DOCUMENT TO BLOB
LOAD VARIABLES
VARIABLE TO BLOB
Variáveis sistema