4D v13.4
ARRAY STRING
- Manual de linguagem 4D
-
- Arrays
-
- Arrays
- Criando arrays
- Arrays e objetos de formulário
- Arrays e a linguagem 4D
- Arrays e ponteiros
- Usando o elemento zero de um array
- Arrays de duas dimensões
- Arrays e Memória
- APPEND TO ARRAY
- ARRAY BOOLEAN
- ARRAY DATE
- ARRAY INTEGER
- ARRAY LONGINT
- ARRAY PICTURE
- ARRAY POINTER
- ARRAY REAL
- ARRAY STRING
- ARRAY TEXT
- ARRAY TO LIST
- ARRAY TO SELECTIONUpd
- BOOLEAN ARRAY FROM SET
- COPY ARRAY
- Count in array
- DELETE FROM ARRAY
- DISTINCT VALUES
- Find in array
- INSERT IN ARRAY
- LIST TO ARRAY
- LONGINT ARRAY FROM SELECTION
- MULTI SORT ARRAY
- SELECTION RANGE TO ARRAYUpd
- SELECTION TO ARRAYUpd
- Size of array
- SORT ARRAY
- TEXT TO ARRAYNew
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.
- 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.
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
