AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
98e076b51e
gtk2/gtk/gtkcssparserprivate.h

131 lines
7.2 KiB
C
Raw Normal View History

css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
/* GTK - The GIMP Toolkit
* Copyright (C) 2011 Benjamin Otte <otte@gnome.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
*/
#ifndef __GTK_CSS_PARSER_PRIVATE_H__
#define __GTK_CSS_PARSER_PRIVATE_H__
cssparser: Add _gtk_css_parser_error_full()
2012-03-26 16:36:20 +00:00
#include <gtk/gtkcssprovider.h>
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
build: Add gtk-css static library This library is meant to be the new CSS library that gets used from GDK, GSK and GTK for string printing and parsing. As a first step, move GtkCssProviderError into it. While doing so, split it into GtkCssParserError (for critical problems) and GtkCssParserWarning (for non-critical problems).
2019-03-22 03:20:17 +00:00
#include <gtk/css/gtkcss.h>
parser: Add gtk_css_parser_has_token() This is ithe first step towards converting the parsing code to use tokens. For now, the topken type is just a magic enum value that only works as-needed.
2019-03-23 17:21:59 +00:00
#include "gtk/css/gtkcsstokenizerprivate.h"
build: Add gtk-css static library This library is meant to be the new CSS library that gets used from GDK, GSK and GTK for string printing and parsing. As a first step, move GtkCssProviderError into it. While doing so, split it into GtkCssParserError (for critical problems) and GtkCssParserWarning (for non-critical problems).
2019-03-22 03:20:17 +00:00
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
G_BEGIN_DECLS
typedef struct _GtkCssParser GtkCssParser;
typedef void (* GtkCssParserErrorFunc) (GtkCssParser *parser,
const GError *error,
gpointer user_data);
cross-fade: Use gtk_css_parser_consume_any() .. and gtk_css_parser_consume_function(). gtk_css_parser_consume_any() is a new function that implements the CSS spec's any combinator ||.
2019-03-30 11:04:51 +00:00
typedef struct _GtkCssParseOption GtkCssParseOption;
struct _GtkCssParseOption
{
gboolean (* can_parse) (GtkCssParser *parser,
gpointer option_data,
gpointer user_data);
gboolean (* parse) (GtkCssParser *parser,
gpointer option_data,
gpointer user_data);
gpointer data;
};
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
GtkCssParser * _gtk_css_parser_new (const char *data,
cssparser: Keep track of the file
2012-04-18 14:54:04 +00:00
GFile *file,
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
GtkCssParserErrorFunc error_func,
gpointer user_data);
void _gtk_css_parser_free (GtkCssParser *parser);
css: Make property parsing functions take a css parser Instead of reading a string and then passing that in, let the parse functions use the full power of the parser.
2011-05-18 16:32:22 +00:00
void _gtk_css_parser_take_error (GtkCssParser *parser,
GError *error);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
void _gtk_css_parser_error (GtkCssParser *parser,
const char *format,
...) G_GNUC_PRINTF (2, 3);
guint _gtk_css_parser_get_line (GtkCssParser *parser);
guint _gtk_css_parser_get_position (GtkCssParser *parser);
cssparser: Change APIs that work with files Now that we keep track of the parser's file, we don't require it to be passed anymore.
2012-04-18 17:43:24 +00:00
GFile * _gtk_css_parser_get_file (GtkCssParser *parser);
cssparser: Add gtk_css_parser_resolve_url() Another slight change of semantics and naming for the new parser.
2019-04-09 00:15:12 +00:00
GFile * gtk_css_parser_resolve_url (GtkCssParser *parser,
const char *url);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
parser: Add gtk_css_parser_has_token() This is ithe first step towards converting the parsing code to use tokens. For now, the topken type is just a magic enum value that only works as-needed.
2019-03-23 17:21:59 +00:00
gboolean gtk_css_parser_has_token (GtkCssParser *parser,
GtkCssTokenType token_type);
cssparser: Drop _gtk_css_parser_has_prefix() Replace it with has_ident/has_function. The old function is a typical string matching API, not a tokenizing one.
2019-04-01 09:47:53 +00:00
gboolean gtk_css_parser_has_ident (GtkCssParser *parser,
const char *name);
cssparser: Split integer gettig into has/consume functions We can't try to get an integer because ultimately integer getters support the same shenanigans that numbers and percentages do with calc() and whatnot.
2019-04-05 11:41:08 +00:00
gboolean gtk_css_parser_has_integer (GtkCssParser *parser);
cssparser: Introduce gtk_css_parser_try_ident() ... and gtk_css_parser_has_function().
2019-03-24 13:03:52 +00:00
gboolean gtk_css_parser_has_function (GtkCssParser *parser,
const char *name);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
/* IMPORTANT:
* _try_foo() functions do not modify the data pointer if they fail, nor do they
* signal an error. _read_foo() will modify the data pointer and position it at
* the first token that is broken and emit an error about the failure.
* So only call _read_foo() when you know that you are reading a foo. _try_foo()
docs: use apostrophes in *n't
2014-02-07 18:32:47 +00:00
* however is fine to call if you don’t know yet if the token is a foo or a bar,
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
* you can _try_bar() if try_foo() failed.
*/
cssparser: Introduce gtk_css_parser_try_ident() ... and gtk_css_parser_has_function().
2019-03-24 13:03:52 +00:00
gboolean gtk_css_parser_try_ident (GtkCssParser *parser,
const char *ident);
cssparser: Add gtk_css_parser_try_delim() For parsing single code point delimiters. Also port calc() to use this.
2019-04-05 00:57:14 +00:00
gboolean gtk_css_parser_try_delim (GtkCssParser *parser,
gunichar delim);
cssparser: Add gtk_css_parser_try_at_keyword()
2019-04-01 22:21:02 +00:00
gboolean gtk_css_parser_try_at_keyword (GtkCssParser *parser,
const char *keyword);
cssparser: Add gtk_css_parser_try_token()
2019-03-24 13:36:55 +00:00
gboolean gtk_css_parser_try_token (GtkCssParser *parser,
GtkCssTokenType token_type);
cssparser: Simplify Remove the uint parser (and use the int parser in the one user of it). And avoid unnecessarily going through a macro.
2019-03-22 16:37:04 +00:00
gboolean _gtk_css_parser_try (GtkCssParser *parser,
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
const char *string,
gboolean skip_whitespace);
char * _gtk_css_parser_try_ident (GtkCssParser *parser,
gboolean skip_whitespace);
char * _gtk_css_parser_try_name (GtkCssParser *parser,
gboolean skip_whitespace);
cssparser: Move symbolic color parser to gtksymboliccolor.c
2012-04-05 19:09:35 +00:00
gboolean _gtk_css_parser_try_hash_color (GtkCssParser *parser,
GdkRGBA *rgba);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
cssparser: Add gtk_css_parser_consume_ident() And use it to fix the palette parser.
2019-03-31 10:40:53 +00:00
char * gtk_css_parser_consume_ident (GtkCssParser *self);
cssparser: Add gtk_css_parser_consume_string() Well, just rename _gtk_css_parser_read_string() for the new semantics, but this sounds cooler.
2019-04-04 21:37:38 +00:00
char * gtk_css_parser_consume_string (GtkCssParser *self);
cssparser: Add gtk_css_parser_consume_url() Another slight renaming and semantics change.
2019-04-09 00:29:27 +00:00
GFile * gtk_css_parser_consume_url (GtkCssParser *self);
cssparser: Introduce gtk_css_parser_consume_function() This is a vfunc-based function parser.
2019-03-24 20:11:53 +00:00
gboolean gtk_css_parser_consume_number (GtkCssParser *self,
double *number);
cssparser: Split integer gettig into has/consume functions We can't try to get an integer because ultimately integer getters support the same shenanigans that numbers and percentages do with calc() and whatnot.
2019-04-05 11:41:08 +00:00
gboolean gtk_css_parser_consume_integer (GtkCssParser *parser,
int *value);
cssparser: Introduce gtk_css_parser_consume_function() This is a vfunc-based function parser.
2019-03-24 20:11:53 +00:00
gboolean gtk_css_parser_consume_function (GtkCssParser *self,
guint min_args,
guint max_args,
guint (* parse_func) (GtkCssParser *, guint, gpointer),
gpointer data);
cross-fade: Use gtk_css_parser_consume_any() .. and gtk_css_parser_consume_function(). gtk_css_parser_consume_any() is a new function that implements the CSS spec's any combinator ||.
2019-03-30 11:04:51 +00:00
gsize gtk_css_parser_consume_any (GtkCssParser *parser,
const GtkCssParseOption *options,
gsize n_options,
gpointer user_data);
cssparser: Introduce gtk_css_parser_consume_function() This is a vfunc-based function parser.
2019-03-24 20:11:53 +00:00
css: Add GtkCssNumber
2012-01-13 22:48:42 +00:00
gboolean _gtk_css_parser_has_number (GtkCssParser *parser);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
css: Add GtkCssNumber
2012-01-13 22:48:42 +00:00
void _gtk_css_parser_skip_whitespace (GtkCssParser *parser);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
void _gtk_css_parser_resync (GtkCssParser *parser,
gboolean sync_at_semicolon,
char terminator);
css: Split out a common function It's used in two places already, and Iwant to use it in a third one.
2014-05-01 17:47:58 +00:00
/* XXX: Find better place to put it? */
void _gtk_css_print_string (GString *str,
const char *string);
css: Rewrite the parser Instead of relying on GScanner and its idea of syntax, code up a parser that obeys the CSS spec. This also has the great side effect of reporting correct line numbers and positions. Also included is a reorganization of the returned error values. Instead of error values describing what type of syntax error was returned, the code just returns SYNTAX_ERROR. Other messages exist for when actual values don't work or when errors shouldn't be fatal due to backwards compatibility.
2011-04-14 02:47:18 +00:00
G_END_DECLS
#endif /* __GTK_CSS_PARSER_PRIVATE_H__ */
Reference in New Issue Copy Permalink