• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
      • Warnings
      • Primitives
      • Use-set
      • Syntax
      • Getting-started
      • Utilities
      • Loader
        • Preprocessor
        • Vl-loadconfig
        • Lexer
        • Vl-loadstate
        • Parser
          • Parse-expressions
          • Parse-udps
          • Vl-genelements
          • Parse-paramdecls
          • Parse-blockitems
            • Vl-parse-main-data-declaration
            • Vl-2005-parse-block-item-declaration-noatts
            • Vl-2012-parse-block-item-declaration-noatts
            • Vl-parse-list-of-event-identifiers
            • Vl-parse-block-item-declaration-noatts
            • Vl-parse-list-of-variable-identifiers
            • Vl-build-vardecls
            • Vl-parse-reg-declaration
            • Vl-parse-realtime-declaration
            • Vl-parse-integer-declaration
            • Vl-parse-time-declaration
            • Vl-parse-real-declaration
            • Vl-parse-0+-block-item-declarations
            • Vl-parse-event-declaration
            • Vl-parse-block-item-declaration
            • Vl-parse-variable-type
            • Vl-maybe-parse-lifetime
          • Parse-utils
          • Parse-insts
          • Parse-datatype
          • Parse-functions
          • Parse-datatypes
          • Parse-strengths
          • Vl-parse-genvar-declaration
          • Vl-parse
          • Parse-ports
          • Seq
          • Parse-packages
        • Vl-load-merge-descriptions
        • Scope-of-defines
        • Vl-load-file
        • Vl-flush-out-descriptions
        • Vl-description
        • Vl-loadresult
        • Vl-read-file
        • Vl-find-basename/extension
        • Vl-find-file
        • Vl-read-files
        • Extended-characters
        • Vl-load
        • Vl-load-main
        • Vl-load-description
        • Vl-descriptions-left-to-load
        • Inject-warnings
        • Vl-load-descriptions
        • Vl-load-files
        • Vl-load-summary
        • Vl-collect-modules-from-descriptions
        • Vl-descriptionlist
      • Transforms
      • Lint
      • Mlib
      • Server
      • Kit
      • Printer
      • Esim-vl
      • Well-formedness
    • Sv
    • Fgl
    • Vwsim
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Parser

Parse-blockitems

Functions for parsing Verilog and SystemVerilog block items.

The Verilog-2005 grammar for regs and variables is, after filtering out some duplication and indirection:

integer_declaration  ::= 'integer'  list_of_variable_identifiers ';'
real_declaration     ::= 'real'     list_of_variable_identifiers ';'
time_declaration     ::= 'time'     list_of_variable_identifiers ';'
realtime_declaration ::= 'realtime' list_of_variable_identifiers ';'
reg_declaration      ::= 'reg' [ 'signed' ] [ range ] list_of_variable_identifiers ';'

list_of_variable_identifiers ::= variable_type { ',' variable_type }

variable_type ::= identifier { range }
                | identifier '=' expression

For SystemVerilog-2012 this is quite a bit more complex. Quick rundown:

• additional 'const', 'var', and lifetime specifiers
• variables can be of many new built-in or user-defined types
• initializers can have "new", etc., instead of just being expressions
• ranges for each variable_type can now be lists of variable_dimensions
• package import statements are also considered data declarations, for whatever reason.

The new grammar looks like this:

data_declaration ::=
    ['const'] ['var'] [lifetime] data_type_or_implicit list_of_variable_decl_assignments ';'
  | ...

data_type_or_implicit ::= data_type
                        | implicit_data_type

implicit_data_type ::= [ signing ] { packed_dimension }

list_of_variable_decl_assignments ::= variable_decl_assignment { ',' variable_decl_assignment }

variable_decl_assignment ::=
     identifier { variable_dimension } [ '=' expression ]
   | identifier unsized_dimension { variable_dimension } [ '=' dynamic_array_new ]
   | identifier [ '=' class_new ]

dynamic_array_new ::= new [ expression ] [ ( expression ) ]

class_new ::= [ class_scope ] new [ ( list_of_arguments ) ]
            | new expression

variable_dimension ::= unsized_dimension
                     | unpacked_dimension
                     | associative_dimension
                     | queue_dimension

unsized_dimension     ::= '[' ']'
packed_dimension      ::= '[' constant_range ']' | unsized_dimension
associative_dimension ::= '[' data_type ']' | '[' '*' ']'
queue_dimension       ::= '[' '$' [ ':' expression ] ']'

list_of_arguments ::= [expression] { ',' [expression] } { ',' '.' identifier '(' [expression] ')' }
                    | '.' identifier '(' [expression] ')' { ',' '.' identifier '(' [expression] ')' }

Subtopics

Vl-parse-main-data-declaration

Vl-2005-parse-block-item-declaration-noatts

Vl-2012-parse-block-item-declaration-noatts

Vl-parse-list-of-event-identifiers

Vl-parse-block-item-declaration-noatts

Vl-parse-list-of-variable-identifiers

Vl-build-vardecls

Vl-parse-reg-declaration

Vl-parse-realtime-declaration

Vl-parse-integer-declaration

Vl-parse-time-declaration

Vl-parse-real-declaration

Vl-parse-0+-block-item-declarations

Vl-parse-event-declaration

Vl-parse-block-item-declaration

Vl-parse-variable-type

Vl-maybe-parse-lifetime