]>
Commit | Line | Data |
---|---|---|
1 | # C++ skeleton for Bison | |
2 | ||
3 | # Copyright (C) 2002-2013 Free Software Foundation, Inc. | |
4 | ||
5 | # This program is free software: you can redistribute it and/or modify | |
6 | # it under the terms of the GNU General Public License as published by | |
7 | # the Free Software Foundation, either version 3 of the License, or | |
8 | # (at your option) any later version. | |
9 | # | |
10 | # This program is distributed in the hope that it will be useful, | |
11 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | # GNU General Public License for more details. | |
14 | # | |
15 | # You should have received a copy of the GNU General Public License | |
16 | # along with this program. If not, see <http://www.gnu.org/licenses/>. | |
17 | ||
18 | m4_include(b4_pkgdatadir/[c++.m4]) | |
19 | ||
20 | ||
21 | # b4_integral_parser_table_declare(TABLE-NAME, CONTENT, COMMENT) | |
22 | # -------------------------------------------------------------- | |
23 | # Declare "parser::yy<TABLE-NAME>_" whose contents is CONTENT. | |
24 | m4_define([b4_integral_parser_table_declare], | |
25 | [m4_ifval([$3], [b4_comment([$3], [ ]) | |
26 | ])dnl | |
27 | static const b4_int_type_for([$2]) yy$1_[[]];dnl | |
28 | ]) | |
29 | ||
30 | # b4_integral_parser_table_define(TABLE-NAME, CONTENT, COMMENT) | |
31 | # ------------------------------------------------------------- | |
32 | # Define "parser::yy<TABLE-NAME>_" whose contents is CONTENT. | |
33 | m4_define([b4_integral_parser_table_define], | |
34 | [ const b4_int_type_for([$2]) | |
35 | b4_parser_class_name::yy$1_[[]] = | |
36 | { | |
37 | $2 | |
38 | };dnl | |
39 | ]) | |
40 | ||
41 | ||
42 | # b4_symbol_value_template(VAL, [TYPE]) | |
43 | # ------------------------------------- | |
44 | # Same as b4_symbol_value, but used in a template method. It makes | |
45 | # a difference when using variants. | |
46 | m4_copy([b4_symbol_value], [b4_symbol_value_template]) | |
47 | ||
48 | ||
49 | # b4_lhs_value([TYPE]) | |
50 | # -------------------- | |
51 | # Expansion of $<TYPE>$. | |
52 | m4_define([b4_lhs_value], | |
53 | [b4_symbol_value([yylhs.value], [$1])]) | |
54 | ||
55 | ||
56 | # b4_lhs_location() | |
57 | # ----------------- | |
58 | # Expansion of @$. | |
59 | m4_define([b4_lhs_location], | |
60 | [yylhs.location]) | |
61 | ||
62 | ||
63 | # b4_rhs_data(RULE-LENGTH, NUM) | |
64 | # ----------------------------- | |
65 | # Return the data corresponding to the symbol #NUM, where the current | |
66 | # rule has RULE-LENGTH symbols on RHS. | |
67 | m4_define([b4_rhs_data], | |
68 | [yystack_@{b4_subtract($@)@}]) | |
69 | ||
70 | ||
71 | # b4_rhs_state(RULE-LENGTH, NUM) | |
72 | # ------------------------------ | |
73 | # The state corresponding to the symbol #NUM, where the current | |
74 | # rule has RULE-LENGTH symbols on RHS. | |
75 | m4_define([b4_rhs_state], | |
76 | [b4_rhs_data([$1], [$2]).state]) | |
77 | ||
78 | ||
79 | # b4_rhs_value(RULE-LENGTH, NUM, [TYPE]) | |
80 | # -------------------------------------- | |
81 | # Expansion of $<TYPE>NUM, where the current rule has RULE-LENGTH | |
82 | # symbols on RHS. | |
83 | m4_define([b4_rhs_value], | |
84 | [b4_symbol_value([b4_rhs_data([$1], [$2]).value], [$3])]) | |
85 | ||
86 | ||
87 | # b4_rhs_location(RULE-LENGTH, NUM) | |
88 | # --------------------------------- | |
89 | # Expansion of @NUM, where the current rule has RULE-LENGTH symbols | |
90 | # on RHS. | |
91 | m4_define([b4_rhs_location], | |
92 | [b4_rhs_data([$1], [$2]).location]) | |
93 | ||
94 | ||
95 | # b4_symbol_action(SYMBOL-NUM, KIND) | |
96 | # ---------------------------------- | |
97 | # Run the action KIND (destructor or printer) for SYMBOL-NUM. | |
98 | # Same as in C, but using references instead of pointers. | |
99 | m4_define([b4_symbol_action], | |
100 | [b4_symbol_if([$1], [has_$2], | |
101 | [m4_pushdef([b4_symbol_value], m4_defn([b4_symbol_value_template]))[]dnl | |
102 | b4_dollar_pushdef([yysym.value], | |
103 | b4_symbol_if([$1], [has_type], | |
104 | [m4_dquote(b4_symbol([$1], [type]))]), | |
105 | [yysym.location])dnl | |
106 | b4_symbol_case_([$1]) | |
107 | b4_syncline([b4_symbol([$1], [$2_line])], ["b4_symbol([$1], [$2_file])"]) | |
108 | b4_symbol([$1], [$2]) | |
109 | b4_syncline([@oline@], [@ofile@]) | |
110 | break; | |
111 | ||
112 | m4_popdef([b4_symbol_value])[]dnl | |
113 | b4_dollar_popdef[]dnl | |
114 | ])]) | |
115 | ||
116 | ||
117 | # b4_lex | |
118 | # ------ | |
119 | # Call yylex. | |
120 | m4_define([b4_lex], | |
121 | [b4_token_ctor_if( | |
122 | [b4_function_call([yylex], | |
123 | [symbol_type], m4_ifdef([b4_lex_param], b4_lex_param))], | |
124 | [b4_function_call([yylex], [int], | |
125 | [b4_api_PREFIX[STYPE*], [&yyla.value]][]dnl | |
126 | b4_locations_if([, [[location*], [&yyla.location]]])dnl | |
127 | m4_ifdef([b4_lex_param], [, ]b4_lex_param))])]) | |
128 | ||
129 | ||
130 | m4_pushdef([b4_copyright_years], | |
131 | [2002-2013]) | |
132 | ||
133 | m4_define([b4_parser_class_name], | |
134 | [b4_percent_define_get([[parser_class_name]])]) | |
135 | ||
136 | b4_bison_locations_if([# Backward compatibility. | |
137 | m4_define([b4_location_constructors]) | |
138 | m4_include(b4_pkgdatadir/[location.cc])]) | |
139 | m4_include(b4_pkgdatadir/[stack.hh]) | |
140 | b4_variant_if([m4_include(b4_pkgdatadir/[variant.hh])]) | |
141 | ||
142 | # b4_shared_declarations | |
143 | # ---------------------- | |
144 | # Declaration that might either go into the header (if --defines) | |
145 | # or open coded in the parser body. | |
146 | m4_define([b4_shared_declarations], | |
147 | [b4_percent_code_get([[requires]])[ | |
148 | ]b4_parse_assert_if([# include <cassert>])[ | |
149 | # include <cstdlib> // abort | |
150 | # include <vector> | |
151 | # include <iostream> | |
152 | # include <stdexcept> | |
153 | # include <string>]b4_defines_if([[ | |
154 | # include "stack.hh" | |
155 | ]b4_bison_locations_if([[# include "location.hh"]])])[ | |
156 | ]b4_variant_if([b4_variant_includes])[ | |
157 | ||
158 | ]b4_YYDEBUG_define[ | |
159 | ||
160 | ]b4_namespace_open[ | |
161 | ||
162 | ]b4_defines_if([], | |
163 | [b4_stack_define | |
164 | b4_bison_locations_if([b4_position_define | |
165 | b4_location_define])])[ | |
166 | ||
167 | ]b4_variant_if([b4_variant_define])[ | |
168 | ||
169 | /// A Bison parser. | |
170 | class ]b4_parser_class_name[ | |
171 | { | |
172 | public: | |
173 | ]b4_public_types_declare[ | |
174 | /// Build a parser object. | |
175 | ]b4_parser_class_name[ (]b4_parse_param_decl[); | |
176 | virtual ~]b4_parser_class_name[ (); | |
177 | ||
178 | /// Parse. | |
179 | /// \returns 0 iff parsing succeeded. | |
180 | virtual int parse (); | |
181 | ||
182 | #if ]b4_api_PREFIX[DEBUG | |
183 | /// The current debugging stream. | |
184 | std::ostream& debug_stream () const; | |
185 | /// Set the current debugging stream. | |
186 | void set_debug_stream (std::ostream &); | |
187 | ||
188 | /// Type for debugging levels. | |
189 | typedef int debug_level_type; | |
190 | /// The current debugging level. | |
191 | debug_level_type debug_level () const; | |
192 | /// Set the current debugging level. | |
193 | void set_debug_level (debug_level_type l); | |
194 | #endif | |
195 | ||
196 | /// Report a syntax error.]b4_locations_if([[ | |
197 | /// \param loc where the syntax error is found.]])[ | |
198 | /// \param msg a description of the syntax error. | |
199 | virtual void error (]b4_locations_if([[const location_type& loc, ]])[const std::string& msg); | |
200 | ||
201 | /// Report a syntax error. | |
202 | void error (const syntax_error& err); | |
203 | ||
204 | private: | |
205 | /// State numbers. | |
206 | typedef int state_type; | |
207 | ||
208 | /// Generate an error message. | |
209 | /// \param yystate the state where the error occurred. | |
210 | /// \param yytoken the lookahead token. | |
211 | virtual std::string yysyntax_error_ (state_type yystate, int yytoken); | |
212 | ||
213 | /// Compute post-reduction state. | |
214 | /// \param yystate the current state | |
215 | /// \param yylhs the nonterminal to push on the stack | |
216 | state_type yy_lr_goto_state_ (state_type yystate, int yylhs); | |
217 | ||
218 | /// Whether the given \c yypact_ value indicates a defaulted state. | |
219 | /// \param yyvalue the value to check | |
220 | static bool yy_pact_value_is_default_ (int yyvalue); | |
221 | ||
222 | /// Whether the given \c yytable_ value indicates a syntax error. | |
223 | /// \param yyvalue the value to check | |
224 | static bool yy_table_value_is_error_ (int yyvalue); | |
225 | ||
226 | /// Internal symbol numbers. | |
227 | typedef ]b4_int_type_for([b4_translate])[ token_number_type; | |
228 | static const ]b4_int_type(b4_pact_ninf, b4_pact_ninf)[ yypact_ninf_; | |
229 | static const ]b4_int_type(b4_table_ninf, b4_table_ninf)[ yytable_ninf_; | |
230 | ||
231 | /// Convert a scanner token number \a t to a symbol number. | |
232 | static inline token_number_type yytranslate_ (]b4_token_ctor_if([token_type], [int])[ t); | |
233 | ||
234 | // Tables. | |
235 | ]b4_parser_tables_declare[]b4_error_verbose_if([ | |
236 | ||
237 | /// Convert the symbol name \a n to a form suitable for a diagnostic. | |
238 | static std::string yytnamerr_ (const char *n);])[ | |
239 | ||
240 | ]b4_token_table_if([], [[#if ]b4_api_PREFIX[DEBUG]])[ | |
241 | /// For a symbol, its name in clear. | |
242 | static const char* const yytname_[]; | |
243 | ]b4_token_table_if([[#if ]b4_api_PREFIX[DEBUG]])[ | |
244 | ]b4_integral_parser_table_declare([rline], [b4_rline], | |
245 | [[YYRLINE[YYN] -- Source line where rule number YYN was defined.]])[ | |
246 | /// Report on the debug stream that the rule \a r is going to be reduced. | |
247 | virtual void yy_reduce_print_ (int r); | |
248 | /// Print the state stack on the debug stream. | |
249 | virtual void yystack_print_ (); | |
250 | ||
251 | // Debugging. | |
252 | int yydebug_; | |
253 | std::ostream* yycdebug_; | |
254 | ||
255 | /// \brief Display a symbol type, value and location. | |
256 | /// \param yyo The output stream. | |
257 | /// \param yysym The symbol. | |
258 | template <typename Base> | |
259 | void yy_print_ (std::ostream& yyo, | |
260 | const basic_symbol<Base>& yysym) const; | |
261 | #endif | |
262 | ||
263 | /// \brief Reclaim the memory associated to a symbol. | |
264 | /// \param yymsg Why this token is reclaimed. | |
265 | /// If null, print nothing. | |
266 | /// \param s The symbol. | |
267 | template <typename Base> | |
268 | inline void yy_destroy_ (const char* yymsg, | |
269 | basic_symbol<Base>& yysym) const; | |
270 | ||
271 | private: | |
272 | /// Type access provider for state based symbols. | |
273 | struct by_state | |
274 | { | |
275 | /// Default constructor. | |
276 | inline by_state (); | |
277 | ||
278 | /// Constructor. | |
279 | inline by_state (state_type s); | |
280 | ||
281 | /// Copy constructor. | |
282 | inline by_state (const by_state& other); | |
283 | ||
284 | /// The state. | |
285 | state_type state; | |
286 | ||
287 | /// The type (corresponding to \a state). | |
288 | inline int type_get () const; | |
289 | ||
290 | typedef state_type value_type; | |
291 | }; | |
292 | ||
293 | /// "Internal" symbol: element of the stack. | |
294 | typedef basic_symbol<by_state> stack_symbol_type; | |
295 | ||
296 | /// Stack type. | |
297 | typedef stack<stack_symbol_type> stack_type; | |
298 | ||
299 | /// The stack. | |
300 | stack_type yystack_; | |
301 | ||
302 | /// Push a new state on the stack. | |
303 | /// \param m a debug message to display | |
304 | /// if null, no trace is output. | |
305 | /// \param s the symbol | |
306 | /// \warning the contents of \a s.value is stolen. | |
307 | inline void yypush_ (const char* m, stack_symbol_type& s); | |
308 | ||
309 | /// Push a new look ahead token on the state on the stack. | |
310 | /// \param m a debug message to display | |
311 | /// if null, no trace is output. | |
312 | /// \param s the state | |
313 | /// \param sym the symbol (for its value and location). | |
314 | /// \warning the contents of \a s.value is stolen. | |
315 | inline void yypush_ (const char* m, state_type s, symbol_type& sym); | |
316 | ||
317 | /// Pop \a n symbols the three stacks. | |
318 | inline void yypop_ (unsigned int n = 1); | |
319 | ||
320 | // Constants. | |
321 | enum | |
322 | { | |
323 | yyeof_ = 0, | |
324 | yylast_ = ]b4_last[, //< Last index in yytable_. | |
325 | yynnts_ = ]b4_nterms_number[, //< Number of nonterminal symbols. | |
326 | yyempty_ = -2, | |
327 | yyfinal_ = ]b4_final_state_number[, //< Termination state number. | |
328 | yyterror_ = 1, | |
329 | yyerrcode_ = 256, | |
330 | yyntokens_ = ]b4_tokens_number[ //< Number of tokens. | |
331 | }; | |
332 | ||
333 | ]b4_parse_param_vars[ | |
334 | }; | |
335 | ||
336 | ]b4_token_ctor_if([b4_yytranslate_define | |
337 | b4_public_types_define])[ | |
338 | ]b4_namespace_close[ | |
339 | ||
340 | ]b4_percent_define_flag_if([[global_tokens_and_yystype]], | |
341 | [b4_token_defines | |
342 | ||
343 | #ifndef ]b4_api_PREFIX[STYPE | |
344 | // Redirection for backward compatibility. | |
345 | # define ]b4_api_PREFIX[STYPE b4_namespace_ref::b4_parser_class_name::semantic_type | |
346 | #endif | |
347 | ])[ | |
348 | ]b4_percent_code_get([[provides]])[ | |
349 | ]]) | |
350 | ||
351 | b4_defines_if( | |
352 | [b4_output_begin([b4_spec_defines_file]) | |
353 | b4_copyright([Skeleton interface for Bison LALR(1) parsers in C++]) | |
354 | [ | |
355 | /** | |
356 | ** \file ]b4_spec_defines_file[ | |
357 | ** Define the ]b4_namespace_ref[::parser class. | |
358 | */ | |
359 | ||
360 | // C++ LALR(1) parser skeleton written by Akim Demaille. | |
361 | ||
362 | ]b4_cpp_guard_open([b4_spec_defines_file])[ | |
363 | ]b4_shared_declarations[ | |
364 | ]b4_cpp_guard_close([b4_spec_defines_file]) | |
365 | b4_output_end() | |
366 | ]) | |
367 | ||
368 | ||
369 | b4_output_begin([b4_parser_file_name]) | |
370 | b4_copyright([Skeleton implementation for Bison LALR(1) parsers in C++]) | |
371 | b4_percent_code_get([[top]])[]dnl | |
372 | m4_if(b4_prefix, [yy], [], | |
373 | [ | |
374 | // Take the name prefix into account. | |
375 | #define yylex b4_prefix[]lex])[ | |
376 | ||
377 | // First part of user declarations. | |
378 | ]b4_user_pre_prologue[ | |
379 | ||
380 | ]b4_null_define[ | |
381 | ||
382 | ]b4_defines_if([[#include "@basename(]b4_spec_defines_file[@)"]], | |
383 | [b4_shared_declarations])[ | |
384 | ||
385 | // User implementation prologue. | |
386 | ]b4_user_post_prologue[ | |
387 | ]b4_percent_code_get[ | |
388 | ||
389 | #ifndef YY_ | |
390 | # if defined YYENABLE_NLS && YYENABLE_NLS | |
391 | # if ENABLE_NLS | |
392 | # include <libintl.h> // FIXME: INFRINGES ON USER NAME SPACE. | |
393 | # define YY_(msgid) dgettext ("bison-runtime", msgid) | |
394 | # endif | |
395 | # endif | |
396 | # ifndef YY_ | |
397 | # define YY_(msgid) msgid | |
398 | # endif | |
399 | #endif | |
400 | ||
401 | ]b4_locations_if([dnl | |
402 | [#define YYRHSLOC(Rhs, K) ((Rhs)[K].location) | |
403 | ]b4_yylloc_default_define])[ | |
404 | ||
405 | // Suppress unused-variable warnings by "using" E. | |
406 | #define YYUSE(E) ((void) (E)) | |
407 | ||
408 | // Enable debugging if requested. | |
409 | #if ]b4_api_PREFIX[DEBUG | |
410 | ||
411 | // A pseudo ostream that takes yydebug_ into account. | |
412 | # define YYCDEBUG if (yydebug_) (*yycdebug_) | |
413 | ||
414 | # define YY_SYMBOL_PRINT(Title, Symbol) \ | |
415 | do { \ | |
416 | if (yydebug_) \ | |
417 | { \ | |
418 | *yycdebug_ << Title << ' '; \ | |
419 | yy_print_ (*yycdebug_, Symbol); \ | |
420 | *yycdebug_ << std::endl; \ | |
421 | } \ | |
422 | } while (false) | |
423 | ||
424 | # define YY_REDUCE_PRINT(Rule) \ | |
425 | do { \ | |
426 | if (yydebug_) \ | |
427 | yy_reduce_print_ (Rule); \ | |
428 | } while (false) | |
429 | ||
430 | # define YY_STACK_PRINT() \ | |
431 | do { \ | |
432 | if (yydebug_) \ | |
433 | yystack_print_ (); \ | |
434 | } while (false) | |
435 | ||
436 | #else // !]b4_api_PREFIX[DEBUG | |
437 | ||
438 | # define YYCDEBUG if (false) std::cerr | |
439 | # define YY_SYMBOL_PRINT(Title, Symbol) YYUSE(Symbol) | |
440 | # define YY_REDUCE_PRINT(Rule) static_cast<void>(0) | |
441 | # define YY_STACK_PRINT() static_cast<void>(0) | |
442 | ||
443 | #endif // !]b4_api_PREFIX[DEBUG | |
444 | ||
445 | #define yyerrok (yyerrstatus_ = 0) | |
446 | #define yyclearin (yyempty = true) | |
447 | ||
448 | #define YYACCEPT goto yyacceptlab | |
449 | #define YYABORT goto yyabortlab | |
450 | #define YYERROR goto yyerrorlab | |
451 | #define YYRECOVERING() (!!yyerrstatus_) | |
452 | ||
453 | ]b4_namespace_open[]b4_error_verbose_if([[ | |
454 | ||
455 | /* Return YYSTR after stripping away unnecessary quotes and | |
456 | backslashes, so that it's suitable for yyerror. The heuristic is | |
457 | that double-quoting is unnecessary unless the string contains an | |
458 | apostrophe, a comma, or backslash (other than backslash-backslash). | |
459 | YYSTR is taken from yytname. */ | |
460 | std::string | |
461 | ]b4_parser_class_name[::yytnamerr_ (const char *yystr) | |
462 | { | |
463 | if (*yystr == '"') | |
464 | { | |
465 | std::string yyr = ""; | |
466 | char const *yyp = yystr; | |
467 | ||
468 | for (;;) | |
469 | switch (*++yyp) | |
470 | { | |
471 | case '\'': | |
472 | case ',': | |
473 | goto do_not_strip_quotes; | |
474 | ||
475 | case '\\': | |
476 | if (*++yyp != '\\') | |
477 | goto do_not_strip_quotes; | |
478 | // Fall through. | |
479 | default: | |
480 | yyr += *yyp; | |
481 | break; | |
482 | ||
483 | case '"': | |
484 | return yyr; | |
485 | } | |
486 | do_not_strip_quotes: ; | |
487 | } | |
488 | ||
489 | return yystr; | |
490 | } | |
491 | ]])[ | |
492 | ||
493 | /// Build a parser object. | |
494 | ]b4_parser_class_name::b4_parser_class_name[ (]b4_parse_param_decl[)]m4_ifset([b4_parse_param], [ | |
495 | :])[ | |
496 | #if ]b4_api_PREFIX[DEBUG | |
497 | ]m4_ifset([b4_parse_param], [ ], [ :])[yydebug_ (false), | |
498 | yycdebug_ (&std::cerr)]m4_ifset([b4_parse_param], [,])[ | |
499 | #endif]b4_parse_param_cons[ | |
500 | { | |
501 | } | |
502 | ||
503 | ]b4_parser_class_name::~b4_parser_class_name[ () | |
504 | { | |
505 | } | |
506 | ||
507 | ||
508 | /*---------------. | |
509 | | Symbol types. | | |
510 | `---------------*/ | |
511 | ||
512 | ]b4_token_ctor_if([], [b4_public_types_define])[ | |
513 | ||
514 | // by_state. | |
515 | ]b4_parser_class_name[::by_state::by_state () | |
516 | : state () | |
517 | {} | |
518 | ||
519 | ]b4_parser_class_name[::by_state::by_state (const by_state& other) | |
520 | : state (other.state) | |
521 | {} | |
522 | ||
523 | ]b4_parser_class_name[::by_state::by_state (state_type s) | |
524 | : state (s) | |
525 | {} | |
526 | ||
527 | int | |
528 | ]b4_parser_class_name[::by_state::type_get () const | |
529 | { | |
530 | return yystos_[state]; | |
531 | } | |
532 | ||
533 | template <typename Base> | |
534 | void | |
535 | ]b4_parser_class_name[::yy_destroy_ (const char* yymsg, | |
536 | basic_symbol<Base>& yysym) const | |
537 | { | |
538 | if (yymsg) | |
539 | YY_SYMBOL_PRINT (yymsg, yysym); | |
540 | ||
541 | // User destructor. | |
542 | int yytype = yysym.type_get (); | |
543 | switch (yytype) | |
544 | { | |
545 | ]b4_symbol_foreach([b4_symbol_destructor])dnl | |
546 | [ default: | |
547 | break; | |
548 | }]b4_variant_if([ | |
549 | ||
550 | // Type destructor. | |
551 | b4_symbol_variant([[yytype]], [[yysym.value]], [[template destroy]])])[ | |
552 | } | |
553 | ||
554 | #if ]b4_api_PREFIX[DEBUG | |
555 | template <typename Base> | |
556 | void | |
557 | ]b4_parser_class_name[::yy_print_ (std::ostream& yyo, | |
558 | const basic_symbol<Base>& yysym) const | |
559 | { | |
560 | std::ostream& yyoutput = yyo; | |
561 | YYUSE (yyoutput); | |
562 | int yytype = yysym.type_get (); | |
563 | yyo << (yytype < yyntokens_ ? "token" : "nterm") | |
564 | << ' ' << yytname_[yytype] << " ("]b4_locations_if([ | |
565 | << yysym.location << ": "])[; | |
566 | switch (yytype) | |
567 | { | |
568 | ]b4_symbol_foreach([b4_symbol_printer])dnl | |
569 | [ default: | |
570 | break; | |
571 | } | |
572 | yyo << ')'; | |
573 | } | |
574 | #endif | |
575 | ||
576 | void | |
577 | ]b4_parser_class_name[::yypush_ (const char* m, state_type s, | |
578 | symbol_type& sym) | |
579 | { | |
580 | if (m) | |
581 | YY_SYMBOL_PRINT (m, sym); | |
582 | ]b4_variant_if( | |
583 | [[ | |
584 | stack_symbol_type ss (]b4_join([s], | |
585 | [sym.value], b4_locations_if([sym.location]))[); | |
586 | ]b4_symbol_variant([sym.type_get ()], [sym.value], [destroy], [])[; | |
587 | yystack_.push (ss); | |
588 | ]], | |
589 | [[ yystack_.push (stack_symbol_type (]b4_join([s], | |
590 | [sym.value], b4_locations_if([sym.location]))[));]])[ | |
591 | } | |
592 | ||
593 | void | |
594 | ]b4_parser_class_name[::yypush_ (const char* m, stack_symbol_type& s) | |
595 | { | |
596 | if (m) | |
597 | YY_SYMBOL_PRINT (m, s); | |
598 | ]b4_variant_if( | |
599 | [[ | |
600 | stack_symbol_type ss (]b4_join([s.state], | |
601 | [s.value], b4_locations_if([s.location]))[); | |
602 | ]b4_symbol_variant([s.type_get ()], [s.value], [destroy], [])[; | |
603 | yystack_.push (ss); | |
604 | ]], | |
605 | [ yystack_.push (s);])[ | |
606 | } | |
607 | ||
608 | void | |
609 | ]b4_parser_class_name[::yypop_ (unsigned int n) | |
610 | { | |
611 | yystack_.pop (n); | |
612 | } | |
613 | ||
614 | #if ]b4_api_PREFIX[DEBUG | |
615 | std::ostream& | |
616 | ]b4_parser_class_name[::debug_stream () const | |
617 | { | |
618 | return *yycdebug_; | |
619 | } | |
620 | ||
621 | void | |
622 | ]b4_parser_class_name[::set_debug_stream (std::ostream& o) | |
623 | { | |
624 | yycdebug_ = &o; | |
625 | } | |
626 | ||
627 | ||
628 | ]b4_parser_class_name[::debug_level_type | |
629 | ]b4_parser_class_name[::debug_level () const | |
630 | { | |
631 | return yydebug_; | |
632 | } | |
633 | ||
634 | void | |
635 | ]b4_parser_class_name[::set_debug_level (debug_level_type l) | |
636 | { | |
637 | yydebug_ = l; | |
638 | } | |
639 | #endif // ]b4_api_PREFIX[DEBUG | |
640 | ||
641 | inline ]b4_parser_class_name[::state_type | |
642 | ]b4_parser_class_name[::yy_lr_goto_state_ (state_type yystate, int yylhs) | |
643 | { | |
644 | int yyr = yypgoto_[yylhs - yyntokens_] + yystate; | |
645 | if (0 <= yyr && yyr <= yylast_ && yycheck_[yyr] == yystate) | |
646 | return yytable_[yyr]; | |
647 | else | |
648 | return yydefgoto_[yylhs - yyntokens_]; | |
649 | } | |
650 | ||
651 | inline bool | |
652 | ]b4_parser_class_name[::yy_pact_value_is_default_ (int yyvalue) | |
653 | { | |
654 | return yyvalue == yypact_ninf_; | |
655 | } | |
656 | ||
657 | inline bool | |
658 | ]b4_parser_class_name[::yy_table_value_is_error_ (int yyvalue) | |
659 | { | |
660 | return yyvalue == yytable_ninf_; | |
661 | } | |
662 | ||
663 | int | |
664 | ]b4_parser_class_name[::parse () | |
665 | { | |
666 | /// Whether yyla contains a lookahead. | |
667 | bool yyempty = true; | |
668 | ||
669 | // State. | |
670 | int yyn; | |
671 | int yylen = 0; | |
672 | ||
673 | // Error handling. | |
674 | int yynerrs_ = 0; | |
675 | int yyerrstatus_ = 0; | |
676 | ||
677 | /// The lookahead symbol. | |
678 | symbol_type yyla;]b4_locations_if([[ | |
679 | ||
680 | /// The locations where the error started and ended. | |
681 | stack_symbol_type yyerror_range[3];]])[ | |
682 | ||
683 | /// $$ and @@$. | |
684 | stack_symbol_type yylhs; | |
685 | ||
686 | /// The return value of parse (). | |
687 | int yyresult; | |
688 | ||
689 | // FIXME: This shoud be completely indented. It is not yet to | |
690 | // avoid gratuitous conflicts when merging into the master branch. | |
691 | try | |
692 | { | |
693 | YYCDEBUG << "Starting parse" << std::endl; | |
694 | ||
695 | ]m4_ifdef([b4_initial_action], [ | |
696 | b4_dollar_pushdef([yyla.value], [], [yyla.location])dnl | |
697 | // User initialization code. | |
698 | b4_user_initial_action | |
699 | b4_dollar_popdef])[]dnl | |
700 | ||
701 | [ /* Initialize the stack. The initial state will be set in | |
702 | yynewstate, since the latter expects the semantical and the | |
703 | location values to have been already stored, initialize these | |
704 | stacks with a primary value. */ | |
705 | yystack_ = stack_type (0); | |
706 | yypush_ (YY_NULL, 0, yyla); | |
707 | ||
708 | // A new symbol was pushed on the stack. | |
709 | yynewstate: | |
710 | YYCDEBUG << "Entering state " << yystack_[0].state << std::endl; | |
711 | ||
712 | // Accept? | |
713 | if (yystack_[0].state == yyfinal_) | |
714 | goto yyacceptlab; | |
715 | ||
716 | goto yybackup; | |
717 | ||
718 | // Backup. | |
719 | yybackup: | |
720 | ||
721 | // Try to take a decision without lookahead. | |
722 | yyn = yypact_[yystack_[0].state]; | |
723 | if (yy_pact_value_is_default_ (yyn)) | |
724 | goto yydefault; | |
725 | ||
726 | // Read a lookahead token. | |
727 | if (yyempty) | |
728 | { | |
729 | YYCDEBUG << "Reading a token: "; | |
730 | try | |
731 | {]b4_token_ctor_if([[ | |
732 | symbol_type yylookahead (]b4_lex[); | |
733 | yyla.move (yylookahead);]], [[ | |
734 | yyla.type = yytranslate_ (]b4_lex[);]])[ | |
735 | } | |
736 | catch (const syntax_error& yyexc) | |
737 | { | |
738 | error (yyexc); | |
739 | goto yyerrlab1; | |
740 | } | |
741 | yyempty = false; | |
742 | } | |
743 | YY_SYMBOL_PRINT ("Next token is", yyla); | |
744 | ||
745 | /* If the proper action on seeing token YYLA.TYPE is to reduce or | |
746 | to detect an error, take that action. */ | |
747 | yyn += yyla.type; | |
748 | if (yyn < 0 || yylast_ < yyn || yycheck_[yyn] != yyla.type) | |
749 | goto yydefault; | |
750 | ||
751 | // Reduce or error. | |
752 | yyn = yytable_[yyn]; | |
753 | if (yyn <= 0) | |
754 | { | |
755 | if (yy_table_value_is_error_ (yyn)) | |
756 | goto yyerrlab; | |
757 | yyn = -yyn; | |
758 | goto yyreduce; | |
759 | } | |
760 | ||
761 | // Discard the token being shifted. | |
762 | yyempty = true; | |
763 | ||
764 | // Count tokens shifted since error; after three, turn off error status. | |
765 | if (yyerrstatus_) | |
766 | --yyerrstatus_; | |
767 | ||
768 | // Shift the lookahead token. | |
769 | yypush_ ("Shifting", yyn, yyla); | |
770 | goto yynewstate; | |
771 | ||
772 | /*-----------------------------------------------------------. | |
773 | | yydefault -- do the default action for the current state. | | |
774 | `-----------------------------------------------------------*/ | |
775 | yydefault: | |
776 | yyn = yydefact_[yystack_[0].state]; | |
777 | if (yyn == 0) | |
778 | goto yyerrlab; | |
779 | goto yyreduce; | |
780 | ||
781 | /*-----------------------------. | |
782 | | yyreduce -- Do a reduction. | | |
783 | `-----------------------------*/ | |
784 | yyreduce: | |
785 | yylen = yyr2_[yyn]; | |
786 | yylhs.state = yy_lr_goto_state_(yystack_[yylen].state, yyr1_[yyn]);]b4_variant_if([ | |
787 | /* Variants are always initialized to an empty instance of the | |
788 | correct type. The default $$=$1 action is NOT applied when using | |
789 | variants. */ | |
790 | b4_symbol_variant([[yyr1_@{yyn@}]], [yylhs.value], [build])],[ | |
791 | /* If YYLEN is nonzero, implement the default value of the action: | |
792 | `$$ = $1'. Otherwise, use the top of the stack. | |
793 | ||
794 | Otherwise, the following line sets YYLHS.VALUE to garbage. | |
795 | This behavior is undocumented and Bison | |
796 | users should not rely upon it. */ | |
797 | if (yylen) | |
798 | yylhs.value = yystack_@{yylen - 1@}.value; | |
799 | else | |
800 | yylhs.value = yystack_@{0@}.value;])[ | |
801 | ]b4_locations_if([dnl | |
802 | [ | |
803 | // Compute the default @@$. | |
804 | { | |
805 | slice<stack_symbol_type, stack_type> slice (yystack_, yylen); | |
806 | YYLLOC_DEFAULT (yylhs.location, slice, yylen); | |
807 | }]])[ | |
808 | ||
809 | // Perform the reduction. | |
810 | YY_REDUCE_PRINT (yyn); | |
811 | try | |
812 | { | |
813 | switch (yyn) | |
814 | { | |
815 | ]b4_user_actions[ | |
816 | default: | |
817 | break; | |
818 | } | |
819 | } | |
820 | catch (const syntax_error& yyexc) | |
821 | { | |
822 | error (yyexc); | |
823 | YYERROR; | |
824 | } | |
825 | YY_SYMBOL_PRINT ("-> $$ =", yylhs); | |
826 | ]b4_variant_if([[ | |
827 | // Destroy the rhs symbols. | |
828 | for (int i = 0; i < yylen; ++i) | |
829 | // Destroy a variant whose value may have been swapped with | |
830 | // yylhs.value (for instance if the action was "std::swap($$, | |
831 | // $1)"). The value of yylhs.value (hence possibly one of these | |
832 | // rhs symbols) depends on the default construction for this | |
833 | // type. In the case of pointers for instance, no | |
834 | // initialization is done, so the value is junk. Therefore do | |
835 | // not try to report the value of symbols about to be destroyed | |
836 | // in the debug trace, it's possibly junk. Hence yymsg = 0. | |
837 | // Besides, that keeps exactly the same traces as with the other | |
838 | // Bison skeletons. | |
839 | yy_destroy_ (YY_NULL, yystack_[i]);]])[ | |
840 | ||
841 | yypop_ (yylen); | |
842 | yylen = 0; | |
843 | YY_STACK_PRINT (); | |
844 | ||
845 | // Shift the result of the reduction. | |
846 | yypush_ (YY_NULL, yylhs); | |
847 | goto yynewstate; | |
848 | ||
849 | /*--------------------------------------. | |
850 | | yyerrlab -- here on detecting error. | | |
851 | `--------------------------------------*/ | |
852 | yyerrlab: | |
853 | // If not already recovering from an error, report this error. | |
854 | if (!yyerrstatus_) | |
855 | { | |
856 | ++yynerrs_; | |
857 | error (]b4_join(b4_locations_if([yyla.location]), | |
858 | [[yysyntax_error_ (yystack_[0].state, | |
859 | yyempty ? yyempty_ : yyla.type)]])[); | |
860 | } | |
861 | ||
862 | ]b4_locations_if([[ | |
863 | yyerror_range[1].location = yyla.location;]])[ | |
864 | if (yyerrstatus_ == 3) | |
865 | { | |
866 | /* If just tried and failed to reuse lookahead token after an | |
867 | error, discard it. */ | |
868 | ||
869 | // Return failure if at end of input. | |
870 | if (yyla.type == yyeof_) | |
871 | YYABORT; | |
872 | else if (!yyempty) | |
873 | { | |
874 | yy_destroy_ ("Error: discarding", yyla); | |
875 | yyempty = true; | |
876 | } | |
877 | } | |
878 | ||
879 | // Else will try to reuse lookahead token after shifting the error token. | |
880 | goto yyerrlab1; | |
881 | ||
882 | ||
883 | /*---------------------------------------------------. | |
884 | | yyerrorlab -- error raised explicitly by YYERROR. | | |
885 | `---------------------------------------------------*/ | |
886 | yyerrorlab: | |
887 | ||
888 | /* Pacify compilers like GCC when the user code never invokes | |
889 | YYERROR and the label yyerrorlab therefore never appears in user | |
890 | code. */ | |
891 | if (false) | |
892 | goto yyerrorlab;]b4_locations_if([[ | |
893 | yyerror_range[1].location = yystack_[yylen - 1].location;]])b4_variant_if([[ | |
894 | /* $$ was initialized before running the user action. */ | |
895 | yy_destroy_ ("Error: discarding", yylhs);]])[ | |
896 | /* Do not reclaim the symbols of the rule whose action triggered | |
897 | this YYERROR. */ | |
898 | yypop_ (yylen); | |
899 | yylen = 0; | |
900 | goto yyerrlab1; | |
901 | ||
902 | /*-------------------------------------------------------------. | |
903 | | yyerrlab1 -- common code for both syntax error and YYERROR. | | |
904 | `-------------------------------------------------------------*/ | |
905 | yyerrlab1: | |
906 | yyerrstatus_ = 3; // Each real token shifted decrements this. | |
907 | { | |
908 | stack_symbol_type error_token; | |
909 | for (;;) | |
910 | { | |
911 | yyn = yypact_[yystack_[0].state]; | |
912 | if (!yy_pact_value_is_default_ (yyn)) | |
913 | { | |
914 | yyn += yyterror_; | |
915 | if (0 <= yyn && yyn <= yylast_ && yycheck_[yyn] == yyterror_) | |
916 | { | |
917 | yyn = yytable_[yyn]; | |
918 | if (0 < yyn) | |
919 | break; | |
920 | } | |
921 | } | |
922 | ||
923 | // Pop the current state because it cannot handle the error token. | |
924 | if (yystack_.size () == 1) | |
925 | YYABORT; | |
926 | ]b4_locations_if([[ | |
927 | yyerror_range[1].location = yystack_[0].location;]])[ | |
928 | yy_destroy_ ("Error: popping", yystack_[0]); | |
929 | yypop_ (); | |
930 | YY_STACK_PRINT (); | |
931 | } | |
932 | ]b4_locations_if([[ | |
933 | yyerror_range[2].location = yyla.location; | |
934 | YYLLOC_DEFAULT (error_token.location, yyerror_range, 2);]])[ | |
935 | ||
936 | // Shift the error token. | |
937 | error_token.state = yyn; | |
938 | yypush_ ("Shifting", error_token); | |
939 | } | |
940 | goto yynewstate; | |
941 | ||
942 | // Accept. | |
943 | yyacceptlab: | |
944 | yyresult = 0; | |
945 | goto yyreturn; | |
946 | ||
947 | // Abort. | |
948 | yyabortlab: | |
949 | yyresult = 1; | |
950 | goto yyreturn; | |
951 | ||
952 | yyreturn: | |
953 | if (!yyempty) | |
954 | yy_destroy_ ("Cleanup: discarding lookahead", yyla); | |
955 | ||
956 | /* Do not reclaim the symbols of the rule whose action triggered | |
957 | this YYABORT or YYACCEPT. */ | |
958 | yypop_ (yylen); | |
959 | while (1 < yystack_.size ()) | |
960 | { | |
961 | yy_destroy_ ("Cleanup: popping", yystack_[0]); | |
962 | yypop_ (); | |
963 | } | |
964 | ||
965 | return yyresult; | |
966 | } | |
967 | catch (...) | |
968 | { | |
969 | YYCDEBUG << "Exception caught: cleaning lookahead and stack" | |
970 | << std::endl; | |
971 | // Do not try to display the values of the reclaimed symbols, | |
972 | // as their printer might throw an exception. | |
973 | if (!yyempty) | |
974 | yy_destroy_ (YY_NULL, yyla); | |
975 | ||
976 | while (1 < yystack_.size ()) | |
977 | { | |
978 | yy_destroy_ (YY_NULL, yystack_[0]); | |
979 | yypop_ (); | |
980 | } | |
981 | throw; | |
982 | } | |
983 | } | |
984 | ||
985 | void | |
986 | ]b4_parser_class_name[::error (const syntax_error& yyexc) | |
987 | { | |
988 | error (]b4_join(b4_locations_if([yyexc.location]), | |
989 | [[yyexc.what()]])[); | |
990 | } | |
991 | ||
992 | // Generate an error message. | |
993 | std::string | |
994 | ]b4_parser_class_name[::yysyntax_error_ (]dnl | |
995 | b4_error_verbose_if([state_type yystate, int yytoken], | |
996 | [int, int])[) | |
997 | {]b4_error_verbose_if([[ | |
998 | std::string yyres; | |
999 | // Number of reported tokens (one for the "unexpected", one per | |
1000 | // "expected"). | |
1001 | size_t yycount = 0; | |
1002 | // Its maximum. | |
1003 | enum { YYERROR_VERBOSE_ARGS_MAXIMUM = 5 }; | |
1004 | // Arguments of yyformat. | |
1005 | char const *yyarg[YYERROR_VERBOSE_ARGS_MAXIMUM]; | |
1006 | ||
1007 | /* There are many possibilities here to consider: | |
1008 | - If this state is a consistent state with a default action, then | |
1009 | the only way this function was invoked is if the default action | |
1010 | is an error action. In that case, don't check for expected | |
1011 | tokens because there are none. | |
1012 | - The only way there can be no lookahead present (in yytoken) is | |
1013 | if this state is a consistent state with a default action. | |
1014 | Thus, detecting the absence of a lookahead is sufficient to | |
1015 | determine that there is no unexpected or expected token to | |
1016 | report. In that case, just report a simple "syntax error". | |
1017 | - Don't assume there isn't a lookahead just because this state is | |
1018 | a consistent state with a default action. There might have | |
1019 | been a previous inconsistent state, consistent state with a | |
1020 | non-default action, or user semantic action that manipulated | |
1021 | yyla. (However, yyla is currently not documented for users.) | |
1022 | - Of course, the expected token list depends on states to have | |
1023 | correct lookahead information, and it depends on the parser not | |
1024 | to perform extra reductions after fetching a lookahead from the | |
1025 | scanner and before detecting a syntax error. Thus, state | |
1026 | merging (from LALR or IELR) and default reductions corrupt the | |
1027 | expected token list. However, the list is correct for | |
1028 | canonical LR with one exception: it will still contain any | |
1029 | token that will not be accepted due to an error action in a | |
1030 | later state. | |
1031 | */ | |
1032 | if (yytoken != yyempty_) | |
1033 | { | |
1034 | yyarg[yycount++] = yytname_[yytoken]; | |
1035 | int yyn = yypact_[yystate]; | |
1036 | if (!yy_pact_value_is_default_ (yyn)) | |
1037 | { | |
1038 | /* Start YYX at -YYN if negative to avoid negative indexes in | |
1039 | YYCHECK. In other words, skip the first -YYN actions for | |
1040 | this state because they are default actions. */ | |
1041 | int yyxbegin = yyn < 0 ? -yyn : 0; | |
1042 | // Stay within bounds of both yycheck and yytname. | |
1043 | int yychecklim = yylast_ - yyn + 1; | |
1044 | int yyxend = yychecklim < yyntokens_ ? yychecklim : yyntokens_; | |
1045 | for (int yyx = yyxbegin; yyx < yyxend; ++yyx) | |
1046 | if (yycheck_[yyx + yyn] == yyx && yyx != yyterror_ | |
1047 | && !yy_table_value_is_error_ (yytable_[yyx + yyn])) | |
1048 | { | |
1049 | if (yycount == YYERROR_VERBOSE_ARGS_MAXIMUM) | |
1050 | { | |
1051 | yycount = 1; | |
1052 | break; | |
1053 | } | |
1054 | else | |
1055 | yyarg[yycount++] = yytname_[yyx]; | |
1056 | } | |
1057 | } | |
1058 | } | |
1059 | ||
1060 | char const* yyformat = YY_NULL; | |
1061 | switch (yycount) | |
1062 | { | |
1063 | #define YYCASE_(N, S) \ | |
1064 | case N: \ | |
1065 | yyformat = S; \ | |
1066 | break | |
1067 | YYCASE_(0, YY_("syntax error")); | |
1068 | YYCASE_(1, YY_("syntax error, unexpected %s")); | |
1069 | YYCASE_(2, YY_("syntax error, unexpected %s, expecting %s")); | |
1070 | YYCASE_(3, YY_("syntax error, unexpected %s, expecting %s or %s")); | |
1071 | YYCASE_(4, YY_("syntax error, unexpected %s, expecting %s or %s or %s")); | |
1072 | YYCASE_(5, YY_("syntax error, unexpected %s, expecting %s or %s or %s or %s")); | |
1073 | #undef YYCASE_ | |
1074 | } | |
1075 | ||
1076 | // Argument number. | |
1077 | size_t yyi = 0; | |
1078 | for (char const* yyp = yyformat; *yyp; ++yyp) | |
1079 | if (yyp[0] == '%' && yyp[1] == 's' && yyi < yycount) | |
1080 | { | |
1081 | yyres += yytnamerr_ (yyarg[yyi++]); | |
1082 | ++yyp; | |
1083 | } | |
1084 | else | |
1085 | yyres += *yyp; | |
1086 | return yyres;]], [[ | |
1087 | return YY_("syntax error");]])[ | |
1088 | } | |
1089 | ||
1090 | ||
1091 | const ]b4_int_type(b4_pact_ninf, b4_pact_ninf) b4_parser_class_name::yypact_ninf_ = b4_pact_ninf[; | |
1092 | ||
1093 | const ]b4_int_type(b4_table_ninf, b4_table_ninf) b4_parser_class_name::yytable_ninf_ = b4_table_ninf[; | |
1094 | ||
1095 | ]b4_parser_tables_define[ | |
1096 | ||
1097 | ]b4_token_table_if([], [[#if ]b4_api_PREFIX[DEBUG]])[ | |
1098 | // YYTNAME[SYMBOL-NUM] -- String name of the symbol SYMBOL-NUM. | |
1099 | // First, the terminals, then, starting at \a yyntokens_, nonterminals. | |
1100 | const char* | |
1101 | const ]b4_parser_class_name[::yytname_[] = | |
1102 | { | |
1103 | ]b4_tname[ | |
1104 | }; | |
1105 | ||
1106 | ]b4_token_table_if([[#if ]b4_api_PREFIX[DEBUG]])[ | |
1107 | ]b4_integral_parser_table_define([rline], [b4_rline])[ | |
1108 | ||
1109 | // Print the state stack on the debug stream. | |
1110 | void | |
1111 | ]b4_parser_class_name[::yystack_print_ () | |
1112 | { | |
1113 | *yycdebug_ << "Stack now"; | |
1114 | for (stack_type::const_iterator | |
1115 | i = yystack_.begin (), | |
1116 | i_end = yystack_.end (); | |
1117 | i != i_end; ++i) | |
1118 | *yycdebug_ << ' ' << i->state; | |
1119 | *yycdebug_ << std::endl; | |
1120 | } | |
1121 | ||
1122 | // Report on the debug stream that the rule \a yyrule is going to be reduced. | |
1123 | void | |
1124 | ]b4_parser_class_name[::yy_reduce_print_ (int yyrule) | |
1125 | { | |
1126 | unsigned int yylno = yyrline_[yyrule]; | |
1127 | int yynrhs = yyr2_[yyrule]; | |
1128 | // Print the symbols being reduced, and their result. | |
1129 | *yycdebug_ << "Reducing stack by rule " << yyrule - 1 | |
1130 | << " (line " << yylno << "):" << std::endl; | |
1131 | // The symbols being reduced. | |
1132 | for (int yyi = 0; yyi < yynrhs; yyi++) | |
1133 | YY_SYMBOL_PRINT (" $" << yyi + 1 << " =", | |
1134 | ]b4_rhs_data(yynrhs, yyi + 1)[); | |
1135 | } | |
1136 | #endif // ]b4_api_PREFIX[DEBUG | |
1137 | ||
1138 | ]b4_token_ctor_if([], [b4_yytranslate_define])[ | |
1139 | ]b4_namespace_close[ | |
1140 | ]b4_epilogue[]dnl | |
1141 | b4_output_end() | |
1142 | ||
1143 | ||
1144 | m4_popdef([b4_copyright_years])dnl |