PUT_STRING ()

Propósito

Armazenar em uma string C o conteúdo de uma expressão caractere.

Sintaxe

PUT_STRING (<exp.C>, <var.CHAR> [, <exp.N>])

Argumentos

<exp.C>	representa uma expressão caractere definida na OPUS.
<var.CHAR>	representa uma variável CHAR* definida em C.
<exp.N>	representa uma expressão numérica.

Utilização

Atribui a expressão caractere <exp.C> à variável <var_CHAR> definida em C. Opcionalmente, pode-se definir a quantidade de caracteres que serão recebidos por <var.CHAR>. Caso contrário, <var.CHAR> receberá todo o conteúdo de <exp.C>. PUT_STRING () retorna a cadeia realmente armazenada. O nome da variável C durante a compilação não sofre qualquer crítica por parte do compilador OPUS, por este motivo é recomendável que o nome destas variáveis da C sejam passados como um literal.

Exemplo

O exemplo a seguir mostra-nos como utilizar esta função.

PROG

CC DECL

  char var_CHAR[21]

ENDCC

var_cad = "Teste do uso de GET_STRING e PUT_STRING"

? PUT_STRING ("var_cad", var_CHAR, 15) 

? GET_STRING ("var_CHAR")      && Exibirá "Teste do uso de"

? GET_STRING ("var_CHAR", 3) && Exibirá "Tes"