1

/*

     2

 *  matiec - a compiler for the programming languages defined in IEC 61131-3

     3

 *

     4

 *  Copyright (C) 2003-2011  Mario de Sousa (msousa@fe.up.pt)

     5

 *  Copyright (C) 2007-2011  Laurent Bessard and Edouard Tisserant

     6

 *

     7

 *  This program is free software: you can redistribute it and/or modify

     8

 *  it under the terms of the GNU General Public License as published by

     9

 *  the Free Software Foundation, either version 3 of the License, or

    10

 *  (at your option) any later version.

    11

 *

    12

 *  This program is distributed in the hope that it will be useful,

    13

 *  but WITHOUT ANY WARRANTY; without even the implied warranty of

    14

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    15

 *  GNU General Public License for more details.

    16

 *

    17

 *  You should have received a copy of the GNU General Public License

    18

 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.

    19

 *

    20

 *

    21

 * This code is made available on the understanding that it will not be

    22

 * used in safety-critical situations without a full and competent review.

    23

 */

    24

    25

/*

    26

 * An IEC 61131-3 compiler.

    27

 *

    28

 * Based on the

    29

 * FINAL DRAFT - IEC 61131-3, 2nd Ed. (2001-12-10)

    30

 *

    31

 */

    32

    33

    34

    35

/* Decomposes a variable instance name into its constituents,

    36

 * example:

    37

 *    window.points[1].coordinate.x

    38

 *

    39

 *  will succesfully return

    40

 *        - window

    41

 *        - points

    42

 *        - coordinate

    43

 *        - x

    44

 * on succesive calls to decompose_var_instance_name_c::next_part()

    45

 */

    46

    47

    48

    49

#include "../absyntax/visitor.hh"

    50

    51

    52

    53

class decompose_var_instance_name_c: null_visitor_c {

    54

    55

  public:

    56

    /***********************************/

    57

    /* B 1.2 - Operators               */

    58

    /***********************************/

    59

    static identifier_c     LD_operator_name;

    60

    static identifier_c     S_operator_name;

    61

    static identifier_c     R_operator_name;

    62

    static identifier_c     S1_operator_name;

    63

    static identifier_c     R1_operator_name;

    64

    static identifier_c     CLK_operator_name;

    65

    static identifier_c     CU_operator_name;

    66

    static identifier_c     CD_operator_name;

    67

    static identifier_c     PV_operator_name;

    68

    static identifier_c     IN_operator_name;

    69

    static identifier_c     PT_operator_name;

    70

    71

    72

  private:

    73

    symbol_c *variable_name;

    74

    symbol_c *next_variable_name;

    75

    symbol_c *current_recursive_variable_name;

    76

    symbol_c *previously_returned_variable_name;

    77

    list_c   *current_array_subscript_list;

    78

    79

  public:

    80

    decompose_var_instance_name_c(symbol_c *variable_instance_name);

    81

    /* Get the next element in the strcutured variable */

    82

    symbol_c *get_next(void);

    83

    /* If the current element in the structured variable is an array, return its subscript_list, otherwise return NULL */

    84

    list_c *get_current_arraysubs_list(void);

    85

    86

  private:

    87

  /*************************/

    88

  /* B.1 - Common elements */

    89

  /*************************/

    90

  /*******************************************/

    91

  /* B 1.1 - Letters, digits and identifiers */

    92

  /*******************************************/

    93

    void *visit(identifier_c *symbol);

    94

    95

  /*********************/

    96

  /* B 1.4 - Variables */

    97

  /*********************/

    98

    void *visit(symbolic_variable_c *symbol);

    99

   100

  /********************************************/

   101

  /* B.1.4.1   Directly Represented Variables */

   102

  /********************************************/

   103

    void *visit(direct_variable_c *symbol);

   104

   105

  /*************************************/

   106

  /* B.1.4.2   Multi-element Variables */

   107

  /*************************************/

   108

  /*  subscripted_variable '[' subscript_list ']' */

   109

  // SYM_REF2(array_variable_c, subscripted_variable, subscript_list)

   110

    void *visit(array_variable_c *symbol);

   111

   112

  /*  record_variable '.' field_selector */

   113

  /*  WARNING: input and/or output variables of function blocks

   114

   *           may be accessed as fields of a tructured variable!

   115

   *           Code handling a structured_variable_c must take

   116

   *           this into account!

   117

   */

   118

  //SYM_REF2(structured_variable_c, record_variable, field_selector)

   119

    void *visit(structured_variable_c *symbol);

   120

   121

    /********************************/

   122

    /* B 2.2 - Operators            */

   123

    /********************************/

   124

    void *visit(LD_operator_c *symbol);

   125

    void *visit(S_operator_c *symbol);

   126

    void *visit(R_operator_c *symbol);

   127

    void *visit(S1_operator_c *symbol);

   128

    void *visit(R1_operator_c *symbol);

   129

    void *visit(CLK_operator_c *symbol);

   130

    void *visit(CU_operator_c *symbol);

   131

    void *visit(CD_operator_c *symbol);

   132

    void *visit(PV_operator_c *symbol);

   133

    void *visit(IN_operator_c *symbol);

   134

    void *visit(PT_operator_c *symbol);

   135

   136

}; // decompose_var_instance_name_c

   137

   138

   139

   140