AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de colas, pilas, listas y arrays / Funciones de arrays
  • 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 tabla
  • Insertar una lista
  • Condiciones de uso
  • Varios
Inserta un elemento en una posición determinada:
  • en una array unidimensional.
  • en una array asociativa.
  • 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.
WEBDEV - Código NavegadorPHP Observación: Esta función solo se puede utilizar con variables de tipo Array y Associative array.
Ejemplo
MyArray is array of 2 strings
MyArray.Insert(1, "WINDEV")
MyArray.Insert(2, "WEBDEV")
MyArray.Insert(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"
MyArray.Insert(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
aaLastNameFirstName.Insert("Smith", "Tommy")
aaLastNameFirstName.Insert("Montgomery", "Julia")
Sintaxis

Insertar un elemento en un array o en un array Property avanzado Ocultar los detalles

<WLanguage array>.Insert(<Insertion index> [, <Element value>])
<WLanguage array>: Array
Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional.
<Insertion index>: Integro
Índice donde se insertará el elemento en la array. A partir de este índice, todos los elementos se desplazarán en 1 elemento.
Si <índice de inserción> es igual al número de elementos de la array +1, el elemento se añade al final de la array (equivalente a <Array>.Add).
Se produce un error de WLanguage si <índice de inserción> es mayor que el número de elementos del array +1.
<Element value>: Cualquier tipo, opcional
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 una array asociativa Ocultar los detalles

<WLanguage array>.Insert(<Element key> , <Element value>)
<WLanguage array>: Array
Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional.
<Element key>: Tipo de clave en la asociación array
Valor de la clave para la que se insertará el elemento. En una array asociativa sin duplicado, se produce un error de WLanguage si el elemento ya existe.
<Element value>: Cualquier tipo
Elemento que debe añadirse a la array especificada.

Insertar un array en un array Ocultar los detalles

<WLanguage array>.Insert(<Insertion index> [, <Array to insert>])
<WLanguage array>: Array
Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional.
<Insertion index>: Integro
Índice donde se insertará el elemento en la array. A partir de este índice, todos los elementos se desplazarán en 1 elemento.
Si <índice de inserción> es igual al número de elementos de la array +1, el elemento se añade al final de la array (equivalente a <Array>.Add).
Se produce un error de WLanguage si <índice de inserción> es mayor que el número de elementos del array +1.
<Array to insert>: Array opcional
Nombre de la Array Variable a insertar en el índice de inserción especificado en <WLanguage array>.
WEBDEV - Código NavegadorPHP No disponible en código de navegador y en PHP

Insertar un elemento en una lista Ocultar los detalles

<WLanguage list>.Insert(<Insertion index> , <Element value>)
<WLanguage list>: jugarreta
Nombre de la Lista Variable a utilizar.
<Insertion index>: Constante de tipo Integer
Índice donde se insertará el elemento en la lista. Se pueden utilizar las siguientes constantes:
AfterCurrentElementEl elemento se inserta después del elemento de corriente.
Esta constante sólo está disponible para iterar sobre los elementos de la lista.
Atención: El elemento se leerá en la siguiente iteración en un bucle ascendente.
BeforeCurrentElementEl elemento se inserta antes del elemento de corriente.
Esta constante sólo está disponible para iterar sobre los elementos de la lista.
Atención: El elemento se leerá en la siguiente iteración en un bucle descendente.
FirstElementEl elemento se inserta al principio de la lista.
LastElementEl elemento se inserta al final de la lista.
<Element value>: Cualquier tipo
Elemento que se insertará en la lista en la posición especificada.
WEBDEV - Código NavegadorPHP No disponible en código de navegador y en PHP

Insertar una lista en una lista Ocultar los detalles

<WLanguage list>.Insert(<Insertion index> , <List to be inserted>)
<WLanguage list>: jugarreta
Nombre de la Lista Variable a utilizar.
<Insertion index>: Constante de tipo Integer
Índice en el que se insertará la lista. Se pueden utilizar las siguientes constantes:
AfterCurrentElementLa lista se inserta después del elemento actual.
Esta constante sólo está disponible para iterar sobre los elementos de la lista.
BeforeCurrentElementLa lista se inserta antes del elemento actual.
Esta constante sólo está disponible para iterar sobre los elementos de la lista.
FirstElementLa lista se inserta al principio de <Nombre de lista>.
LastElementLa lista se inserta al final de <Nombre de lista>.

<List to be inserted>: jugarreta
Nombre de la lista que se insertará en el índice de inserción especificado.
Observaciones

Insertar un elemento en una array

Cuando se llama a la función .Insert:
  • 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
Los elementos insertados mediante .Insert se insertan automáticamente entre los elementos existentes 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 .Insert:
  • 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 en el parámetro, el elemento se inicializa con el valor Default del tipo de los elementos array.

Insertar un elemento en una lista

Cuando se llama a la función .Insert:
  • 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 - Código NavegadorPHP Esta funcionalidad no está disponible.

Inserción de una tabla

Cuando se llama a la función .Insert:
  • 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 .Insert:
  • 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.
  • ambas listas deben ser del mismo tipo.
WEBDEV - Código NavegadorPHP 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 .Insert.
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 <Array>.Add.
  • Para agregar un elemento a un array ordenado (respetando el orden), utilice la función .AddSorted.
Componente: wd290vm.dll
Versión mínima requerida
  • Versión 23
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 02/02/2024

Señalar un error o enviar una sugerencia | Ayuda local