1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
/* Format strings.
Copyright (C) 2001-2009, 2015-2016 Free Software Foundation, Inc.
Written by Bruno Haible <haible@clisp.cons.org>, 2001.
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.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. */
#ifndef _FORMAT_H
#define _FORMAT_H
#include <stdbool.h>
#include "pos.h" /* Get lex_pos_ty. */
#include "message.h" /* Get NFORMATS. */
#include "plural-distrib.h" /* Get struct plural_distribution. */
#include "error.h" /* Get fallback definition of __attribute__. */
#ifdef __cplusplus
extern "C" {
#endif
/* These indicators are set by the parse function at the appropriate
positions. */
enum
{
/* Set on the first byte of a format directive. */
FMTDIR_START = 1 << 0,
/* Set on the last byte of a format directive. */
FMTDIR_END = 1 << 1,
/* Set on the last byte of an invalid format directive, where a parse error
was recognized. */
FMTDIR_ERROR = 1 << 2
};
/* Macro for use inside a parser:
Sets an indicator at the position corresponding to PTR.
Assumes local variables 'fdi' and 'format_start' are defined. */
#define FDI_SET(ptr, flag) \
if (fdi != NULL) \
fdi[(ptr) - format_start] |= (flag)/*;*/
/* This type of callback is responsible for showing an error. */
typedef void (*formatstring_error_logger_t) (const char *format, ...)
#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1)
__attribute__ ((__format__ (__printf__, 1, 2)))
#endif
;
/* This structure describes a format string parser for a language. */
struct formatstring_parser
{
/* Parse the given string as a format string.
If translated is true, some extensions available only to msgstr but not
to msgid strings are recognized.
If fdi is non-NULL, it must be a an array of strlen (string) zero bytes.
Return a freshly allocated structure describing
1. the argument types/names needed for the format string,
2. the total number of format directives.
Return NULL if the string is not a valid format string. In this case,
also set *invalid_reason to an error message explaining why.
In both cases, set FMTDIR_* bits at the appropriate positions in fdi. */
void * (*parse) (const char *string, bool translated, char *fdi, char **invalid_reason);
/* Free a format string descriptor, returned by parse(). */
void (*free) (void *descr);
/* Return the number of format directives.
A string that can be output literally has 0 format directives. */
int (*get_number_of_directives) (void *descr);
/* Return true if the format string, although valid, contains directives that
make it appear unlikely that the string was meant as a format string.
A NULL function is equivalent to a function that always returns false. */
bool (*is_unlikely_intentional) (void *descr);
/* Verify that the argument types/names in msgid_descr and those in
msgstr_descr are the same (if equality=true), or (if equality=false)
that those of msgid_descr extend those of msgstr_descr (i.e.
msgstr_descr may omit some of the arguments of msgid_descr).
If not, signal an error using error_logger (only if error_logger != NULL)
and return true. Otherwise return false. */
bool (*check) (void *msgid_descr, void *msgstr_descr, bool equality, formatstring_error_logger_t error_logger, const char *pretty_msgid, const char *pretty_msgstr);
};
/* Format string parsers, each defined in its own file. */
extern DLL_VARIABLE struct formatstring_parser formatstring_c;
extern DLL_VARIABLE struct formatstring_parser formatstring_objc;
extern DLL_VARIABLE struct formatstring_parser formatstring_sh;
extern DLL_VARIABLE struct formatstring_parser formatstring_python;
extern DLL_VARIABLE struct formatstring_parser formatstring_python_brace;
extern DLL_VARIABLE struct formatstring_parser formatstring_lisp;
extern DLL_VARIABLE struct formatstring_parser formatstring_elisp;
extern DLL_VARIABLE struct formatstring_parser formatstring_librep;
extern DLL_VARIABLE struct formatstring_parser formatstring_scheme;
extern DLL_VARIABLE struct formatstring_parser formatstring_smalltalk;
extern DLL_VARIABLE struct formatstring_parser formatstring_java;
extern DLL_VARIABLE struct formatstring_parser formatstring_csharp;
extern DLL_VARIABLE struct formatstring_parser formatstring_awk;
extern DLL_VARIABLE struct formatstring_parser formatstring_pascal;
extern DLL_VARIABLE struct formatstring_parser formatstring_ycp;
extern DLL_VARIABLE struct formatstring_parser formatstring_tcl;
extern DLL_VARIABLE struct formatstring_parser formatstring_perl;
extern DLL_VARIABLE struct formatstring_parser formatstring_perl_brace;
extern DLL_VARIABLE struct formatstring_parser formatstring_php;
extern DLL_VARIABLE struct formatstring_parser formatstring_gcc_internal;
extern DLL_VARIABLE struct formatstring_parser formatstring_gfc_internal;
extern DLL_VARIABLE struct formatstring_parser formatstring_qt;
extern DLL_VARIABLE struct formatstring_parser formatstring_qt_plural;
extern DLL_VARIABLE struct formatstring_parser formatstring_kde;
extern DLL_VARIABLE struct formatstring_parser formatstring_kde_kuit;
extern DLL_VARIABLE struct formatstring_parser formatstring_boost;
extern DLL_VARIABLE struct formatstring_parser formatstring_lua;
extern DLL_VARIABLE struct formatstring_parser formatstring_javascript;
/* Table of all format string parsers. */
extern DLL_VARIABLE struct formatstring_parser *formatstring_parsers[NFORMATS];
/* Returns an array of the ISO C 99 <inttypes.h> format directives and other
format flags or directives with a system dependent expansion contained in
the argument string. *intervalsp is assigned to a freshly allocated array
of intervals (startpos pointing to '<', endpos to the character after '>'),
and *lengthp is assigned to the number of intervals in this array. */
struct interval
{
size_t startpos;
size_t endpos;
};
extern void
get_sysdep_c_format_directives (const char *string, bool translated,
struct interval **intervalsp, size_t *lengthp);
/* Returns the number of unnamed arguments consumed by a Python format
string. */
extern unsigned int get_python_format_unnamed_arg_count (const char *string);
/* Check whether both formats strings contain compatible format
specifications for format type i (0 <= i < NFORMATS).
Return the number of errors that were seen. */
extern int
check_msgid_msgstr_format_i (const char *msgid, const char *msgid_plural,
const char *msgstr, size_t msgstr_len,
size_t i,
struct argument_range range,
const struct plural_distribution *distribution,
formatstring_error_logger_t error_logger);
/* Check whether both formats strings contain compatible format
specifications.
Return the number of errors that were seen. */
extern int
check_msgid_msgstr_format (const char *msgid, const char *msgid_plural,
const char *msgstr, size_t msgstr_len,
const enum is_format is_format[NFORMATS],
struct argument_range range,
const struct plural_distribution *distribution,
formatstring_error_logger_t error_logger);
#ifdef __cplusplus
}
#endif
#endif /* _FORMAT_H */
|
