4D Doc Center : C

4D v14.3

C_STRING


C_STRING ( {metodo ;} tamanho ; variavel {; variavel2 ; ... ; variavelN} )

Parâmetro	Tipo	Descrição
metodo	Método	Nome do método opcional
tamanho	Inteiro longo	Tamanho da cadeia
variavel	Variável	Nome da(s) variável(s) a declarar

Descrição

O comando C_STRING atribui o tipo Alfa a cada variável especificada.

O parâmetro tamanho especifica a longitude máxima das strings que a variável contém. As strings estão limitadas a 255 caracteres. Se deseja melhorar a velocidade de execução, utilize variáveis Alfa no lugar de variáveis Texto quando seja possível.

Nota de compatibilidade: os bancos criados a partir da versão 11 de 4D são executados por padrão em modo Unicode (ver a seção Códigos ASCII). Neste modo, o funcionamento do comando C_STRING é estritamente idêntico ao do comando C_TEXT (o parâmetro tamanho é ignorado). É recomendado que se utilize C_TEXT em novos projetos. O comando C_STRING se conserva unicamente por razões de compatibilidade.

A primeira sintaxe do comando, na qual o parâmetro opcional metodo NÃO se passa, é utilizada para declarar uma variável processo, interprocesso, ou local.

Nota: esta sintaxe pode ser utilizada em bases interpretadas.

A segunda sintaxe do comando, na qual o parâmetro opcional metodo SIM se passa, é utilizada para pré-declarar ao compilador o resultado ou os parâmetros ($0, $1, $2 etc.) de um método. Utilize esta sintaxe para evitar a fase de declaração de variáveis durante a compilação do banco, poupando tempo de compilação.

Advertência: a segunda sintaxe não pode ser executada em modo interpretado. Por essa razão, se utiliza esta sintaxe, mantenha-la em um método que não seja executado em modo interpretado. O nome deste método deve começar por “COMPILER.”

Conselho avançado: a sintaxe C_STRING(...;${...}) lhe permite declarar um número variável de parâmetros do mesmo tipo, com a condição de que sejam os últimos parâmetros do método. Por exemplo, a declaração C_STRING(...;${5}) lhe indica a 4D e ao compilador que a partir do quinto parâmetro, o método pode receber um número variável de parâmetros desse tipo. Para maior informação, consulte o comando Count parameters.

Exemplos

Ver exemplos na seção Comandos de Compilação.