state_writer Class Reference

Inheritance diagram for state_writer:

Collaboration diagram for state_writer:

Public Member Functions
	state_writer ()
void	write_new_line ()
void	write_any_indent (int leading_spaces)
void	begin_s_expr (const char *tag)
void	end_s_expr ()

Private Member Functions
void	write_state_fileloc (struct fileloc *floc)
void	write_state_fields (pair_p fields)
void	write_state_a_string (const char *s)
void	write_state_string_option (options_p current)
void	write_state_type_option (options_p current)
void	write_state_nested_option (options_p current)
void	write_state_option (options_p current)
void	write_state_options (options_p opt)
void	write_state_lang_bitmap (lang_bitmap bitmap)
void	write_state_version (const char *version)
void	write_state_scalar_type (type_p current)
void	write_state_string_type (type_p current)
void	write_state_undefined_type (type_p current)
void	write_state_struct_union_type (type_p current, const char *kindstr)
void	write_state_struct_type (type_p current)
void	write_state_user_struct_type (type_p current)
void	write_state_union_type (type_p current)
void	write_state_lang_struct_type (type_p current)
void	write_state_param_struct_type (type_p current)
void	write_state_pointer_type (type_p current)
void	write_state_array_type (type_p current)
void	write_state_gc_used (enum gc_used_enum gus)
void	write_state_common_type_content (type_p current)
void	write_state_type (type_p current)
void	write_state_pair (pair_p current)
int	write_state_pair_list (pair_p list)
void	write_state_typedefs (void)
void	write_state_structures (void)
void	write_state_param_structs (void)
void	write_state_variables (void)
void	write_state_srcdir (void)
void	write_state_files_list (void)
void	write_state_languages (void)

Private Attributes
int	m_state_written_type_count

Friends
void	write_state (const char *state_path)

---

Detailed Description

   A class for writing out "gtype.state".  

---

Constructor & Destructor Documentation

state_writer::state_writer

(

)

   class state_writer's trivial constructor.  

---

Member Function Documentation

void s_expr_writer::begin_s_expr ( const char *  tag )

inherited

   Write the beginning of a new s-expresion e.g. "(!foo "
   The writer automatically adds whitespace to show the hierarchical
   structure of the expressions, so each one starts on a new line,
   and any within it will be at an increased indentation level.  

Referenced by write_state_array_type(), write_state_param_structs(), write_state_type(), and write_state_typedefs().

void s_expr_writer::end_s_expr ( void  )

inherited

   Write out the end of an s-expression: any necssessary indentation,
   a closing parenthesis, and a new line.  

References fatal().

Referenced by write_state_param_structs(), write_state_type(), and write_state_typedefs().

void s_expr_writer::write_any_indent ( int  leading_spaces )

inherited

   If we've just had a newline, write the indentation amount, potentially
   omitting some spaces.

   LEADING_SPACES exists to support code that writes strings with leading
   spaces (e.g " foo") which might occur within a line, or could be the first
   thing on a line.  By passing leading_spaces == 1, when such a string is the
   first thing on a line, write_any_indent () swallows the successive
   leading spaces into the indentation so that the "foo" begins at the expected
   column.  

References s_expr_writer::m_indent_amount, and s_expr_writer::write_new_line().

Referenced by write_state_array_type(), write_state_fileloc(), write_state_scalar_type(), write_state_type(), write_state_union_type(), and write_state_version().

void s_expr_writer::write_new_line ( void  )

inherited

   Write a newline to the output file, merging adjacent newlines.  

     Don't add a newline if we've just had one.  

References s_expr_writer::m_had_recent_newline, and s_expr_writer::m_indent_amount.

Referenced by s_expr_writer::write_any_indent().

void state_writer::write_state_a_string ( const char *  s )

private

   Write a null-terminated string in our lexical convention, very
   similar to the convention of C.  

Referenced by write_state_scalar_type(), write_state_type(), and write_state_typedefs().

void state_writer::write_state_array_type ( type_p  current )

private

   Write an array type.  

References s_expr_writer::begin_s_expr(), m_state_written_type_count, state_file, type::state_number, and s_expr_writer::write_any_indent().

Referenced by write_state_gc_used().

void state_writer::write_state_common_type_content ( type_p  current )

private

   Utility routine to write the common content of all types.  Notice
   that the next field is *not* written on purpose.  

     We do not write the next type, because list of types are
     explicitly written.  However, lang_struct are special in that
     respect.  See function write_state_lang_struct_type for more.  

Referenced by write_state_scalar_type().

void state_writer::write_state_fields ( pair_p  fields )

private

   Write a list of fields.  

void state_writer::write_state_fileloc ( struct fileloc *  floc )

private

   Write a file location.  Files relative to $(srcdir) are quite
   frequent and are handled specially.  This ensures that two gengtype
   state file-s produced by gengtype on the same GCC source tree are
   very similar and can be reasonably compared with diff, even if the
   two GCC source trees have different absolute paths.  

         Most of the files are inside $(srcdir) so it is worth to
         handle them specially.  

References state_file, and s_expr_writer::write_any_indent().

Referenced by write_state_type().

void state_writer::write_state_files_list ( void  )

private

   Count and write the list of our files.  

     Write the list of files with their lang_bitmap.  

         Most of the files are inside $(srcdir) so it is worth to
         handle them specially.  

         Terminate the inner s-expression (either "srcfile" or "file").   

     Terminate the "fileslist" s-expression.  

void state_writer::write_state_gc_used ( enum gc_used_enum  gus )

private

   Write the gc_used information.  

References TYPE_ARRAY, TYPE_LANG_STRUCT, TYPE_NONE, TYPE_PARAM_STRUCT, TYPE_POINTER, TYPE_STRUCT, TYPE_UNDEFINED, TYPE_UNION, TYPE_USER_STRUCT, write_state_array_type(), write_state_lang_struct_type(), write_state_pointer_type(), write_state_struct_type(), write_state_undefined_type(), write_state_union_type(), and write_state_user_struct_type().

void state_writer::write_state_lang_bitmap ( lang_bitmap  bitmap )

private

   Write a bitmap representing a set of GCC front-end languages.  

void state_writer::write_state_lang_struct_type ( type_p  current )

private

   Write a lang_struct type.  This is tricky and was painful to debug,
   we deal with the next field specifically within their lang_struct
   subfield, which points to a linked list of homonumous types.
   Change this function with extreme care, see also
   read_state_lang_struct_type.  

     lang_struct-ures are particularly tricky, since their
     u.s.lang_struct field gives a list of homonymous struct-s or
     union-s! 

         Every member of the homonymous list should have the same tag.  

Referenced by write_state_gc_used().

void state_writer::write_state_languages ( void  )

private

   Write the list of GCC front-end languages.  

         Languages names are identifiers, we expect only letters or
         underscores or digits in them.  In particular, C++ is not a
         valid language name, but cp is valid.  

void state_writer::write_state_nested_option ( options_p  current )

private

void state_writer::write_state_option ( options_p  current )

private

     Terminate the "option" s-expression.  

void state_writer::write_state_options ( options_p  opt )

private

   Write a list of GTY options.  

Referenced by write_state_type().

void state_writer::write_state_pair ( pair_p  current )

private

   Write a pair.  

     Terminate the "pair" s-expression.  

int state_writer::write_state_pair_list ( pair_p  list )

private

   Write a pair list and return the number of pairs written.  

void state_writer::write_state_param_struct_type ( type_p  current )

private

   Write a parametrized structure GTY type.  

void state_writer::write_state_param_structs ( void  )

private

   Write our param_struct-s.  

References s_expr_writer::begin_s_expr(), s_expr_writer::end_s_expr(), lang_dir_names, num_lang_dirs, and state_file.

void state_writer::write_state_pointer_type ( type_p  current )

private

   Write a pointer type.  

Referenced by write_state_gc_used().

void state_writer::write_state_scalar_type ( type_p  current )

private

   Write a scalar type.  We have only two of these.  

References type::s, state_file, type::state_number, type::u, s_expr_writer::write_any_indent(), write_state_a_string(), and write_state_common_type_content().

void state_writer::write_state_srcdir ( void  )

private

   Write the source directory.  File locations within the source
   directory have been written specifically.  

void state_writer::write_state_string_option ( options_p  current )

private

   Our option-s have three kinds, each with its writer.  

void state_writer::write_state_string_type ( type_p  current )

private

   Write the string type.  There is only one such thing! 

void state_writer::write_state_struct_type ( type_p  current )

private

   Write a GTY struct type.  

Referenced by write_state_gc_used().

void state_writer::write_state_struct_union_type ( type_p  current, const char *  kindstr  )

private

   Common code to write structure like types.  

References type::s, type::u, and write_state_type().

void state_writer::write_state_structures ( void  )

private

   Write our structures.  

     Terminate the "structures" s-expression.  

void state_writer::write_state_type ( type_p  current )

private

   The important and recursive routine writing GTY types as understood
   by gengtype.  Types which have a positive state_number have already
   been seen and written.  

     Terminate the "type" s-expression.  

References s_expr_writer::begin_s_expr(), s_expr_writer::end_s_expr(), pair::line, pair::name, pair::opt, state_file, pair::type, s_expr_writer::write_any_indent(), write_state_a_string(), write_state_fileloc(), and write_state_options().

Referenced by write_state_struct_union_type().

void state_writer::write_state_type_option ( options_p  current )

private

void state_writer::write_state_typedefs ( void  )

private

   When writing imported linked lists, like typedefs, structures,
   param_structs, ... we count their length first and write it.  These
   eases the reading, and enables an extra verification on the number
   of actually read items.  

   Write our typedefs.  

References s_expr_writer::begin_s_expr(), s_expr_writer::end_s_expr(), srcdir, and write_state_a_string().

void state_writer::write_state_undefined_type ( type_p  current )

private

   Write an undefined type.  

Referenced by write_state_gc_used().

void state_writer::write_state_union_type ( type_p  current )

private

   write a GTY union type.  

References state_file, and s_expr_writer::write_any_indent().

Referenced by write_state_gc_used().

void state_writer::write_state_user_struct_type ( type_p  current )

private

   Write a GTY user-defined struct type.  

Referenced by write_state_gc_used().

void state_writer::write_state_variables ( void  )

private

   Write our variables.  

References errno, fatal(), and state_file.

void state_writer::write_state_version ( const char *  version )

private

   Write version information.  

References state_file, and s_expr_writer::write_any_indent().

---

Friends And Related Function Documentation

void write_state ( const char *  state_path )

friend

---

Field Documentation

int state_writer::m_state_written_type_count

private

     Counter of written types.  

Referenced by write_state_array_type().

---

The documentation for this class was generated from the following file:

• gengtype-state.c