NAME

       ARRAY, GENPAT Package

SYNOPSYS

       ARRAY ("ident", "ident", ..., ":nb_space", "format", type, option, "ident_group", 0);

PARAMETERS

       ident     Name, followed with a number if part of a bused signal, of a connector, a signal
                 or a register. All idents must be of the same type. The name and the number must
                 be separated by a blank or the number must be parenthesized.

       nb_space  Specify  the  number  of blank space between each group of value. 0,1,2,3,4,5,6,
                 7,8,9 or nothing.

       format    Specify the format that will be used to represent the value  associated  to  the
                 connectors. X for Hexadecimal, O for Octal and B for Binary.

       type      Specify the type of the aggregate. REGISTER for Register, SIGNAL for Signal, OUT
                 for Output, IN for Input, INOUT for Input/Output.  REGISTER,  SIGNAL,  OUT,  IN,
                 INOUT are constants (defines) provided by genpat.

       option    Specify  options  of the connectors. "S" for a spied connector, empty ("") for a
                 normal connector.

       ident_group
                 Specify the array's name, the first ident is associated  with  the  MSB  of  the
                 array.

DESCRIPTION

       Create  a  virtual  vector  with  signals  of the same type and format. The signals may be
       either Inputs, Outputs, Inputs/Outputs, Registers or Internal Signals.   A  vector  to  be
       aggregate  is  to be declared bit per bit (it will appear as a vector in the output file).
       Outputs, Signals and  Registers  can  be  redeclared  in  a  virtual  vector.  Inputs  and
       Inputs/Outputs CANNOT be redeclared.

EXAMPLES

       ARRAY ("cout", "s 9", "s 8", "s 7", ":2", "B", OUT, "S", "Y", 0);

       format : Binary.
       type   : Output connector.
       option : spied connector.

       each group is separated of the others with 2 blank spaces.
       result :   out Y ( cout, s (9 downto 7) ) B spy ;;;

       ARRAY ("regt", "reg 9", ":2", "B", REGISTER, "", "Y", 0);

       format : Binary.
       type   : Register.
       option : none.

       each group is separated of the others with 2 blank spaces.
       result :   register   Y ( regt, reg (9 downto 9) ) B;;;

WARNING

       The ARRAY function from the 4.0 release have a new parameter (option).

SEE ALSO

       DECLAR(3), genpat(1), pat(5)

DIAGNOSTICS

       You  are  dealing with a variable number of parameters fonction. If you forget one or more
       parameter, you will have one of the following results :

              Nothing bad happen, but your result file is erroneous.
              You are asked for more parameter.
              You crash the program and produce a Segmentation Fault.

       In all cases, check your C file for missing parameter.