SystemC::Vregs::Language.3pm

Langue: en

Autres versions - même langue

Version: 2009-05-19 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

SystemC::Vregs::Language - File processing for various Languages

SYNOPSIS

     use SystemC::Vregs::Language;
 
     my $fh = SystemC::Vregs::Language->new (filename=>"foo.c",
                                             language=>'C',);
     $fh->comment ("This file is generated automatically\n");
     $fh->define ("TRUE",1, "Set true");
     $fh->print ("void main();\n");
 
 

DESCRIPTION

This package creates a file handle with language specific semantics. This allows similar operators to be called, such as comment, for many different file formats.

The output data is stored in an array and dumped when the file is complete. This allows the file to only be written if the data changes, to reduce makefile rebuilding.

FIELDS

These fields may be specified with the new() function.
filename
The filename to write the data to.
keep_timestamp
If true, the file will only be written if the data being written differs from the present file contents.
language
The language for the file. May be C, Perl, Assembler, TCL, or Verilog. A new language Foo may be defined by making a SystemC::Vregs::Language::Foo class which is an @ISA of SystemC::Vregs::Language.

ACCESSORS

language
Returns the type of file, for example 'C'.

OUTPUT FUNCTIONS

comment
Output a string with the appropriate comment delimiters.
comment_pre
Output a comment and Doxygen document before-the-fact.
comment_post
Output a comment and Doxygen document after-the-fact.
include_guard
Output a standard #ifndef around the file to prevent multiple inclusion. Closing the file will automatically add the #endif
sprint_hex_value
Return a string representing the value as a hex number. Second argument is number of bits.
preproc
Output a preprocessor directive.
print
Output plain text. This function is called by all other functions. You will probably want to make a inherited class and override this method.
printf
Output printf text.

DISTRIBUTION

Vregs is part of the <http://www.veripool.org/> free Verilog software tool suite. The latest version is available from CPAN and from <http://www.veripool.org/vregs>. /www.veripool.org/>.

Copyright 2001-2009 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0.

AUTHORS

Wilson Snyder <wsnyder@wsnyder.org>

SEE ALSO

SystemC::Vregs, IO::File