/* Qt format strings. Copyright (C) 2003-2004, 2006-2007, 2009, 2019 Free Software Foundation, Inc. Written by Bruno Haible , 2003. 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 . */ #ifdef HAVE_CONFIG_H # include #endif #include #include #include "format.h" #include "xalloc.h" #include "xvasprintf.h" #include "gettext.h" #define _(str) gettext (str) /* Qt format strings are processed by QString::arg and are documented in qt-4.3.0/doc/html/qstring.html. A directive - starts with '%', - is optionally followed by 'L' (indicates locale-dependent processing), - is followed by one or two digits ('0' to '9'). %0n is equivalent to %n. An unterminated directive ('%' or '%L' not followed by a digit or at the end) is not an error. The first .arg() invocation replaces the %n with the lowest numbered n, the next .arg() invocation then replaces the %n with the second-lowest numbered n, and so on. This is inherently buggy because a '%' in the first replacement confuses the second .arg() invocation. To reduce this problem and introduce another one, there are also .arg() methods that take up to 9 strings and perform the replacements in one swoop. But this method works only on strings that contain no 'L' flags and only single-digit argument designators. Although %0 is supported, usually %1 denotes the first argument, %2 the second argument etc. */ struct spec { /* Number of format directives. */ unsigned int directives; /* True if the string supports the multi-argument .arg() methods, i.e. if it contains no 'L' flags and only single-digit argument designators. */ bool simple; /* Booleans telling which %nn was seen. */ unsigned int arg_count; bool args_used[100]; }; static void * format_parse (const char *format, bool translated, char *fdi, char **invalid_reason) { const char *const format_start = format; struct spec spec; struct spec *result; spec.directives = 0; spec.simple = true; spec.arg_count = 0; for (; *format != '\0';) if (*format++ == '%') { const char *dir_start = format - 1; bool locale_flag = false; if (*format == 'L') { locale_flag = true; format++; } if (*format >= '0' && *format <= '9') { /* A directive. */ unsigned int number; FDI_SET (dir_start, FMTDIR_START); spec.directives++; if (locale_flag) spec.simple = false; number = *format - '0'; if (format[1] >= '0' && format[1] <= '9') { number = 10 * number + (format[1] - '0'); spec.simple = false; format++; } while (spec.arg_count <= number) spec.args_used[spec.arg_count++] = false; spec.args_used[number] = true; FDI_SET (format, FMTDIR_END); format++; } } result = XMALLOC (struct spec); *result = spec; return result; } static void format_free (void *descr) { struct spec *spec = (struct spec *) descr; free (spec); } static int format_get_number_of_directives (void *descr) { struct spec *spec = (struct spec *) descr; return spec->directives; } static bool format_check (void *msgid_descr, void *msgstr_descr, bool equality, formatstring_error_logger_t error_logger, const char *pretty_msgid, const char *pretty_msgstr) { struct spec *spec1 = (struct spec *) msgid_descr; struct spec *spec2 = (struct spec *) msgstr_descr; bool err = false; unsigned int i; if (spec1->simple && !spec2->simple) { if (error_logger) error_logger (_("'%s' is a simple format string, but '%s' is not: it contains an 'L' flag or a double-digit argument number"), pretty_msgid, pretty_msgstr); err = true; } if (!err) for (i = 0; i < spec1->arg_count || i < spec2->arg_count; i++) { bool arg_used1 = (i < spec1->arg_count && spec1->args_used[i]); bool arg_used2 = (i < spec2->arg_count && spec2->args_used[i]); /* The translator cannot omit a %n from the msgstr because that would yield a "Argument missing" warning at runtime. */ if (arg_used1 != arg_used2) { if (error_logger) { if (arg_used1) error_logger (_("a format specification for argument %u doesn't exist in '%s'"), i, pretty_msgstr); else error_logger (_("a format specification for argument %u, as in '%s', doesn't exist in '%s'"), i, pretty_msgstr, pretty_msgid); } err = true; break; } } return err; } struct formatstring_parser formatstring_qt = { format_parse, format_free, format_get_number_of_directives, NULL, format_check }; #ifdef TEST /* Test program: Print the argument list specification returned by format_parse for strings read from standard input. */ #include static void format_print (void *descr) { struct spec *spec = (struct spec *) descr; unsigned int i; if (spec == NULL) { printf ("INVALID"); return; } printf ("("); for (i = 0; i < spec->arg_count; i++) { if (i > 0) printf (" "); if (spec->args_used[i]) printf ("*"); else printf ("_"); } printf (")"); } int main () { for (;;) { char *line = NULL; size_t line_size = 0; int line_len; char *invalid_reason; void *descr; line_len = getline (&line, &line_size, stdin); if (line_len < 0) break; if (line_len > 0 && line[line_len - 1] == '\n') line[--line_len] = '\0'; invalid_reason = NULL; descr = format_parse (line, false, NULL, &invalid_reason); format_print (descr); printf ("\n"); if (descr == NULL) printf ("%s\n", invalid_reason); free (invalid_reason); free (line); } return 0; } /* * For Emacs M-x compile * Local Variables: * compile-command: "/bin/sh ../libtool --tag=CC --mode=link gcc -o a.out -static -O -g -Wall -I.. -I../gnulib-lib -I../../gettext-runtime/intl -DHAVE_CONFIG_H -DTEST format-qt.c ../gnulib-lib/libgettextlib.la" * End: */ #endif /* TEST */