GET_STRING()

• Propósito
• Sintaxe
• Argumentos
• Utilização
• Exemplo

Propósito

Retornar uma cadeia de caracteres armazenada em uma variável C.

Sintaxe

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

Argumentos

<var.CHAR>	representa uma variável do tipo CHAR* definida em C.
<exp.N>	representa o tamanho do retorno desta função.

Utilização

Retorna uma cadeia de caracteres armazenada na variável <var.CHAR> definida em C. Opcionalmente pode-se definir o tamanho deste retorno. Caso contrário, o retorno tem tamanho limitado pela definição no comando $LENTMP ou até o fim da string C (\0), o que for menor.

<var_CHAR> pode ser definida como CHAR ou ponteiro de um CHAR. 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 do C sejam passados como um literal.

Exemplo

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

PROG

CC DECL

char var_CHAR[41];

ENDCC

CC PROC

strncpy(var_CHAR,"Teste do uso de GET_STRING e PUT_STRING",40);

ENDCC

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

? GET_STRING ("var_CHAR", 5)     && Exibirá "Teste"