Histórico da Página

Composition Setup
import.css=/download/attachments/6062824/tecnologia.css

Pagetitle

	Array
	Array

Cria um array não inicializado com a quantidade especificada de elementos.

Sintaxe

Bloco de código

collapse	false

Array( < nElementos1 >, [ xElemento2,xElemento3...xElemento16 ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
nElementos1	numérico	Indica o tamanho do array	X
xElemento2,xElemento3...xElemento16	qualquer	Se for numérico, cria um array multidimensional, se for diferente de número inicializa o array com o valor informado

Retorno

Nome	Tipo	Descrição
aRet	vetor	Retorna um array com a dimensão especificada.

Observações

Até 16 parametros podem ser informados, para criar arrays multidimensionais. Somente o último parametro pode ser diferente de número para inicializar o array o valor informado.

Exemplos

Bloco de código

theme	Eclipse
language	cpp
title	Exemplo 1
linenumbers	true
collapse	false

User Function Exemplo()
  Local aExemplo := Nil
  Local cMensagem := ""
  //+----------------------------------------------------------------------------+
  //|Exemplifica o uso da função Array                                           |
  //+----------------------------------------------------------------------------+
  aExemplo := Array(7, 7)
  aExemplo[1] := {"E", "A", "S", "U", "I", "M", "F"}
  aExemplo[2] := {"Ç", "X", "D", "F", "B", "N", "X"}
  aExemplo[3] := {"D", "P", "E", "G", "G", "H", "B"}
  aExemplo[4] := {"N", "A", "K", "M", "R", "E", "H"}
  aExemplo[5] := {"R", "H", "Z", "Y", "P", "T", "Y"}
  aExemplo[6] := {"K", "X", "A", "K", "J", "L", "U"}
  aExemplo[7] := {"M", "S", "C", "V", "P", "O", "O"}
  cMensagem += cValToChar(aExemplo[1][1])
  cMensagem += cValToChar(aExemplo[2][2])
  cMensagem += cValToChar(aExemplo[3][3])
  cMensagem += cValToChar(aExemplo[4][4])
  cMensagem += cValToChar(aExemplo[5][5])
  cMensagem += cValToChar(aExemplo[6][6])
  cMensagem += cValToChar(aExemplo[7][7])
  //+----------------------------------------------------------------------------+
  //|Apresenta uma mensagem com os resultados obtidos                            |
  //+----------------------------------------------------------------------------+
  MsgInfo(cMensagem, "Exemplo do Array")
Return

Abrangência

Microsiga Protheus 8.11 , Protheus 10

Veja também

Manipulação de matriz

Existen algunos cuidados necesarios para la creación y utilización de variables del tipo array, como por ejemplo:

En la creación siempre debe inicializarse como un Array.
- Ejemplo:

...

Cargar en líneas en lugar de colocarlos en una sola línea de comando y colocar una posición por línea.
- Ejemplo:

...

Para ayudar en el mantenimiento y utilización de este Array, es importante documentar siempre cada posición.
- Ejemplo:

...

Antes de referenciar los datos de un Array, es necesario verificar si realmente tiene datos cargados, para que no haya error.
- Ejemplo:

...

Árvore de páginas

Versões comparadas

Versão antiga 4

Nova versão Atual

Chave