|
|
|
|
Busca el índice de un elemento en un WLanguage array. Se pueden realizar las siguientes búsquedas: - Busca un elemento en una array unidimensional de elementos simples.
- Busca un elemento en una array bidimensional de elementos simples según una columna.
- Busca un elemento en una array bidimensional de elementos simples según varias columnas.
- Busca un elemento en una array unidimensional de estructuras o clases.
- Busca un objeto en un array.
Observaciones: - Esta función es equivalente a la función Buscar.
arrMyArray is array of 0 string // Fill the array ArrayAdd(arrMyArray, "WINDEV") ArrayAdd(arrMyArray, "WEBDEV") ArrayAdd(arrMyArray, "WINDEV and WEBDEV") // Find "WINDEV" ResIndex is int ResIndex = ArraySeek(arrMyArray, asLinearFirst, "WINDEV") Info("The WINDEV string is found at index: " + ResIndex) // Returns: "The WINDEV string is found at index: 1"
Sintaxis
Buscando un elemento en una array unidimensional de elementos simples Ocultar los detalles
<Result> = ArraySeek(<WLanguage array> , <Type of search> , <Sought value> [, <Start index>])
<Result>: Integro - Índice del elemento buscado,
- -1 si el elemento no se encuentra en la array.
<WLanguage array>: Array Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional. Esta array también puede corresponder a una array unidimensional asociada a una Property de avanzada Variable. <Type of search>: Constante de tipo Integer Tipo de búsqueda a realizar: | | asBinary | Búsqueda binaria. Este modo de búsqueda es rápido pero debe utilizarse en una array ordenada de forma ascendente, sin duplicados. Las opciones de búsqueda (orden lexicográfico, ignorar la puntuación, etc.) deben ser exactamente las mismas para la búsqueda (ArraySeek) y para la ordenación (ArraySort). | asLinear | Búsqueda lineal. Comienza la búsqueda:- del primer elemento.
- a partir del valor del parámetro <índice de inicio>.
La búsqueda se detiene en cuanto se encuentra un elemento. | asLinearFirst | Búsqueda lineal desde el primer elemento. <Índice de inicio> se ignora cuando se especifica esta constante. | asLinearLast | Búsqueda lineal desde el último elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearNext | Búsqueda lineal del siguiente elemento. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. | asLinearPrevious | Búsqueda lineal del elemento anterior. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. |
El tipo de búsqueda se puede combinar con una o más opciones de búsqueda:
| | tccIgnoreAccent | Buscar ignorando los caracteres acentuados. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccIgnoreCase | Buscar ignorando el caso. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccIgnoreInsideSpace | Buscar ignorando los espacios dentro de las cadenas. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccIgnorePonctuationAndSpace | Buscar ignorando los espacios y la puntuación. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccIgnoreSpace | Buscar ignorando los espacios al principio y al final de las cadenas. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccLexicographicOrder | Array ordenada según el orden lingüístico. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccRespectNumeric | Array ordenada según el orden de los valores numéricos. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
|
Para una búsqueda dicotómica, las opciones de búsqueda deben ser exactamente las mismas que se utilizaron para ordenar el array (véase ArraySort). <Sought value>: Cualquier tipo Valor del elemento cuyo índice se solicita. <Start index>: Entero opcional Posición de inicio de la búsqueda (sólo búsqueda lineal). Este parámetro no es necesario para una búsqueda binaria.
Búsqueda de un elemento en una array bidimensional de elementos simples mediante una columna Ocultar los detalles
<Result> = ArraySeek(<WLanguage array> , <Type of search> , <Column> , <Sought value> [, <Start index>])
<Result>: Integro - Índice del elemento buscado,
- -1 si el elemento no se encuentra en la array.
<WLanguage array>: Array Nombre de la variable de tipo Array a utilizar. Este array debe ser bidimensional.Este array también puede corresponder a un array bidimensional asociado a un Property de un Variable avanzado (por ejemplo ordenando un Variable de tipo xlsDocument según los valores de una columna). <Type of search>: Constante de tipo Integer Buscar para realizar: | | asBinary | Búsqueda binaria. Este modo de búsqueda es rápido, pero debe utilizarse sobre una array ordenada de forma ascendente, sin duplicados, y utilizando exactamente las mismas opciones de búsqueda que las utilizadas para la ordenación (ArraySort). | asLinear | Búsqueda lineal. Comienza la búsqueda:- del primer elemento.
- a partir del valor del parámetro <índice de inicio>.
La búsqueda se detiene en cuanto se encuentra un elemento. | asLinearFirst | Búsqueda lineal desde el primer elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearLast | Búsqueda lineal desde el último elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearNext | Búsqueda lineal del siguiente elemento. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. | asLinearPrevious | Búsqueda lineal del elemento anterior. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. |
El tipo de búsqueda se puede combinar con una o más opciones de búsqueda: | | tccIgnoreAccent | Buscar ignorando los caracteres acentuados. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccIgnoreCase | Buscar ignorando el caso. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccIgnoreInsideSpace | Buscar ignorando los espacios dentro de las cadenas. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccIgnorePonctuationAndSpace | Buscar ignorando los espacios y la puntuación. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccIgnoreSpace | Buscar ignorando los espacios al principio y al final de las cadenas. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres. | tccLexicographicOrder | Array ordenada según el orden lingüístico. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
| tccRespectNumeric | Array ordenada según el orden de los valores numéricos. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción sólo se puede utilizar en la arrays de los strings de caracteres.
|
Para una búsqueda dicotómica, las opciones de búsqueda deben ser exactamente las mismas que se utilizaron para ordenar el array (véase ArraySort). <Column>: Entero o cadena de caracteres - Simple array: Índice de la columna donde se realizará la búsqueda.
- array avanzada: Property para la cual se debe realizar la búsqueda. También tienes la capacidad de usar propiedades encadenadas ("Border.Color" por ejemplo).
<Sought value>: Cualquier tipo Valor del elemento cuyo índice o Property se solicita. <Start index>: Entero opcional Posición de inicio de la búsqueda (sólo búsqueda lineal). Este parámetro no es necesario para una búsqueda binaria.
Búsqueda de un elemento en una array bidimensional de elementos simples mediante varias columnas Ocultar los detalles
<Result> = ArraySeek(<WLanguage array> , <Type of search> , <Columns> , <Sought value 1> [, <Sought value 2> [... [, <Sought value N>]]] [, <Start index>])
<Result>: Integro - Índice del elemento buscado,
- -1 si el elemento no se encuentra en la array.
<WLanguage array>: Array Nombre de la variable de tipo Array a utilizar. Este array debe ser bidimensional.
Este array también puede corresponder a un array bidimensional de tipo avanzado (ordenación realizada sobre un Variable de tipo xlsDocument según los valores de una o varias columnas, por ejemplo). <Type of search>: Constante de tipo Integer Buscar para realizar. No hay búsqueda binaria disponible. | | asLinear | Búsqueda lineal. Comienza la búsqueda:- del primer elemento.
- a partir del valor del parámetro <índice de inicio>.
La búsqueda se detiene en cuanto se encuentra un elemento. | asLinearFirst | Búsqueda lineal desde el primer elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearLast | Búsqueda lineal desde el último elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearNext | Búsqueda lineal del siguiente elemento. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. | asLinearPrevious | Búsqueda lineal del elemento anterior. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. | El tipo de búsqueda se puede combinar con una o más opciones de búsqueda: | | tccIgnoreAccent | Buscar ignorando los caracteres acentuados. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para arrays de cadenas.
| tccIgnoreCase | Buscar ignorando el caso. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para el arrays de las cadenas de caracteres. | tccIgnoreInsideSpace | Buscar ignorando los espacios dentro de las cadenas. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para el arrays de las cadenas de caracteres. | tccIgnorePonctuationAndSpace | Buscar ignorando los espacios y la puntuación. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para arrays de cadenas.
| tccIgnoreSpace | Buscar ignorando los espacios al principio y al final de las cadenas. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para el arrays de las cadenas de caracteres. | tccLexicographicOrder | Array ordenada según el orden lingüístico. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para arrays de cadenas.
| tccRespectNumeric | Array ordenada según el orden de los valores numéricos. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción se aplica a todas las columnas en las que se realiza la búsqueda. Esta opción es useful para arrays de cadenas.
|
Para una búsqueda dicotómica, las opciones de búsqueda deben ser exactamente las mismas que se utilizaron para ordenar la array (véase ArraySort). <Columns>: Cadena de caracteres - Array simple: Lista de columnas donde se debe realizar la búsqueda. Las diferentes columnas deben estar separadas por punto y coma. Ejemplo: "2;3" para realizar una búsqueda en las columnas 2 y 3.
- Array avanzado: Lista de propiedades donde se debe realizar la búsqueda. Las propiedades deben estar separadas por punto y coma.
<Sought value 1>: Cualquier tipo Valor del elemento cuyo índice o Property se solicita. Se debe indicar un valor para cada columna o Property especificada en <Columnas <Sought value 2>: Cualquier tipo opcional Valor del elemento cuyo índice o Property se solicita. Se debe indicar un valor para cada columna o Property especificada en <Columnas <Sought value N>: Cualquier tipo opcional Valor del elemento cuyo índice o Property se solicita. Se debe indicar un valor para cada columna o Property especificada en <Columnas <Start index>: Entero opcional Posición de inicio de la búsqueda (sólo búsqueda lineal). Este parámetro no es necesario para una búsqueda binaria.
Busca un elemento en una array unidimensional de estructuras, clases, tipos avanzados o registros. Ocultar los detalles
<Result> = ArraySeek(<WLanguage array> , <Type of search> , <Sought members> [, <Sought value 1> [, <Sought value 2> [... [, <Sought value N>]]]] [, <Start index>])
<Result>: Integro - Índice del elemento buscado,
- -1 si el elemento no se encuentra en la array.
<WLanguage array>: Array Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional. Esta array puede ser: - una array de clases,
- una array de estructuras,
- una array de tipos avanzados,
<Type of search>: Constante de tipo Integer Tipo de búsqueda a realizar:
| | asBinary | Búsqueda binaria. Este modo de búsqueda es rápido, pero debe utilizarse sobre una array ordenada de forma ascendente, sin duplicados, y utilizando exactamente las mismas opciones de búsqueda que las utilizadas para la ordenación (ArraySort). Este modo de búsqueda también se puede utilizar cuando se realiza una búsqueda en un único miembro. | asLinear | Búsqueda lineal. Comienza la búsqueda:- del primer elemento.
- a partir del valor del parámetro <índice de inicio>.
La búsqueda se detiene en cuanto se encuentra un elemento. | asLinearFirst | Búsqueda lineal desde el primer elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearLast | Búsqueda lineal desde el último elemento. Esta constante no debe utilizarse si se especifica <índice de inicio>. | asLinearNext | Búsqueda lineal del siguiente elemento. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. | asLinearPrevious | Búsqueda lineal del elemento anterior. Esta búsqueda se realiza a partir de la posición actual o del valor de <índice inicial>. |
El tipo de búsqueda se puede combinar con una o más opciones de búsqueda: | | tccIgnoreAccent | Buscar ignorando los caracteres acentuados. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres"..
| tccIgnoreCase | Buscar ignorando el caso. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres". | tccIgnoreInsideSpace | Buscar ignorando los espacios dentro de las cadenas. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres". | tccIgnorePonctuationAndSpace | Buscar ignorando los espacios y la puntuación. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres"..
| tccIgnoreSpace | Buscar ignorando los espacios al principio y al final de las cadenas. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres". | tccLexicographicOrder | Array ordenada según el orden lingüístico. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres"..
| tccRespectNumeric | Array ordenada según el orden de los valores numéricos. Esta opción es useful para una búsqueda dicotómica y no tiene efecto en una búsqueda lineal. Esta opción se aplica a todos los miembros en los que se realiza la búsqueda. Esta opción es useful para los miembros de la "cadena de caracteres"..
|
Para una búsqueda dicotómica, las opciones de búsqueda deben ser exactamente las mismas que se utilizaron para ordenar el array (véase ArraySort). <Sought members>: Cadena de caracteres - Estructuras y clases: Nombre de los miembros buscados. Si se buscan varios miembros, sus nombres deberán ir separados por punto y coma.. También tiene la capacidad de encadenar a los miembros buscados (usando "." o ":" entre los miembros).. En una clase, también tiene la posibilidad de realizar una búsqueda en las propiedades de la clase.
- Tipos avanzados: Nombre de las propiedades buscadas. Si se buscan varias propiedades, sus nombres deberán ir separados por punto y coma.. También tiene la capacidad de encadenar las propiedades buscadas (usando "." o ":" entre las propiedades). Por ejemplo, "Border.Color".
- Registros: Nombre de los artículos buscados. En caso de que se busquen varios elementos, sus nombres deberán ir separados por punto y coma.. También puede encadenar los elementos buscados (utilizando "." o ":" entre las propiedades).
<Sought value 1>: Cualquier tipo Valor del elemento cuyo miembro o Property se solicita. Se debe indicar un valor para cada miembro especificado en <Socios buscados>. <Sought value 2>: Cualquier tipo opcional Valor del elemento cuyo miembro o Property se solicita. Se debe indicar un valor para cada miembro especificado en <Socios buscados>. <Sought value N>: Cualquier tipo opcional Valor del elemento cuyo miembro o Property se solicita. Se debe indicar un valor para cada miembro especificado en <Socios buscados>. <Start index>: Entero opcional Posición de inicio de la búsqueda (sólo búsqueda lineal). Este parámetro no es necesario para una búsqueda binaria.
Búsqueda del índice de un objeto en una array unidimensional (sintaxis para el enlace de datos) Ocultar los detalles
<Result> = ArraySeek(<WLanguage array> , <Type of search> , <Sought object>)
<Result>: Integro - Índice del objeto buscado,
- -1 si el objeto no se encuentra en la array.
<WLanguage array>: Array Nombre de la variable de tipo Array a utilizar. Este array debe ser unidimensional. Esta array puede ser una array de clases, clases dinámicas, estructuras, estructuras dinámicas, tipos avanzados, tipos avanzados dinámicos. <Type of search>: Constante de tipo Integer Tipo de búsqueda a realizar:
<Sought object>: Cualquier tipo Instancia del objeto buscado. Observaciones Casos especiales - Esta función no se puede utilizar en la arrays fija.
- Esta función se puede utilizar en la arrays de variables avanzadas.
- Esta función no se puede utilizar en la array de "Objetos dinámicos".. Se debe especificar el tipo de los objetos.
- Esta función debe utilizarse en arrays de objetos tipados.
- Por ejemplo, no se puede realizar ninguna búsqueda en los siguientes array:
t is array of 2 objects dynamic
- Por el contrario, se puede realizar una búsqueda en los siguientes array:
t is array of 2 MyClass dynamic
- No se puede realizar ninguna búsqueda en una array de variantes.
- Si el tipo de búsqueda es dicotómico y si el array no está clasificado, no se mostrará ningún error de WLanguage pero el resultado de la búsqueda será indefinido.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|