Skip to content

array_functions

shortfx.fxVBA.array_functions

VBA Array Manipulation Functions Module.

Description Funciones para manipulación de arrays compatibles con VBA. Incluye Split, Join, Filter, LBound, UBound y Array.

Functions

Array_(*values: Any) -> List[Any]

Description Crea array (lista) con valores proporcionados.

Args *values: Valores para incluir en array.

Returns List[Any]: Array con los valores.

Usage Example >>> array_(1, 2, 3, 4, 5) [1, 2, 3, 4, 5] >>> array_("rojo", "verde", "azul") ['rojo', 'verde', 'azul']

Cost O(n) donde n es número de valores

Source code in shortfx/fxVBA/array_functions.py 
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
def Array_(*values: Any) -> List[Any]:
    """
    Description
        Crea array (lista) con valores proporcionados.

    Args
        *values: Valores para incluir en array.

    Returns
        List[Any]: Array con los valores.

    Usage Example
        >>> array_(1, 2, 3, 4, 5)
        [1, 2, 3, 4, 5]
        >>> array_("rojo", "verde", "azul")
        ['rojo', 'verde', 'azul']

    Cost
        O(n) donde n es número de valores
    """
    return list(values)

Filter_(source_array: List[Any], match: str, include: bool = True, compare: int = 0) -> List[Any]

Description Filtra elementos de array que contienen (o no) cadena específica.

Args source_array: Array fuente. match: Cadena a buscar. include: True para incluir coincidencias, False para excluir. compare: Tipo de comparación (0=binaria, 1=texto/case-insensitive).

Returns List[Any]: Array filtrado.

Usage Example >>> filter_(["apple", "banana", "apricot"], "ap") ['apple', 'apricot'] >>> filter_(["apple", "banana", "apricot"], "ap", False) ['banana']

Cost O(n*m) donde n es tamaño array, m longitud de match

Source code in shortfx/fxVBA/array_functions.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
def Filter_(
    source_array: List[Any],
    match: str,
    include: bool = True,
    compare: int = 0
) -> List[Any]:
    """
    Description
        Filtra elementos de array que contienen (o no) cadena específica.

    Args
        source_array: Array fuente.
        match: Cadena a buscar.
        include: True para incluir coincidencias, False para excluir.
        compare: Tipo de comparación (0=binaria, 1=texto/case-insensitive).

    Returns
        List[Any]: Array filtrado.

    Usage Example
        >>> filter_(["apple", "banana", "apricot"], "ap")
        ['apple', 'apricot']
        >>> filter_(["apple", "banana", "apricot"], "ap", False)
        ['banana']

    Cost
        O(n*m) donde n es tamaño array, m longitud de match
    """
    if not source_array:
        return []

    result = []
    case_sensitive = (compare == 0)

    for item in source_array:
        item_str = str(item)
        match_str = match

        if not case_sensitive:
            item_str = item_str.lower()
            match_str = match_str.lower()

        contains_match = match_str in item_str

        if (include and contains_match) or (not include and not contains_match):
            result.append(item)

    return result

Join_(source_array: List[Any], delimiter: str = ' ') -> str

Description Une elementos de array en string usando delimitador.

Args source_array: Array de elementos a unir. delimiter: Delimitador entre elementos (por defecto espacio).

Returns str: String resultante de unir elementos.

Usage Example >>> join_(["uno", "dos", "tres"], ",") 'uno,dos,tres' >>> join_([1, 2, 3], "-") '1-2-3'

Cost O(n) donde n es número de elementos

Source code in shortfx/fxVBA/array_functions.py 
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
def Join_(
    source_array: List[Any],
    delimiter: str = " "
) -> str:
    """
    Description
        Une elementos de array en string usando delimitador.

    Args
        source_array: Array de elementos a unir.
        delimiter: Delimitador entre elementos (por defecto espacio).

    Returns
        str: String resultante de unir elementos.

    Usage Example
        >>> join_(["uno", "dos", "tres"], ",")
        'uno,dos,tres'
        >>> join_([1, 2, 3], "-")
        '1-2-3'

    Cost
        O(n) donde n es número de elementos
    """
    if not source_array:
        return ""

    return delimiter.join(str(item) for item in source_array)

LBound(array_var: List[Any], dimension: int = 1) -> int

Description Retorna índice inferior (mínimo) de array en dimensión especificada.

Args array_var: Array. dimension: Dimensión (1-based, por defecto 1).

Returns int: Índice inferior (siempre 0 en Python).

Usage Example >>> lbound([1, 2, 3, 4, 5]) 0 >>> lbound(["a", "b", "c"]) 0

Cost O(1)

Source code in shortfx/fxVBA/array_functions.py 
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
def LBound(array_var: List[Any], dimension: int = 1) -> int:
    """
    Description
        Retorna índice inferior (mínimo) de array en dimensión especificada.

    Args
        array_var: Array.
        dimension: Dimensión (1-based, por defecto 1).

    Returns
        int: Índice inferior (siempre 0 en Python).

    Usage Example
        >>> lbound([1, 2, 3, 4, 5])
        0
        >>> lbound(["a", "b", "c"])
        0

    Cost
        O(1)
    """
    if not array_var:
        raise ValueError("Array vacío")

    # En VBA los arrays pueden empezar en diferentes índices
    # En Python siempre empiezan en 0
    return 0

Split(expression: str, delimiter: str = ' ', limit: int = -1, compare: int = 0) -> List[str]

Description Divide cadena en array de subcadenas usando delimitador.

Args expression: Cadena a dividir. delimiter: Delimitador (por defecto espacio). limit: Máximo número de subcadenas (-1 = todas). compare: Tipo de comparación (0=binaria, 1=texto).

Returns List[str]: Array de subcadenas.

Usage Example >>> split("uno,dos,tres", ",") ['uno', 'dos', 'tres'] >>> split("a b c d", " ", 2) ['a', 'b c d']

Cost O(n) donde n es longitud de expression

Source code in shortfx/fxVBA/array_functions.py 
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
def Split(
    expression: str,
    delimiter: str = " ",
    limit: int = -1,
    compare: int = 0
) -> List[str]:
    """
    Description
        Divide cadena en array de subcadenas usando delimitador.

    Args
        expression: Cadena a dividir.
        delimiter: Delimitador (por defecto espacio).
        limit: Máximo número de subcadenas (-1 = todas).
        compare: Tipo de comparación (0=binaria, 1=texto).

    Returns
        List[str]: Array de subcadenas.

    Usage Example
        >>> split("uno,dos,tres", ",")
        ['uno', 'dos', 'tres']
        >>> split("a b c d", " ", 2)
        ['a', 'b c d']

    Cost
        O(n) donde n es longitud de expression
    """
    if not expression:
        return []

    if limit == -1:
        return expression.split(delimiter)
    else:
        # Python split con maxsplit genera limit+1 elementos
        return expression.split(delimiter, limit - 1)

UBound(array_var: List[Any], dimension: int = 1) -> int

Description Retorna índice superior (máximo) de array en dimensión especificada.

Args array_var: Array. dimension: Dimensión (1-based, por defecto 1).

Returns int: Índice superior (length - 1 en Python).

Usage Example >>> ubound([1, 2, 3, 4, 5]) 4 >>> ubound(["a", "b", "c"]) 2

Cost O(1)

Source code in shortfx/fxVBA/array_functions.py 
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
def UBound(array_var: List[Any], dimension: int = 1) -> int:
    """
    Description
        Retorna índice superior (máximo) de array en dimensión especificada.

    Args
        array_var: Array.
        dimension: Dimensión (1-based, por defecto 1).

    Returns
        int: Índice superior (length - 1 en Python).

    Usage Example
        >>> ubound([1, 2, 3, 4, 5])
        4
        >>> ubound(["a", "b", "c"])
        2

    Cost
        O(1)
    """
    if not array_var:
        raise ValueError("Array vacío")

    return len(array_var) - 1