4D Doc Center : ARRAY STRING

4D v14.3

ARRAY STRING


ARRAY STRING ( strComp ; nomeArray ; tamanho {; tamanho2} )

Parâmetro	Tipo	Descrição
strComp	Inteiro longo	Comprimento da string (1...255)
nomeArray	Array	Nome do array
tamanho	Inteiro longo	Número de elementos no array ou Número de linhas se tamanho2 for especificado
tamanho2	Inteiro longo	Número de colunas em um array de duas dimensões

Descrição

O comando ARRAY STRING cria e/ou redimensiona um array de elementos String na memória.

Nota de compatibilidade: bancos de dados criados a partir da versão 11 de 4D são executados por padrão no modo Unicode (consulte a seção Códigos ASCII ). Neste modo, o funcionamento do comando ARRAY STRING é rigorosamente idêntico ao do comando ARRAY TEXT (o parâmetro strComp é ignorado). É recomendado o uso de ARRAY TEXT em novos desenvolvimentos. O comando ARRAY STRING é mantido apenas por razões de compatibilidade.

O parâmetro strComp especifica o número máximo de caracteres que podem estar contidos em cada elemento do array em um array de strings. O comprimento pode ser de 1 a 255 caracteres.

Nota: este parâmetro é levado em conta apenas quando o banco de dados é executado no modo não-Unicode. No modo Unicode, ele é ignorado (veja acima Nota de Compatibilidade).

• O parâmetro arrayNome é o nome do array.
• O parâmetro tamanho é o número de elementos no array.
• O parâmetro tamanho2 é opcional, se tamanho2 é especificado, o comando cria um array bidimensional. Neste caso, o tamanho especifica o número de linhas e tamanho2 especifica o número de colunas em cada array. Cada linha em um array bidimensional pode ser tratada tanto como um elemento e como uma matriz. Isto significa que ao trabalhar com a primeira dimensão do array, você pode usar array outros comandos para inserir e excluir arrays inteiros em um array bidimensional.

Ao aplicar ARRAY STRINGpara um array existente:

Se você aumentar o tamanho do array, os elementos existentes serão mantidos sem alterações, e os novos elementos serão inicializados como "" (string vazia).
Se você reduzir o tamanho do array, os últimos elementos excluídos do array são perdidos.

 ARRAY STRING(255;◊asValores;50)

 For($vlElem;1;50)

    ◊asValores{$vlElem}:="Elemento #"+String($vlElem)

 End for

4D v14.3

ARRAY STRING

ARRAY STRING

Descrição

Exemplo 1

Exemplo 2

Exemplo 3