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

 *

     6

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

     7

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

     8

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

     9

 *  (at your option) any later version.

    10

 *

    11

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

    12

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

    13

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    14

 *  GNU General Public License for more details.

    15

 *

    16

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

    17

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

    18

 *

    19

 *

    20

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

    21

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

    22

 */

    23

    24

/*

    25

 * An IEC 61131-3 compiler.

    26

 *

    27

 * Based on the

    28

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

    29

 *

    30

 */

    31

    32

    33

    34

/* Decomposes a variable instance name into its constituents,

    35

 * example:

    36

 *    window.points[1].coordinate.x

    37

 *

    38

 *  will succesfully return

    39

 *        - window

    40

 *        - points

    41

 *        - coordinate

    42

 *        - x

    43

 * on succesive calls to decompose_var_instance_name_c::next_part()

    44

 */

    45

    46

    47

    48

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

    49

    50

    51

    52

class decompose_var_instance_name_c: null_visitor_c {

    53

    54

  private:

    55

    symbol_c *variable_name;

    56

    symbol_c *next_variable_name;

    57

    symbol_c *current_recursive_variable_name;

    58

    symbol_c *previously_returned_variable_name;

    59

    60

  public:

    61

    decompose_var_instance_name_c(symbol_c *variable_instance_name);

    62

    63

    symbol_c *next_part(bool increment = true);

    64

    65

  private:

    66

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

    67

  /* B.1 - Common elements */

    68

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

    69

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

    70

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

    71

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

    72

    void *visit(identifier_c *symbol);

    73

    74

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

    75

  /* B 1.4 - Variables */

    76

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

    77

    void *visit(symbolic_variable_c *symbol);

    78

    79

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

    80

  /* B.1.4.1   Directly Represented Variables */

    81

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

    82

    void *visit(direct_variable_c *symbol);

    83

    84

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

    85

  /* B.1.4.2   Multi-element Variables */

    86

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

    87

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

    88

  // SYM_REF2(array_variable_c, subscripted_variable, subscript_list)

    89

    void *visit(array_variable_c *symbol);

    90

    91

  /*  record_variable '.' field_selector */

    92

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

    93

   *           may be accessed as fields of a tructured variable!

    94

   *           Code handling a structured_variable_c must take

    95

   *           this into account!

    96

   */

    97

  //SYM_REF2(structured_variable_c, record_variable, field_selector)

    98

    void *visit(structured_variable_c *symbol);

    99

   100

}; // decompose_var_instance_name_c

   101

   102

   103

   104