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

 * Seperation of type specification and default value constructs

    35

 * (for e.g. simple_spec_init_c), into a type specificiation part,

    36

 * and a default value part.

    37

 */

    38

    39

#include "spec_init_separator.hh"

    40

#include "../main.hh" // required for ERROR() and ERROR_MSG() macros.

    41

    42

    43

//#define DEBUG

    44

#ifdef DEBUG

    45

#define TRACE(classname) printf("\n____%s____\n",classname);

    46

#else

    47

#define TRACE(classname)

    48

#endif

    49

    50

    51

    52

spec_init_sperator_c *spec_init_sperator_c::get_class_instance(void) {

    53

  if (NULL == class_instance)

    54

    class_instance = new spec_init_sperator_c();

    55

    56

  if (NULL == class_instance)

    57

    ERROR;

    58

    59

  return class_instance;

    60

}

    61

    62

 /* the only two public functions... */

    63

symbol_c *spec_init_sperator_c::get_spec(symbol_c *spec_init) {

    64

   search_what = search_spec;

    65

   return (symbol_c *)spec_init->accept(*get_class_instance());

    66

}

    67

    68

symbol_c *spec_init_sperator_c::get_init(symbol_c *spec_init) {

    69

   search_what = search_init;

    70

   return (symbol_c *)spec_init->accept(*get_class_instance());

    71

}

    72

    73

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

    74

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

    75

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

    76

// SYM_TOKEN(identifier_c)

    77

/* visitor for identifier_c is necessary because spec_init_sperator_c will be called to analyse PROGRAM identfiers,

    78

 * which are still transformed into identfier_c, instead of a derived_datatype_identifier_c

    79

 */

    80

void *spec_init_sperator_c::visit(                 identifier_c *symbol) {

    81

  TRACE("spec_init_sperator_c::identifier_c");

    82

  switch (search_what) {

    83

    /* if we ever get called sith a simple identifier_c, then it must be a previously declared type... */

    84

    case search_spec: return symbol;

    85

    case search_init: return NULL;

    86

  }

    87

  ERROR; /* should never occur */

    88

  return NULL;

    89

  }

    90

    91

    92

void *spec_init_sperator_c::visit(derived_datatype_identifier_c *symbol) {

    93

  TRACE("spec_init_sperator_c::identifier_c");

    94

  switch (search_what) {

    95

    /* if we ever get called sith a simple identifier_c, then it must be a previously declared type... */

    96

    case search_spec: return symbol;

    97

    case search_init: return NULL;

    98

  }

    99

  ERROR; /* should never occur */

   100

  return NULL;

   101

}

   102

   103

   104

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

   105

/* B 1.3.3 - Derived data types */

   106

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

   107

   108

/* simple_specification ASSIGN constant */

   109

void *spec_init_sperator_c::visit(simple_spec_init_c *symbol) {

   110

  TRACE("spec_init_sperator_c::simple_spec_init_c");

   111

  switch (search_what) {

   112

    case search_spec: return symbol->simple_specification;

   113

    case search_init: return symbol->constant;

   114

  }

   115

  ERROR; /* should never occur */

   116

  return NULL;

   117

}

   118

   119

/* subrange_specification ASSIGN signed_integer */

   120

void *spec_init_sperator_c::visit(subrange_spec_init_c *symbol) {

   121

  TRACE("spec_init_sperator_c::subrange_spec_init_c");

   122

  switch (search_what) {

   123

    case search_spec: return symbol->subrange_specification->accept(*this);

   124

    case search_init: return symbol->signed_integer;

   125

  }

   126

  ERROR; /* should never occur */

   127

  return NULL;

   128

}

   129

   130

/*  integer_type_name '(' subrange')' */

   131

void *spec_init_sperator_c::visit(subrange_specification_c *symbol) {

   132

  TRACE("spec_init_sperator_c::subrange_specification_c");

   133

  switch (search_what) {

   134

    case search_spec: return symbol->integer_type_name;

   135

    case search_init: return NULL; /* should never occur */

   136

  }

   137

  ERROR; /* should never occur */

   138

  return NULL;

   139

}

   140

   141

/* array_specification [ASSIGN array_initialization} */

   142

/* array_initialization may be NULL ! */

   143

void *spec_init_sperator_c::visit(array_spec_init_c *symbol) {

   144

  TRACE("spec_init_sperator_c::array_spec_init_c");

   145

  switch (search_what) {

   146

    case search_spec: return symbol->array_specification;

   147

    case search_init: return symbol->array_initialization;

   148

  }

   149

  return NULL;

   150

}

   151

   152

/* ARRAY '[' array_subrange_list ']' OF non_generic_type_name */

   153

/* NOTE: this symbol may be used directly in implictly defined variables in VAR_TEMP!! 

   154

 *       so we must consider it here too!

   155

 */

   156

void *spec_init_sperator_c::visit(array_specification_c *symbol) {

   157

  TRACE("spec_init_sperator_c::array_spec_init_c");

   158

  switch (search_what) {

   159

    case search_spec: return symbol;

   160

    case search_init: return NULL;

   161

  }

   162

  return NULL;

   163

}

   164

   165

/* enumerated_specification ASSIGN enumerated_value */

   166

void *spec_init_sperator_c::visit(enumerated_spec_init_c *symbol) {

   167

  TRACE("spec_init_sperator_c::enumerated_spec_init_c");

   168

  switch (search_what) {

   169

    case search_spec: return symbol->enumerated_specification;

   170

    case search_init: return symbol->enumerated_value;

   171

  }

   172

  ERROR; /* should never occur */

   173

  return NULL;

   174

}

   175

   176

/* structure_type_name ASSIGN structure_initialization */

   177

/* structure_initialization may be NULL ! */

   178

//SYM_REF2(initialized_structure_c, structure_type_name, structure_initialization)

   179

void *spec_init_sperator_c::visit(initialized_structure_c *symbol) {

   180

  TRACE("spec_init_sperator_c::initialized_structure_c");

   181

  switch (search_what) {

   182

    case search_spec: return symbol->structure_type_name;

   183

    case search_init: return symbol->structure_initialization;

   184

  }

   185

  ERROR; /* should never occur */

   186

  return NULL;

   187

}

   188

   189

/*  function_block_type_name ASSIGN structure_initialization */

   190

/* structure_initialization -> may be NULL ! */

   191

//SYM_REF2(fb_spec_init_c, function_block_type_name, structure_initialization)

   192

void *spec_init_sperator_c::visit(fb_spec_init_c *symbol) {

   193

  TRACE("spec_init_sperator_c::fb_spec_init_c");

   194

  switch (search_what) {

   195

    case search_spec: return symbol->function_block_type_name;

   196

    case search_init: return symbol->structure_initialization;

   197

  }

   198

  ERROR; /* should never occur */

   199

  return NULL;

   200

}

   201

   202

   203

/* ref_spec:  REF_TO (non_generic_type_name | function_block_type_name) */

   204

// SYM_REF1(ref_spec_c, type_name)

   205

void *spec_init_sperator_c::visit(ref_spec_c *symbol) {

   206

  TRACE("spec_init_sperator_c::ref_spec_c");

   207

  /* This visitor should never really be called, but there is no harm in including it... */

   208

  switch (search_what) {

   209

    case search_spec: return symbol;

   210

    case search_init: return NULL; /* should never occur */

   211

  }

   212

  ERROR; /* should never occur */

   213

  return NULL;

   214

}

   215

   216

   217

/* For the moment, we do not support initialising reference data types */

   218

/* ref_spec_init: ref_spec [ ASSIGN ref_initialization ] */ 

   219

/* NOTE: ref_initialization may be NULL!! */

   220

// SYM_REF2(ref_spec_init_c, ref_spec, ref_initialization)

   221

void *spec_init_sperator_c::visit(ref_spec_init_c *symbol) {

   222

  TRACE("spec_init_sperator_c::ref_spec_init_c");

   223

  switch (search_what) {

   224

    case search_spec: return symbol->ref_spec;

   225

    case search_init: return symbol->ref_initialization;

   226

  }

   227

  ERROR; /* should never occur */

   228

  return NULL;

   229

}

   230

   231

   232

   233

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

   234

/* B 1.4.3 - Declaration & Initialisation */

   235

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

   236

   237

/* STRING '[' integer ']' 

   238

 * STRING ASSIGN single_byte_character_string

   239

 * STRING '[' integer ']' ASSIGN single_byte_character_string

   240

 */

   241

void *spec_init_sperator_c::visit(single_byte_string_spec_c *symbol) {

   242

  TRACE("spec_init_sperator_c::single_byte_string_spec_c");

   243

  switch (search_what) {

   244

    case search_spec: return symbol->string_spec;

   245

    case search_init: return symbol->single_byte_character_string;

   246

  }

   247

  ERROR; /* should never occur */

   248

  return NULL;

   249

}

   250

   251

/* WSTRING '[' integer ']' 

   252

 * WSTRING ASSIGN double_byte_character_string

   253

 * WSTRING '[' integer ']' ASSIGN double_byte_character_string

   254

 */

   255

void *spec_init_sperator_c::visit(double_byte_string_spec_c *symbol) {

   256

  TRACE("spec_init_sperator_c::double_byte_string_spec_c");

   257

  switch (search_what) {

   258

    case search_spec: return symbol->string_spec;

   259

    case search_init: return symbol->double_byte_character_string;

   260

  }

   261

  ERROR; /* should never occur */

   262

  return NULL;

   263

}

   264

   265

   266

spec_init_sperator_c *spec_init_sperator_c ::class_instance = NULL;

   267

spec_init_sperator_c::search_what_t spec_init_sperator_c::search_what;