X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=src%2Fdata%2Fvalue-labels.h;h=6c13ec9a5088b4104f898603aa130c9edf3613e0;hb=099b41646452789d8a5b31218fa6522d1ea46584;hp=6cb5259edb2fe22a28b53b49bba4a8e2e9fb1b1c;hpb=81579d9e9f994fb2908f50af41c3eb033d216e58;p=pspp diff --git a/src/data/value-labels.h b/src/data/value-labels.h index 6cb5259edb..6c13ec9a50 100644 --- a/src/data/value-labels.h +++ b/src/data/value-labels.h @@ -39,6 +39,7 @@ struct val_lab struct hmap_node node; /* Node in hash map. */ union value value; /* The value being labeled. */ const char *label; /* An interned string. */ + const char *escaped_label; /* An interned string. */ }; /* Returns the value in VL. The caller must not modify or free @@ -52,19 +53,33 @@ static inline const union value *val_lab_get_value (const struct val_lab *vl) return &vl->value; } -/* Returns the label in VL. The caller must not modify or free the returned - value. */ +/* Returns the label in VL as a UTF-8 encoded interned string, in a format + appropriate for use in output. The caller must not modify or free the + returned value. */ static inline const char * val_lab_get_label (const struct val_lab *vl) { return vl->label; } + +/* Returns the label in VL as a UTF-8 encoded interned string. Any new-line + characters in the label's usual output form are represented in the returned + string as the two-byte sequence "\\n". This form is used on the VALUE + LABELS command, in system and portable files, and passed to val_labs_add() + and val_labs_replace(). + + The caller must not modify or free the returned value. */ +static inline const char * +val_lab_get_escaped_label (const struct val_lab *vl) +{ + return vl->escaped_label; +} /* A set of value labels. */ struct val_labs { int width; /* 0=numeric, otherwise string width. */ - struct hmap labels; /* Hash table of `struct int_val_lab's. */ + struct hmap labels; /* Hash table of `struct val_lab's. */ }; /* Creating and destroying sets of value labels. */ @@ -77,7 +92,7 @@ size_t val_labs_count (const struct val_labs *); /* Looking up value labels. */ const char *val_labs_find (const struct val_labs *, const union value *); struct val_lab *val_labs_lookup (const struct val_labs *, - const union value *); + const union value *); /* Basic properties. */ size_t val_labs_count (const struct val_labs *);