Histórico da Página
Incluir 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()