#include "libpspp/hmap.h"
#include "output/table.h"
+struct ccase;
+struct dictionary;
struct pivot_value;
struct variable;
union value;
{
PIVOT_AXIS_LAYER,
PIVOT_AXIS_ROW,
- PIVOT_AXIS_COLUMN,
-
- PIVOT_N_AXES
+ PIVOT_AXIS_COLUMN
+#define PIVOT_N_AXES 3
};
const char *pivot_axis_type_to_string (enum pivot_axis_type);
void pivot_dimension_dump (const struct pivot_dimension *,
const struct pivot_table *, int indentation);
\f
+/* Split file handling with pivot tables.
+
+ When SPLIT FILE is in effect with the LAYERED option, values for the split
+ file variables need to be incorporated into pivot table output. These
+ functions make that easier.
+
+ To use them:
+
+ 1. After adding the rest of the dimensions to an output pivot table, call
+ pivot_splits_create(). If there are any and LAYERED mode is in use, then
+ pivot_splits_create() will add a dimension for each split file
+ variable and return a structure. Otherwise, it returns NULL.
+
+ 2. Before adding data to the pivot table for each SPLIT FILE group, call
+ pivot_splits_new_split(), passing in an example case from the group (the
+ first or last case is fine). This will the split file handler add
+ categories for the group to the split dimensions.
+
+ pivot_splits_new_split() does nothing if given a null pivot_splits, so
+ it's fine to call it unconditionally.
+
+ 3. Use pivot_splits_put*(), instead of pivot_table_put*(), to add data to
+ the pivot table. These functions automatically add the current group
+ leaf indexes after the indexes passed in, as a convenience.
+
+ These functions still work fine if given a null pivot_splits, so it's
+ fine to use them in all cases.
+
+ 4. Destroy the pivot_splits with pivot_splits_destroy() when the pivot table
+ has been fully constructed. */
+
+struct pivot_splits *pivot_splits_create (struct pivot_table *,
+ enum pivot_axis_type,
+ const struct dictionary *);
+void pivot_splits_destroy (struct pivot_splits *);
+
+void pivot_splits_new_split (struct pivot_splits *, const struct ccase *);
+
+void pivot_splits_put1 (struct pivot_splits *, struct pivot_table *,
+ size_t idx1, struct pivot_value *);
+void pivot_splits_put2 (struct pivot_splits *, struct pivot_table *,
+ size_t idx1, size_t idx2, struct pivot_value *);
+void pivot_splits_put3 (struct pivot_splits *, struct pivot_table *,
+ size_t idx1, size_t idx2, size_t idx3,
+ struct pivot_value *);
+void pivot_splits_put4 (struct pivot_splits *, struct pivot_table *,
+ size_t idx1, size_t idx2, size_t idx3, size_t idx4,
+ struct pivot_value *);
+\f
/* A pivot_category is a leaf (a category) or a group:
- For a leaf, neither index is SIZE_MAX.
void pivot_table_unref (struct pivot_table *);
bool pivot_table_is_shared (const struct pivot_table *);
+/* Titles. */
+void pivot_table_set_title (struct pivot_table *, struct pivot_value *);
+void pivot_table_set_subtype (struct pivot_table *, struct pivot_value *);
+void pivot_table_set_corner_text (struct pivot_table *, struct pivot_value *);
+void pivot_table_set_caption (struct pivot_table *, struct pivot_value *);
+
/* Axes. */
void pivot_table_swap_axes (struct pivot_table *,
enum pivot_axis_type, enum pivot_axis_type);
*/
struct pivot_value
{
- struct font_style *font_style;
- struct cell_style *cell_style;
-
- char **subscripts;
- size_t n_subscripts;
-
- size_t *footnote_indexes;
- size_t n_footnotes;
-
+ struct pivot_value_ex *ex;
union
{
enum pivot_value_type type;
/* Values from variable names. */
struct pivot_value *pivot_value_new_variable (const struct variable *);
+struct pivot_value *pivot_value_new_variable__ (const char *name,
+ const char *label);
/* Values from text strings. */
struct pivot_value *pivot_value_new_text (const char *);
void pivot_argument_copy (struct pivot_argument *,
const struct pivot_argument *);
\f
+/* Extra styling for a pivot_value.
+
+ This is logically part of pivot_value itself. It is broken into a separate
+ structure to save memory because it is rarely used. */
+struct pivot_value_ex
+ {
+ struct font_style *font_style;
+ struct cell_style *cell_style;
+
+ char **subscripts;
+ size_t n_subscripts;
+
+ size_t *footnote_indexes;
+ size_t n_footnotes;
+ };
+
+static inline const struct pivot_value_ex *
+pivot_value_ex (const struct pivot_value *value)
+{
+ static const struct pivot_value_ex empty_ex = { .font_style = NULL };
+ return value->ex ? value->ex : &empty_ex;
+}
+
+struct pivot_value_ex *pivot_value_ex_rw (struct pivot_value *);
+struct pivot_value_ex *pivot_value_ex_clone (const struct pivot_value_ex *);
+void pivot_value_ex_destroy (struct pivot_value_ex *);
+\f
/* One piece of data within a pivot table. */
struct pivot_cell
{
projects / pspp / blobdiff