SpreadSheet representa la estructura de datos de una hoja de cálculo.

Las hojas cálculo pueden contener cualquier tipo de dato, pero solo valores de dicho tipo. Es decir, no se podrán tener hojas de cálculo heterogéneas que contengan valores Double o Bool a la vez. Para una representación más cercana al uso ordinario de las hojas de cálculo se recomienda mirar el módulo Cell.

La implementación interna de esta estructura de datos es mediante un diccionario (Map Strict) donde las claves son posiciones (Pos).

En este módulo se definen un conjunto de operaciones para la creación, consulta y modificación de hojas de cálculo.

Posición de una celda en la hoja de cálculo. Comienzan en (1,1).

Punto bidimensional en el que la primera coordenada corresponde a la columna y la segunda a la fila.

Ejemplo para localizar una celda:

Un rango está definido por dos posiciones, la superior izquierda y la inferior derecha.

Es utilizado en la generación de rangos con la función range.

Hoja de cálculo vacía.

>>> empty == fromList []
True

A partir de un solo valor, se genera la hoja que en la posición (1,1) tiene dicho valor.

>>> singleton True
Range (1,1) (1,1)
fromList [((1,1), True)]

Generar una hoja con un valor en una posición.

>>> singletonPos (1,5) True
Range (1,5) (1,5)
fromList [((1,5),True)]

De una lista de pares posición-valor se genera la hoja correspondiente. En el caso de tener posiciones repetidas, permanecerá la que tenga un índice mayor.

>>> fromList [((1,1), 0), ((1,2), 1), ((1,1), 5)]
Range (1,1) (1,2)
fromList [((1,1),5),((1,2),3)]

Transforma una hoja de cálculo a una lista que contiene sus valores.

>>> toListValues empty == []
True

La función toList aplicada a esta esctructura de datos utiliza esta función.

Transforma una hoja de cálculo a una lista que contiene sus valores junto a las posiciones en las que están.

Construcción de forma equivalente a fromList, salvo que se usa un diccionario de la librearía Map.

Destinado a construir la hoja de cálculo aprovechando las funciones optimizadas para diccionarios. Las precondiciones de las funciones de construcción de diccionarios no se comprueban, ya que forman parte de otro módulo.

>>> let cells = zipWith (,) [(x,y) | x <- [1..9], y <- [1..9]] [1..]
>>> Map.valid $ Map.fromAscList cells
True
>>> Map.valid $ Map.fromAscList (reverse cells)
False
>>> fromDict $ Map.fromAscList cells
Range (1,1) (9,9)
fromList [((1,1),1),((1,2),2),((1,3),3),((1,4),...

Obtiene el valor de una posición (Pos) de una hoja de cálculo.

Si la celda contiene un dato, devuelve el valor como (Just valor). Si no existe, devuelve Nothing.

>>> get (1,1) $ fromList [((1,1), "valor")]
Just "valor"

>>> get (2,2) $ fromList [((1,1), "valor")]
Nothing

Dando un rango y una hoja de cálculo, genera una hoja de cálculo con las celdas en dicho rango.

>>> let cells = zipWith (,) [(x,y) | x <- [1..9], y <- [1..9]] [1..]
>>> range (Range (8,7) (9,9)) $ fromList cells
Range (8,7) (9,9)
fromList [((8,7),70),((8,8),71),((8,9),72),((9,7),79),((9,8),80),((9,9),81)]

Selecciona las celdas con datos de una hoja de cálculo para una fila dada.

>>> let cells = zipWith (,) [(x,y) | x <- [1..5], y <- [1..5]] [1..]
>>> row 3 $ fromList cells
Range (1,3) (5,3)
fromList [((1,3),3),((2,3),8),((3,3),13),((4,3),18),((5,3),23)]

Selecciona las celdas con datos de una hoja de cálculo para una columna dada.

>>> let cells = zipWith (,) [(x,y) | x <- [1..5], y <- [1..5]] [1..]
>>> column 2 $ fromList cells
Range (2,1) (2,5)
fromList [((2,1),6),((2,2),7),((2,3),8),((2,4),9),((2,5),10)]

Genera una hoja de cálculo a partir de una dada según una función discriminante sobre las posiciónes.

En el siguiente ejemplo se eligen por ejemplo las celdas presentes en la diagonal.

>>> select (\(col,row) -> col == row) $ fromList [((1,1), "a"), ((2,1), "b"), ((1,2), "c"), ((2,2), "d")]
Range (1,1) (2,2)
fromList [((1,1),"a"),((2,2),"d")]

Inserta en una posición un valor. Este valor se puede generar según una función sobre una hoja de cálculo.

Esta función permite la composición de sucesivas inserciones.

>>> empty & put (1,1) (const True) & put (1,2) (const False)
Range (1,1) (1,2)
fromList [((1,1),True),((1,2),False)]

Combina dos hojas de cálculo. En el caso de que dos celdas contengan datos en cada una de las dos hojas, dejará el dato de la segunda.

También se puede usar el operador (<>) de la clase Semigroup.

Genera una hoja de cálculo nueva con la intersección de las celdas, dejando los valores de la primera hoja.

Operador para la intersección. Ver intersection.

La función mapMaybe está orientada a la selección de valores de un tipo que puedan ser transformados a otro. Tomando una hoja de cálculo se obtiene una nueva, con un tipo distinto, con solo aquellos valores que han podido ser extraidos.

Esta función tiene su ejemplo en el conjunto de funciónes extractDouble, extractString o extractDay del módulo Cell.

>>> let days = fromList [((1,1), "2018-12-23"), ((1,2),"-"), ((1,3),"2018-12-25")] :: SpreadSheet String
>>> let parseDay = (\x -> parseTimeM True defaultTimeLocale "%Y-%-m-%-d" x) :: String -> Maybe Day
>>> :t mapMaybe parseDay days
extract p days :: SpreadSheet Day
>>> mapMaybe parseDay days
Range (1,1) (1,3)
fromList [((1,1),2018-12-23),((1,3),2018-12-25)]

Indica el número de columnas que tiene una hoja de cálculo.

Indica el número de filas que tiene una hoja de cálculo.

Indica el rango en el que están contenidos los valores de la hoja de cálculo.

Enumera las columnas de la hoja de cálculo.

>>> columns empty
[]

>>> columns $ fromList [((5,3), True), ((10,6), True)]
[5,6,7,8,9,10]

Enumera las filas de la hoja de cálculo.

>>> rows empty
[]

>>> rows $ fromList [((5,3), True), ((10,6), True)]
[3,4,5,6]