X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=src%2Fdata%2Fformat.h;h=7df374453def01b5392c2149c57bb203f2723d0e;hb=4e8257086ffc71bc5a1785fd86610921be677887;hp=10ae543ead88d96bb41147f5fe153852341289f1;hpb=b64685d06f8db1aff292ec409abe25f8a483d775;p=pspp-builds.git diff --git a/src/data/format.h b/src/data/format.h index 10ae543e..7df37445 100644 --- a/src/data/format.h +++ b/src/data/format.h @@ -1,130 +1,178 @@ -/* PSPP - computes sample statistics. - Copyright (C) 1997-9, 2000 Free Software Foundation, Inc. - Written by Ben Pfaff . +/* PSPP - a program for statistical analysis. + Copyright (C) 1997-9, 2000, 2006, 2010, 2011 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 the Free Software Foundation; either version 2 of the - License, or (at your option) any later version. + 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 + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. - This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - 02110-1301, USA. */ + along with this program. If not, see . */ -#if !format_h -#define format_h 1 +#ifndef DATA_FORMAT_H +#define DATA_FORMAT_H 1 /* Display format types. */ #include +#include +#include -/* See the definitions of these functions and variables when modifying - this list: - misc.c:convert_fmt_ItoO() - sys-file-reader.c:parse_format_spec() - data-in.c:parse_string_as_format() */ -#define DEFFMT(LABEL, NAME, N_ARGS, IMIN_W, IMAX_W, OMIN_W, OMAX_W, \ - CAT, OUTPUT, SPSS_FMT) \ - LABEL, -enum - { -#include "format.def" - FMT_NUMBER_OF_FORMATS - }; -#undef DEFFMT +/* Format type categories. -/* Describes one of the display formats above. */ -struct fmt_desc + Each format is in exactly one category. We give categories + bitwise disjoint values only to enable bitwise comparisons + against a mask of FMT_CAT_* values, not to allow multiple + categories per format. */ +enum fmt_category { - char name[9]; /* `DATETIME' is the longest name. */ - int n_args; /* 1=width; 2=width.decimals. */ - int Imin_w, Imax_w; /* Bounds on input width. */ - int Omin_w, Omax_w; /* Bounds on output width. */ - int cat; /* Categories. */ - int output; /* Output format. */ - int spss; /* Equivalent SPSS output format. */ + /* Numeric formats. */ + FMT_CAT_BASIC = 0x001, /* Basic numeric formats. */ + FMT_CAT_CUSTOM = 0x002, /* Custom currency formats. */ + FMT_CAT_LEGACY = 0x004, /* Legacy numeric formats. */ + FMT_CAT_BINARY = 0x008, /* Binary formats. */ + FMT_CAT_HEXADECIMAL = 0x010, /* Hexadecimal formats. */ + FMT_CAT_DATE = 0x020, /* Date formats. */ + FMT_CAT_TIME = 0x040, /* Time formats. */ + FMT_CAT_DATE_COMPONENT = 0x080, /* Date component formats. */ + + /* String formats. */ + FMT_CAT_STRING = 0x100 /* String formats. */ }; -/* Display format categories. */ -enum +/* Format type. */ +enum fmt_type { - FCAT_BLANKS_SYSMIS = 001, /* 1=All-whitespace means SYSMIS. */ - FCAT_EVEN_WIDTH = 002, /* 1=Width must be even. */ - FCAT_STRING = 004, /* 1=String input/output format. */ - FCAT_SHIFT_DECIMAL = 010, /* 1=Automatically shift decimal point - on output--used for fixed-point - formats. */ - FCAT_OUTPUT_ONLY = 020 /* 1=This is not an input format. */ +#define FMT(NAME, METHOD, IMIN, OMIN, IO, CATEGORY) FMT_##NAME, +#include "format.def" + FMT_NUMBER_OF_FORMATS, }; +/* Length of longest format specifier name, + not including terminating null. */ +#define FMT_TYPE_LEN_MAX 8 + +/* Length of longest string representation of fmt_spec, + not including terminating null. */ +#define FMT_STRING_LEN_MAX 32 + /* Display format. */ struct fmt_spec { - int type; /* One of the above constants. */ + enum fmt_type type; /* One of FMT_*. */ int w; /* Width. */ int d; /* Number of implied decimal places. */ }; - -enum alignment +/* Maximum width of any numeric format. */ +#define FMT_MAX_NUMERIC_WIDTH 40 + +/* Constructing formats. */ +struct fmt_spec fmt_for_input (enum fmt_type, int w, int d) PURE_FUNCTION; +struct fmt_spec fmt_for_output (enum fmt_type, int w, int d) PURE_FUNCTION; +struct fmt_spec fmt_for_output_from_input (const struct fmt_spec *); +struct fmt_spec fmt_default_for_width (int width); + +/* Verifying formats. */ +bool fmt_check (const struct fmt_spec *, bool for_input); +bool fmt_check_input (const struct fmt_spec *); +bool fmt_check_output (const struct fmt_spec *); +bool fmt_check_type_compat (const struct fmt_spec *, enum val_type); +bool fmt_check_width_compat (const struct fmt_spec *, int var_width); + +/* Working with formats. */ +int fmt_var_width (const struct fmt_spec *); +char *fmt_to_string (const struct fmt_spec *, char s[FMT_STRING_LEN_MAX + 1]); +bool fmt_equal (const struct fmt_spec *, const struct fmt_spec *); +void fmt_resize (struct fmt_spec *, int new_width); + +void fmt_fix (struct fmt_spec *, bool for_input); +void fmt_fix_input (struct fmt_spec *); +void fmt_fix_output (struct fmt_spec *); + +/* Format types. */ +bool is_fmt_type (enum fmt_type); + +const char *fmt_name (enum fmt_type) PURE_FUNCTION; +bool fmt_from_name (const char *name, enum fmt_type *); + +bool fmt_takes_decimals (enum fmt_type) PURE_FUNCTION; + +int fmt_min_width (enum fmt_type, bool for_input) PURE_FUNCTION; +int fmt_max_width (enum fmt_type, bool for_input) PURE_FUNCTION; +int fmt_max_decimals (enum fmt_type, int width, bool for_input) PURE_FUNCTION; +int fmt_min_input_width (enum fmt_type) PURE_FUNCTION; +int fmt_max_input_width (enum fmt_type) PURE_FUNCTION; +int fmt_max_input_decimals (enum fmt_type, int width) PURE_FUNCTION; +int fmt_min_output_width (enum fmt_type) PURE_FUNCTION; +int fmt_max_output_width (enum fmt_type) PURE_FUNCTION; +int fmt_max_output_decimals (enum fmt_type, int width) PURE_FUNCTION; +int fmt_step_width (enum fmt_type) PURE_FUNCTION; + +bool fmt_is_string (enum fmt_type) PURE_FUNCTION; +bool fmt_is_numeric (enum fmt_type) PURE_FUNCTION; +enum fmt_category fmt_get_category (enum fmt_type) PURE_FUNCTION; + +enum fmt_type fmt_input_to_output (enum fmt_type) PURE_FUNCTION; +bool fmt_usable_for_input (enum fmt_type) PURE_FUNCTION; + +int fmt_to_io (enum fmt_type) PURE_FUNCTION; +bool fmt_from_io (int io, enum fmt_type *); + +const char *fmt_date_template (enum fmt_type) PURE_FUNCTION; + +/* Format settings. + + A fmt_settings is really just a collection of one "struct fmt_number_style" + for each format type. */ +struct fmt_settings *fmt_settings_create (void); +void fmt_settings_destroy (struct fmt_settings *); +struct fmt_settings *fmt_settings_clone (const struct fmt_settings *); + +void fmt_settings_set_decimal (struct fmt_settings *, char); + +const struct fmt_number_style *fmt_settings_get_style ( + const struct fmt_settings *, enum fmt_type); +void fmt_settings_set_style (struct fmt_settings *, enum fmt_type, + char decimal, char grouping, + const char *neg_prefix, const char *prefix, + const char *suffix, const char *neg_suffix); + +/* A prefix or suffix for a numeric output format. */ +struct fmt_affix { - ALIGN_LEFT = 0, - ALIGN_RIGHT = 1, - ALIGN_CENTRE = 2, - n_ALIGN + char *s; /* String contents of affix, in UTF-8. */ + int width; /* Display width in columns (see wcwidth()). */ }; - -enum measure +/* A numeric output style. */ +struct fmt_number_style { - MEASURE_NOMINAL=1, - MEASURE_ORDINAL=2, - MEASURE_SCALE=3, - n_MEASURES + struct fmt_affix neg_prefix; /* Negative prefix. */ + struct fmt_affix prefix; /* Prefix. */ + struct fmt_affix suffix; /* Suffix. */ + struct fmt_affix neg_suffix; /* Negative suffix. */ + char decimal; /* Decimal point: '.' or ','. */ + char grouping; /* Grouping character: ',', '.', or 0. */ + + /* A fmt_affix may require more bytes than its display width; for example, + U+00A5 (Â¥) is 3 bytes in UTF-8 but occupies only one display column. + This member is the sum of the number of bytes required by all of the + fmt_affix members in this struct, minus their display widths. Thus, it + can be used to size memory allocations: for example, the formatted + result of CCA20.5 requires no more than (20 + extra_bytes) bytes in + UTF-8. */ + int extra_bytes; }; -bool measure_is_valid(enum measure m); -bool alignment_is_valid(enum alignment a); - - -/* Descriptions of all the display formats above. */ -extern struct fmt_desc formats[]; - -union value; +int fmt_affix_width (const struct fmt_number_style *); +int fmt_neg_affix_width (const struct fmt_number_style *); -/* Maximum length of formatted value, in characters. */ -#define MAX_FORMATTED_LEN 256 - -/* Flags for parsing formats. */ -enum fmt_parse_flags - { - FMTP_ALLOW_XT = 001, /* 1=Allow X and T formats. */ - FMTP_SUPPRESS_ERRORS = 002 /* 1=Do not emit error messages. */ - }; +extern const struct fmt_spec F_8_0 ; -/* Common formats. */ -extern const struct fmt_spec f8_2; /* F8.2. */ - -int check_input_specifier (const struct fmt_spec *spec, int emit_error); -int check_output_specifier (const struct fmt_spec *spec, int emit_error); -bool check_specifier_type (const struct fmt_spec *, int type, bool emit_error); -bool check_specifier_width (const struct fmt_spec *, - int width, bool emit_error); -void convert_fmt_ItoO (const struct fmt_spec *input, struct fmt_spec *output); -int get_format_var_width (const struct fmt_spec *); -int parse_string_as_format (const char *s, int len, const struct fmt_spec *fp, - int fc, union value *v); -int translate_fmt (int spss); -bool data_out (char *s, const struct fmt_spec *fp, const union value *v); -char *fmt_to_string (const struct fmt_spec *); -void num_to_string (double v, char *s, int w, int d); -struct fmt_spec make_input_format (int type, int w, int d); -struct fmt_spec make_output_format (int type, int w, int d); - -#endif /* !format_h */ +#endif /* data/format.h */