src/lalr.h

/* Compute lookahead criteria for bison,

   Copyright (C) 1984, 1986, 1989, 2000, 2002, 2004, 2006, 2007, 2009
   Free Software Foundation, Inc.

   This file is part of Bison, the GNU Compiler Compiler.

   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 LALR_H_
# define LALR_H_

# include <bitset.h>
# include <bitsetv.h>

/* Import the definition of RULE_T. */
# include "gram.h"

/* Import the definition of CORE, TRANSITIONS and REDUCTIONS. */
# include "state.h"


/** Build the LALR(1) automaton.

   Compute how to make the finite state machine deterministic; find
   which rules need lookahead in each state, and which lookahead
   tokens they accept.

   Also builds:
     - #goto_map
     - #from_state
     - #to_state
     - #goto_follows
*/
void lalr (void);

/**
 * Set #nLA and allocate all reduction lookahead sets.  Normally invoked by
 * #lalr.
 */
void initialize_LA (void);

/**
 * Build only:
 *   - #goto_map
 *   - #from_state
 *   - #to_state
 * Normally invoked by #lalr.
 */
void set_goto_map (void);

/**
 * Update state numbers recorded in #goto_map, #from_state, and #to_state such
 * that:
 *   - \c nstates_old is the old number of states.
 *   - Where \c i is the old state number, <tt>old_to_new[i]</tt> is either:
 *     - \c nstates_old if state \c i is removed because it is unreachable.
 *       Thus, remove all goto entries involving this state.
 *     - The new state number.
 */
void lalr_update_state_numbers (state_number old_to_new[],
                                state_number nstates_old);


/** Release the information related to lookahead tokens.

   Can be performed once the action tables are computed.  */
void lalr_free (void);

typedef size_t goto_number;
# define GOTO_NUMBER_MAXIMUM ((goto_number) -1)

/** Index into #from_state and #to_state.

   All the transitions that accept a particular variable are grouped
   together and GOTO_MAP[I - NTOKENS] is the index in FROM_STATE and
   TO_STATE of the first of them.  */
extern goto_number *goto_map;

/** The size of #from_state and #to_state.  */
extern goto_number ngotos;

/** State number which a transition leads from.  */
extern state_number *from_state;

/** State number it leads to.  */
extern state_number *to_state;

/** Map a state/symbol pair into its numeric representation.  */
goto_number map_goto (state_number s0, symbol_number sym);

/* goto_follows[i] is the set of tokens following goto i.  */
extern bitsetv goto_follows;


#endif /* !LALR_H_ */
Commit	Line	Data
	1	/* Compute lookahead criteria for bison,
	2
	3	Copyright (C) 1984, 1986, 1989, 2000, 2002, 2004, 2006, 2007, 2009
	4	Free Software Foundation, Inc.
	5
	6	This file is part of Bison, the GNU Compiler Compiler.
	7
	8	This program is free software: you can redistribute it and/or modify
	9	it under the terms of the GNU General Public License as published by
	10	the Free Software Foundation, either version 3 of the License, or
	11	(at your option) any later version.
	12
	13	This program is distributed in the hope that it will be useful,
	14	but WITHOUT ANY WARRANTY; without even the implied warranty of
	15	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	16	GNU General Public License for more details.
	17
	18	You should have received a copy of the GNU General Public License
	19	along with this program. If not, see <http://www.gnu.org/licenses/>. */
	20
	21	#ifndef LALR_H_
	22	# define LALR_H_
	23
	24	# include <bitset.h>
	25	# include <bitsetv.h>
	26
	27	/* Import the definition of RULE_T. */
	28	# include "gram.h"
	29
	30	/* Import the definition of CORE, TRANSITIONS and REDUCTIONS. */
	31	# include "state.h"
	32
	33
	34	/** Build the LALR(1) automaton.
	35
	36	Compute how to make the finite state machine deterministic; find
	37	which rules need lookahead in each state, and which lookahead
	38	tokens they accept.
	39
	40	Also builds:
	41	- #goto_map
	42	- #from_state
	43	- #to_state
	44	- #goto_follows
	45	*/
	46	void lalr (void);
	47
	48	/**
	49	* Set #nLA and allocate all reduction lookahead sets. Normally invoked by
	50	* #lalr.
	51	*/
	52	void initialize_LA (void);
	53
	54	/**
	55	* Build only:
	56	* - #goto_map
	57	* - #from_state
	58	* - #to_state
	59	* Normally invoked by #lalr.
	60	*/
	61	void set_goto_map (void);
	62
	63	/**
	64	* Update state numbers recorded in #goto_map, #from_state, and #to_state such
	65	* that:
	66	* - \c nstates_old is the old number of states.
	67	* - Where \c i is the old state number, <tt>old_to_new[i]</tt> is either:
	68	* - \c nstates_old if state \c i is removed because it is unreachable.
	69	* Thus, remove all goto entries involving this state.
	70	* - The new state number.
	71	*/
	72	void lalr_update_state_numbers (state_number old_to_new[],
	73	state_number nstates_old);
	74
	75
	76	/** Release the information related to lookahead tokens.
	77
	78	Can be performed once the action tables are computed. */
	79	void lalr_free (void);
	80
	81	typedef size_t goto_number;
	82	# define GOTO_NUMBER_MAXIMUM ((goto_number) -1)
	83
	84	/** Index into #from_state and #to_state.
	85
	86	All the transitions that accept a particular variable are grouped
	87	together and GOTO_MAP[I - NTOKENS] is the index in FROM_STATE and
	88	TO_STATE of the first of them. */
	89	extern goto_number *goto_map;
	90
	91	/** The size of #from_state and #to_state. */
	92	extern goto_number ngotos;
	93
	94	/** State number which a transition leads from. */
	95	extern state_number *from_state;
	96
	97	/** State number it leads to. */
	98	extern state_number *to_state;
	99
	100	/** Map a state/symbol pair into its numeric representation. */
	101	goto_number map_goto (state_number s0, symbol_number sym);
	102
	103	/* goto_follows[i] is the set of tokens following goto i. */
	104	extern bitsetv goto_follows;
	105
	106
	107	#endif /* !LALR_H_ */