PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Insertar un elemento en una array
  • Agregar un elemento a una propiedad array de tipo avanzado
  • Insertar un elemento en una lista
  • Inserción de una array
  • Insertar una lista
  • Condiciones de uso
  • Varios
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Inserta un elemento en una posición determinada:
  • en una array unidimensional.
  • en una array asociativo.
  • en una propiedad array avanzada (array de eventos gglCalendar, etc.).
  • en una lista WLanguage.
Esta función también permite concatenar dos arrays o dos listas.
Observaciones:
  • Esta función es equivalente a la función Insert.
  • WEBDEV - Browser codePHP Esta función sólo se puede utilizar con las variables Array y Array asociativa.
Versions 15 and later
Android Esta función ahora está disponible para aplicaciones Android.
New in version 15
Android Esta función ahora está disponible para aplicaciones Android.
Android Esta función ahora está disponible para aplicaciones Android.
Versions 16 and later
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
New in version 16
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
Versions 17 and later
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
WEBDEV - Browser code Esta función ahora está disponible en código navegador.
New in version 17
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
WEBDEV - Browser code Esta función ahora está disponible en código navegador.
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
WEBDEV - Browser code Esta función ahora está disponible en código navegador.
Versions 18 and later
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
New in version 18
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Versions 21 and later
Apple Watch Esta función ahora está disponible en modo Apple Watch.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
New in version 21
Apple Watch Esta función ahora está disponible en modo Apple Watch.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Apple Watch Esta función ahora está disponible en modo Apple Watch.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Example
MyArray is array of 2 strings
ArrayInsert(MyArray, 1, "WINDEV")
ArrayInsert(MyArray, 2, "WEBDEV")
ArrayInsert(MyArray, 3, "WINDEV and WEBDEV")
// Display the content of 3rd element
Trace(MyArray[3]) // Displays "WINDEV and WEBDEV"
MyArray is array of 2 strings
MyArray[1] = "WINDEV"
MyArray[2] = "WEBDEV"
ArrayInsert(MyArray, 3, "WINDEV and WEBDEV")
// Display the content of 3rd element
Trace(MyArray[3]) // Displays "WINDEV and WEBDEV"
// Associative array Last Name - First Name
aaLastNameFirstName is associative array of strings
ArrayInsert(aaLastNameFirstName, "Smith", "Tommy")
ArrayInsert(aaLastNameFirstName, "Montgomery", "Julia")
Syntax

Insertar un elemento en un array o en un array Property avanzado Hide the details

ArrayInsert(<WLanguage array> , <Insertion subscript> [, <Element value>])
<WLanguage array>: Array
Nombre de la variable de tipo Array a manipular. Este array debe ser unidimensional.
<Insertion subscript>: Integer
Índice donde el elemento será insertado en el array. A partir de esta índice, todos los elementos serán movidos por 1 elemento.
Si <Inserción Índice> es igual al número de elementos array +1, el elemento se añade al final de array (equivalente a ArrayAdd)..
Se produce un error de WLanguage si <Insertion índice> es mayor que el número de elementos en array +1.
<Element value>: Any type, optional
Elemento que se insertará en el array especificado, en la posición dada.. Si no se especifica este parámetro, el array se amplía con el valor Default del tipo de los otros elementos array.

Insertar un elemento en un array asociativo Hide the details

ArrayInsert(<WLanguage array> , <Element key> , <Element value>)
<WLanguage array>: Array
Nombre de la variable de tipo Array a manipular. Este array debe ser unidimensional.
<Element key>: Type of key in the associative array
Valor de la clave para la que se insertará el elemento. En una array asociativo sin duplicado, se produce un error de WLanguage si el elemento ya existe.
<Element value>: Any type
Elemento que debe añadirse a la array especificada.

Insertar un array en un array Hide the details

ArrayInsert(<WLanguage array> , <Insertion subscript> [, <Array to insert>])
<WLanguage array>: Array
Nombre de la variable de tipo Array a manipular. Este array debe ser unidimensional.
<Insertion subscript>: Integer
Índice donde el elemento será insertado en el array. A partir de esta índice, todos los elementos serán movidos por 1 elemento.
Si <Inserción Índice> es igual al número de elementos array +1, el elemento se añade al final del array (equivalente a ArrayAdd)..
Se produce un error de WLanguage si <Insertion índice> es mayor que el número de elementos en array +1.
<Array to insert>: Optional array
Nombre de la variable Array que se insertará en el índice de inserción especificado en <Arraty WLanguage>.
WEBDEV - Browser codePHP No disponible en código de navegador y en PHP

Insertar un elemento en una lista Hide the details

ArrayInsert(<WLanguage list> , <Insertion subscript> , <Element value>)
<WLanguage list>: List
Nombre de la Lista Variable a utilizar.
<Insertion subscript>: Integer constant
Índice donde el elemento será insertado en la lista. Se pueden utilizar las siguientes constantes:
FirstElementEl elemento se inserta al principio de la lista.
LastElementEl elemento se inserta al final de la lista.
BeforeCurrentElementEl elemento se inserta antes del elemento de corriente.
Esta constante está disponible sólo cuando se navega por los elementos de la lista.
Atención: El elemento será navegado por la siguiente iteración si el bucle es un bucle descendente.
AfterCurrentElementEl elemento se inserta después del elemento de corriente.
Esta constante está disponible sólo cuando se navega por los elementos de la lista.
Atención: El elemento será navegado por la siguiente iteración si el bucle es un bucle ascendente.
<Element value>: Any type
Elemento que se insertará en la lista en la posición especificada.
WEBDEV - Browser codePHP No disponible en código de navegador y en PHP

Insertar una lista en una lista Hide the details

ArrayInsert(<WLanguage list> , <Insertion subscript> , <Name of list to insert>)
<WLanguage list>: List
Nombre de la Lista Variable a utilizar.
<Insertion subscript>: Integer constant
Índice donde se insertará la lista en la lista. Se pueden utilizar las siguientes constantes:
FirstElementEl List se inserta al principio de <List nombre>.
LastElementEl List se inserta al final de <List nombre>.
BeforeCurrentElementLa lista se inserta antes del elemento actual.
Esta constante sólo está disponible cuando se navega por los elementos de la lista.
AfterCurrentElementLa lista se inserta después del elemento actual.
Esta constante sólo está disponible cuando se navega por los elementos de la lista.

<Name of list to insert>: List
List que se insertará en la inserción especificada índice.
Remarks

Insertar un elemento en una array

Cuando se llama a la función ArrayInsert:
  • el array se amplía automáticamente para recibir el nuevo elemento.
  • si es necesario, el elemento se convierte en el tipo de los otros elementos del array.
Cuando se declara una array de N elementos, esta array contiene N elementos vacíos. Por ejemplo, el array que se declara a continuación contiene 3 cadenas vacías.
MyArray is array of 3 strings
Al insertar un elemento (función ArrayInsert), éste se inserta automáticamente entre los elementos que ya se encuentran en el array.
En nuestro ejemplo, la array contendrá 4 elementos una vez realizada la inserción.

Agregar un elemento a una propiedad array de tipo avanzado

Cuando se llama a la función ArrayInsert:
  • se debe crear la variable de tipo avanzado.
  • el tipo avanzado debe tener un enumerador de tipo de colección modificable.
  • el tipo avanzado se amplía automáticamente para recibir los nuevos elementos.
  • el elemento se inicializa con el valor pasado como parámetro. Si no se pasa ningún valor como parámetro, el elemento se inicializa con el valor predeterminado del tipo de los elementos del array.

Insertar un elemento en una lista

Cuando se llama a la función ArrayInsert:
  • la lista se amplía automáticamente para recibir el nuevo elemento.
  • si es necesario, el elemento se convierte en el tipo de los otros elementos de la lista.
WEBDEV - Browser codePHP Esta funcionalidad no está disponible.

Inserción de una array

Al utilizar la función ArrayInsert:
  • el array se amplía automáticamente para recibir los nuevos elementos. Los elementos del <Nombre del array por insertar> se agregan en la posición especificada en <Nombre del array>.
  • los dos arrays deben ser del mismo tipo.
  • los arrays deben tener la misma dimensión.
  • los valores de las dimensiones de array (excepto la primera) deben ser idénticos.

Insertar una lista

Cuando se llama a la función ArrayInsert:
  • la lista se amplía automáticamente para recibir los nuevos elementos. Los elementos de <Nombre de la lista a insertar> se añaden en la posición especificada.
  • las dos listas deben ser del mismo tipo.
WEBDEV - Browser codePHP Esta funcionalidad no está disponible.

Condiciones de uso

Esta función se puede utilizar con las estructuras. En este caso, se debe:
  1. Declarar una variable del mismo tipo que la estructura).
  2. Inicializar cada miembro.
  3. Pasar la variable estructura como parámetro a la función ArrayInsert.
Esta función no puede utilizarse:
  • los arrays no creados
  • arrays fijos.

Varios

  • Para añadir un elemento al final de una array unidimensional, utilice ArrayAdd o añadir.
  • Para agregar un elemento a un array ordenado (respetando el orden), utilice la función ArrayAddSorted.
Component : wd260vm.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment