4D v14.3ARRAY 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 | |||||
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.
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:
Este exemplo cria um array de processo de 100 elementos String de 31 caracteres:
ARRAY STRING(31;asValores;100)
Este exemplo cria um array local de 100 linhas de 50 elementos String de 63 caracteres:
ARRAY STRING(63;$asValores;100;50)
Este exemplo cria uma matriz interprocesso de 50 elementos String de 255caracteres e define cada elemento com o valor "Elemento #" seguido pelo seu número de elementos:
ARRAY STRING(255;◊asValores;50)
For($vlElem;1;50)
◊asValores{$vlElem}:="Elemento #"+String($vlElem)
End for
Produto: 4D
Tema: Arrays
Número
218
Modificado: 4D v11 SQL
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)