X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=src%2Fdata%2Fdictionary.h;h=47317a22cbc23e61a56de8602b09123daea92499;hb=24cbabb1547682037cda854b46c2e4bdf87a2c8a;hp=4efb953c550fae754c62c96098bb8e8a51995b80;hpb=9e0e4996fad6563f0a1ce628b80db5c23ef8279e;p=pspp diff --git a/src/data/dictionary.h b/src/data/dictionary.h index 4efb953c55..47317a22cb 100644 --- a/src/data/dictionary.h +++ b/src/data/dictionary.h @@ -1,5 +1,5 @@ /* PSPP - a program for statistical analysis. - Copyright (C) 2004, 2007 Free Software Foundation, Inc. + Copyright (C) 2004, 2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -19,36 +19,36 @@ #include #include -#include -#include +#include "data/case.h" +#include "data/dict-class.h" struct string; struct ccase; /* Creating dictionaries. */ -struct dictionary *dict_create (void); -struct dictionary *dict_clone (const struct dictionary *); +struct dictionary *dict_create (const char *encoding); +struct dictionary *dict_clone (const struct dictionary *) WARN_UNUSED_RESULT; +struct dictionary *dict_ref (struct dictionary *s) WARN_UNUSED_RESULT; /* Clearing and destroying dictionaries. */ void dict_clear (struct dictionary *); -void dict_clear_aux (struct dictionary *); -void dict_destroy (struct dictionary *); +void dict_unref (struct dictionary *); /* Common ways to access variables. */ struct variable *dict_lookup_var (const struct dictionary *, const char *); struct variable *dict_lookup_var_assert (const struct dictionary *, const char *); struct variable *dict_get_var (const struct dictionary *, size_t position); -size_t dict_get_var_cnt (const struct dictionary *); +size_t dict_get_n_vars (const struct dictionary *); /* Other access to variables. */ bool dict_contains_var (const struct dictionary *, const struct variable *); void dict_get_vars (const struct dictionary *, - const struct variable ***vars, size_t *cnt, + const struct variable ***vars, size_t *n_vars, enum dict_class exclude); void dict_get_vars_mutable (const struct dictionary *, - struct variable ***vars, size_t *cnt, + struct variable ***vars, size_t *n_vars, enum dict_class exclude); /* Creating variables. */ @@ -56,10 +56,17 @@ struct variable *dict_create_var (struct dictionary *, const char *, int width); struct variable *dict_create_var_assert (struct dictionary *, const char *, int width); -struct variable *dict_clone_var (struct dictionary *, const struct variable *, - const char *); +struct variable *dict_clone_var (struct dictionary *, const struct variable *); struct variable *dict_clone_var_assert (struct dictionary *, - const struct variable *, const char *); + const struct variable *); +struct variable *dict_clone_var_as (struct dictionary *, + const struct variable *, const char *); +struct variable *dict_clone_var_as_assert (struct dictionary *, + const struct variable *, + const char *); + +struct variable *dict_clone_var_in_place_assert (struct dictionary *, + const struct variable *); /* Deleting variables. */ void dict_delete_var (struct dictionary *, struct variable *); @@ -76,19 +83,24 @@ void dict_reorder_vars (struct dictionary *, struct variable *const *, size_t count); /* Variable names. */ +bool dict_try_rename_var (struct dictionary *, + struct variable *, const char *); void dict_rename_var (struct dictionary *, struct variable *, const char *); bool dict_rename_vars (struct dictionary *, struct variable **, char **new_names, size_t count, char **err_name); -bool dict_make_unique_var_name (const struct dictionary *, const char *hint, - unsigned long int *num_start, - char name[]); +char *dict_make_unique_var_name (const struct dictionary *, const char *hint, + unsigned long int *num_start); + +bool dict_get_names_must_be_ids (const struct dictionary *); +void dict_set_names_must_be_ids (struct dictionary *, bool); /* Weight variable. */ double dict_get_case_weight (const struct dictionary *, const struct ccase *, bool *); struct variable *dict_get_weight (const struct dictionary *); void dict_set_weight (struct dictionary *, struct variable *); +const struct fmt_spec *dict_get_weight_format (const struct dictionary *); /* Filter variable. */ struct variable *dict_get_filter (const struct dictionary *); @@ -99,6 +111,7 @@ casenumber dict_get_case_limit (const struct dictionary *); void dict_set_case_limit (struct dictionary *, casenumber); /* Size of cases for this dictionary. */ +const struct caseproto *dict_get_proto (const struct dictionary *); int dict_get_next_value_idx (const struct dictionary *); size_t dict_get_case_size (const struct dictionary *); @@ -107,13 +120,26 @@ size_t dict_get_case_size (const struct dictionary *); size_t dict_count_values (const struct dictionary *, unsigned int exclude_classes); void dict_compact_values (struct dictionary *); - -/* SPLIT FILE variables. */ +struct caseproto *dict_get_compacted_proto (const struct dictionary *, + unsigned int exclude_classes); + +/* SPLIT FILE variables. + + SPLIT_NONE is used if and only if there are no split file variables. */ +enum split_type + { + SPLIT_NONE, /* No split file variables. */ + SPLIT_SEPARATE, /* Produce separate output for each split. */ + SPLIT_LAYERED, /* Output splits in same table. */ + }; +#define MAX_SPLITS 8 const struct variable *const *dict_get_split_vars (const struct dictionary *); -size_t dict_get_split_cnt (const struct dictionary *); +size_t dict_get_n_splits (const struct dictionary *); +enum split_type dict_get_split_type (const struct dictionary *); void dict_set_split_vars (struct dictionary *, - struct variable *const *, size_t cnt); -void dict_unset_split_var (struct dictionary *, struct variable *); + struct variable *const *, size_t n, + enum split_type); +void dict_clear_split_vars (struct dictionary *); /* File label. */ const char *dict_get_label (const struct dictionary *); @@ -122,47 +148,62 @@ void dict_set_label (struct dictionary *, const char *); /* Documents. */ #define DOC_LINE_LENGTH 80 /* Fixed length of document lines. */ -const char *dict_get_documents (const struct dictionary *); -void dict_set_documents (struct dictionary *, const char *); +const struct string_array *dict_get_documents (const struct dictionary *); +void dict_set_documents (struct dictionary *, const struct string_array *); +void dict_set_documents_string (struct dictionary *, const char *); void dict_clear_documents (struct dictionary *); -void dict_add_document_line (struct dictionary *, const char *); -size_t dict_get_document_line_cnt (const struct dictionary *); -void dict_get_document_line (const struct dictionary *, - size_t, struct string *); +bool dict_add_document_line (struct dictionary *, const char *, + bool issue_warning); +size_t dict_get_document_n_lines (const struct dictionary *); +const char *dict_get_document_line (const struct dictionary *, size_t); /* Vectors. */ bool dict_create_vector (struct dictionary *, const char *name, - struct variable **, size_t cnt); + struct variable **, size_t n); void dict_create_vector_assert (struct dictionary *, const char *name, - struct variable **, size_t cnt); + struct variable **, size_t n); const struct vector *dict_get_vector (const struct dictionary *, size_t idx); -size_t dict_get_vector_cnt (const struct dictionary *); +size_t dict_get_n_vectors (const struct dictionary *); const struct vector *dict_lookup_vector (const struct dictionary *, const char *name); void dict_clear_vectors (struct dictionary *); +/* Multiple response sets. */ +const struct mrset *dict_get_mrset (const struct dictionary *, size_t idx); +size_t dict_get_n_mrsets (const struct dictionary *); +const struct mrset *dict_lookup_mrset (const struct dictionary *, + const char *name); + +bool dict_add_mrset (struct dictionary *, struct mrset *); +bool dict_delete_mrset (struct dictionary *, const char *name); +void dict_clear_mrsets (struct dictionary *); + /* Attributes. */ struct attrset *dict_get_attributes (const struct dictionary *); void dict_set_attributes (struct dictionary *, const struct attrset *); bool dict_has_attributes (const struct dictionary *); - -void dict_set_encoding (struct dictionary *d, const char *enc); +/* Data encoding. */ const char *dict_get_encoding (const struct dictionary *d); +bool dict_id_is_valid (const struct dictionary *, const char *id, + bool issue_error); + +/* Internal variables. */ +struct variable *dict_create_internal_var (int case_idx, int width); +void dict_destroy_internal_var (struct variable *); /* Functions to be called upon dictionary changes. */ struct dict_callbacks { void (*var_added) (struct dictionary *, int, void *); - void (*var_deleted) (struct dictionary *, int, int, int, void *); - void (*var_changed) (struct dictionary *, int, void *); - void (*var_resized) (struct dictionary *, int, int, void *); + void (*var_deleted) (struct dictionary *, const struct variable *, + int dict_index, int case_index, void *); + void (*var_changed) (struct dictionary *, int, unsigned int, const struct variable *, void *); void (*weight_changed) (struct dictionary *, int, void *); void (*filter_changed) (struct dictionary *, int, void *); void (*split_changed) (struct dictionary *, void *); - void (*var_display_width_changed) (struct dictionary *, int, void *); }; void dict_set_callbacks (struct dictionary *, const struct dict_callbacks *,