vhdl-style-guide/docs/variable_rules.rst

341 lines
5.3 KiB
ReStructuredText

.. include:: includes.rst
Variable Rules
--------------
variable_001
############
|phase_4| |error| |indent|
This rule checks the indent of variable declarations.
**Violation**
.. code-block:: vhdl
proc : process () is
variable count : integer;
variable counter : integer;
begin
**Fix**
.. code-block:: vhdl
proc : process () is
variable count : integer;
variable counter : integer;
begin
variable_002
############
|phase_6| |error| |case| |case_keyword|
This rule checks the **variable** keyword has proper case.
|configuring_uppercase_and_lowercase_rules_link|
**Violation**
.. code-block:: vhdl
VARIABLE count : integer;
**Fix**
.. code-block:: vhdl
variable count : integer;
variable_003
############
This rule was deprecated and replaced with rules:
* `function_015 <function_rules.html#function-015>`_
* `package_019 <package_rules.html#package-019>`_
* `procedure_010 <procedure_rules.html#procedure-010>`_
* `architecture_029 <architecture_rules.html#architecture-029>`_
variable_004
############
|phase_6| |error| |case| |case_name|
This rule checks the variable name has proper case.
|configuring_uppercase_and_lowercase_rules_link|
**Violation**
.. code-block:: vhdl
variable COUNT : integer;
**Fix**
.. code-block:: vhdl
variable count : integer;
variable_005
############
|phase_2| |error| |whitespace|
This rule checks there is a single space after the colon.
|configuring_whitespace_rules_link|
**Violation**
.. code-block:: vhdl
variable count :integer;
variable counter : integer;
**Fix**
.. code-block:: vhdl
variable count : integer;
variable counter : integer;
variable_006
############
|phase_2| |error| |whitespace|
This rule checks for at least a single space before the colon.
|configuring_whitespace_rules_link|
**Violation**
.. code-block:: vhdl
variable count: integer;
variable counter : integer;
**Fix**
.. code-block:: vhdl
variable count : integer;
variable counter : integer;
variable_007
############
|phase_1| |error| |structure|
This rule checks for default assignments in variable declarations.
**Violation**
.. code-block:: vhdl
variable count : integer := 32;
**Fix**
.. code-block:: vhdl
variable count : integer;
variable_010
############
The function of this rule has been superseded by the following rules:
* ieee_500
* subtype_002
* type_014
variable_011
############
|phase_6| |error| |case|
This rule checks for consistent capitalization of variable names.
**Violation**
.. code-block:: vhdl
architecture rtl of entity1 is
shared variable var1 : std_logic;
shared variable var2 : std_logic;
begin
proc_name : process () is
variable var3 : std_logic;
variable var4 : std_logic;
begin
Var1 <= '0';
if (VAR2 = '0') then
vaR3 <= '1';
elisif (var2 = '1') then
VAR4 <= '0';
end if;
end process proc_name;
end architecture rtl;
**Fix**
.. code-block:: vhdl
proc_name : process () is
variable var1 : std_logic;
variable var2 : std_logic;
variable var3 : std_logic;
variable var4 : std_logic;
begin
var1 <= '0';
if (var2 = '0') then
var3 <= '1';
elisif (var2 = '1') then
var4 <= '0';
end if;
end process proc_name;
variable_012
############
|phase_7| |disabled| |error| |naming|
This rule checks for valid prefixes on variable identifiers.
The default variable prefix is *v_*.
|configuring_prefix_and_suffix_rules_link|
**Violation**
.. code-block:: vhdl
variable my_var : natural;
**Fix**
.. code-block:: vhdl
variable v_my_var : natural;
variable_017
############
|phase_1| |error| |structure|
This rule checks the structure of variable constraints.
|configuring_multiline_constraint_rules_link|
.. NOTE:: The indenting of multiline variable constraints is handled by the rule `variable_400 <variable_rules.html#variable-400>`_.
**Violation**
.. code-block:: vhdl
variable v_element : my_record(element1(7 downto 0), element2(3 downto 0));
**Fix**
.. code-block:: vhdl
variable v_element : my_record(
element1(7 downto 0),
element2(3 downto 0)
);
variable_100
############
|phase_2| |disabled| |error| |whitespace|
This rule checks for a single space before the identifier.
|configuring_whitespace_rules_link|
**Violation**
.. code-block:: vhdl
variable size : integer;
variable width : integer;
**Fix**
.. code-block:: vhdl
variable size : integer;
variable width : integer;
variable_400
############
|phase_5| |error| |alignment|
This rule checks alignment of multiline constraints in variable declarations.
|configuring_multiline_indent_rules_link|
**Violation**
.. code-block:: vhdl
variable v_element : my_record(
element1(7 downto 0),
element2(3 downto 0)
);
**Fix**
.. code-block:: vhdl
variable v_element : my_record(
element1(7 downto 0),
element2(3 downto 0)
);
variable_600
############
|phase_7| |disabled| |error| |naming|
This rule checks for valid suffix on variable identifiers.
The default variable suffix is *_v*.
|configuring_prefix_and_suffix_rules_link|
**Violation**
.. code-block:: vhdl
variable my_var : natural;
**Fix**
.. code-block:: vhdl
variable my_var_v : natural;