Histórico da Página

Sintaxe

SPACE( <expressão numérica> )

Propósito

Fornece uma cadeia de caracteres formada por um número especificado de espaços em branco.

Argumentos

< expressão numérica >

Define o número de espaços em branco que formará a cadeia de caracteres.

Esse número deve ser inteiro positivo e possuir no máximo 65.535 (64 Kbytes).

Utilização

A utilização mais comum para essa função é a iniciação de variáveis caracteres que deverão receber dados de um determinado comprimento. Portanto, a variável é iniciada com o número de espaços em branco previsto pelo comprimento máximo que os dados possuirão.

Essa função é equivalente à função REPLICATE(), quando nesta for especificado um espaço em branco como sendo a cadeia de caracteres a ser replicada.

Se a expressão numérica que especifica o número de brancos da cadeia de caracteres a ser fornecida for igual à zero, será gerada uma cadeia de caracteres nula (“”).

Dicas

Ao solicitar uma entrada de dados por meio de uma interface de tela com variáveis, deve-se previamente iniciar as variáveis a serem lidas. A função SPACE() é útil para a iniciação de variáveis caracter ou data.

A função SPACE() também pode ser utilizada para formatar dados, adicionando-se espaços para a centralização ou a justificação de textos, títulos, etc. Entretanto, as funções PADC(), PADL() e PADR() são mais recomendadas para estes propósitos.

Exemplos

Este exemplo utiliza a função SPACE() para iniciar uma variável para entrada de dados:

LOCAL cNome := SPACE(LEN(SA1->A1_NOME))

@ 010,050 MSGET cNome SIZE 55,11 OF oDlg PIXEL PICTURE “@!” VALID !Vazio()