1

/*

     2

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

     3

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

     4

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

     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

 * Declaration of the Abstract Syntax data structure components

    34

 */

    35

    36

/*

    37

 * ABSYNTAX.H

    38

 *

    39

 * This generates the parse tree structure used to bind the components

    40

 * identified by Bison in the correct syntax order. At the end of the

    41

 * Bison analysis the tree is walked in a sequential fashion generating

    42

 * the relavent code.

    43

 */

    44

    45

#ifndef _ABSYNTAX_HH

    46

#define _ABSYNTAX_HH

    47

    48

    49

#include <stdio.h> // required for NULL

    50

#include <vector>

    51

#include <map>

    52

#include <string>

    53

#include <stdint.h>  // required for uint64_t, etc...

    54

#include "../main.hh" // required for uint8_t, real_64_t, ..., and the macros INT8_MAX, REAL32_MAX, ... */

    55

    56

    57

    58

    59

/* Forward declaration of the visitor interface

    60

 * declared in the visitor.hh file

    61

 * We cannot include the visitor.hh file, as it will

    62

 * include this same file first, as it too requires references

    63

 * to the abstract syntax classes defined here.

    64

 */

    65

class visitor_c; // forward declaration

    66

    67

    68

class symbol_c; // forward declaration

    69

    70

    71

    72

    73

    74

    75

    76

/* Case insensitive string compare */

    77

  /* Case insensitive string compare copied from

    78

   * "The C++ Programming Language" - 3rd Edition

    79

   * by Bjarne Stroustrup, ISBN 0201889544.

    80

   */

    81

class nocasecmp_c {

    82

    public:

    83

      bool operator() (const std::string& x, const std::string& y) const {

    84

        std::string::const_iterator ix = x.begin();

    85

        std::string::const_iterator iy = y.begin();

    86

    87

        for(; (ix != x.end()) && (iy != y.end()) && (toupper(*ix) == toupper(*iy)); ++ix, ++iy);

    88

        if (ix == x.end()) return (iy != y.end());

    89

        if (iy == y.end()) return false;

    90

        return (toupper(*ix) < toupper(*iy));

    91

      };

    92

  };

    93

    94

    95

    96

    97

    98

    99

   100

   101

   102

/* The base class of all symbols */

   103

class symbol_c {

   104

   105

  public:

   106

    /* WARNING: only use this method for debugging purposes!! */

   107

    virtual const char *absyntax_cname(void) {return "symbol_c";};

   108

   109

    /*

   110

     * Annotations produced during stage 1_2

   111

     */    

   112

    /* Points to the parent symbol in the AST, i.e. the symbol in the AST that will contain the current symbol */

   113

    symbol_c *parent; 

   114

   115

    /* Line number for the purposes of error checking.  */

   116

    int first_line;

   117

    int first_column;

   118

    const char *first_file;  /* filename referenced by first line/column */

   119

    long int first_order;    /* relative order in which it is read by lexcial analyser */

   120

    int last_line;

   121

    int last_column;

   122

    const char *last_file;  /* filename referenced by last line/column */

   123

    long int last_order;    /* relative order in which it is read by lexcial analyser */

   124

   125

   126

    /*

   127

     * Annotations produced during stage 3

   128

     */    

   129

    /*** Data type analysis ***/

   130

    std::vector <symbol_c *> candidate_datatypes; /* All possible data types the expression/literal/etc. may take. Filled in stage3 by fill_candidate_datatypes_c class */

   131

    /* Data type of the expression/literal/etc. Filled in stage3 by narrow_candidate_datatypes_c 

   132

     * If set to NULL, it means it has not yet been evaluated.

   133

     * If it points to an object of type invalid_type_name_c, it means it is invalid.

   134

     * Otherwise, it points to an object of the apropriate data type (e.g. int_type_name_c, bool_type_name_c, ...)

   135

     */

   136

    symbol_c *datatype;

   137

    /* The POU in which the symbolic variable (or structured variable, or array variable, or located variable, - any more?)

   138

     * was declared. This will point to a Configuration, Resource, Program, FB, or Function.

   139

     * This is set in stage 3 by the datatype analyser algorithm (fill/narrow) for the symbols:

   140

     *  symbolic_variable_c, array_variable_c, structured_variable_c

   141

     */

   142

    symbol_c *scope;    

   143

   144

    /*** constant folding ***/

   145

    /* During stage 3 (semantic analysis/checking) we will be doing constant folding.

   146

     * That algorithm will anotate the abstract syntax tree with the result of operations

   147

     * on literals (i.e. 44 + 55 will store the result 99).

   148

     * Since the same source code (e.g. 1 + 0) may actually be a BOOL or an ANY_INT,

   149

     * or an ANY_BIT, we need to handle all possibilities, and determine the result of the

   150

     * operation assuming each type.

   151

     * For this reason, we have one entry for each possible type, with some expressions

   152

     * having more than one entry filled in!

   153

     */

   154

    typedef enum { cs_undefined,   /* not defined/not yet evaluated --> const_value is not valid! */

   155

                   cs_non_const,   /* we have determined that expression is not a const value --> const_value is not valid! */

   156

                   cs_const_value, /* const value is valid */

   157

                   cs_overflow     /* result produced overflow or underflow --> const_value is not valid! */

   158

                 } const_status_t;

   159

   160

    typedef struct const_value_real64_s {const_status_t status;  real64_t  value;  const_value_real64_s (): status(cs_undefined), value(0.0)   {} } const_value_real64_t;

   161

    typedef struct const_value_int64_s  {const_status_t status;   int64_t  value;  const_value_int64_s  (): status(cs_undefined), value(0)     {} } const_value_int64_t;

   162

    typedef struct const_value_uint64_s {const_status_t status;  uint64_t  value;  const_value_uint64_s (): status(cs_undefined), value(0)     {} } const_value_uint64_t;

   163

    typedef struct const_value_bool_s   {const_status_t status;      bool  value;  const_value_bool_s   (): status(cs_undefined), value(false) {} } const_value_bool_t;

   164

   165

    typedef struct {

   166

      const_value_real64_t _real64; /* status is initialised to UNDEFINED */

   167

      const_value_int64_t   _int64; /* status is initialised to UNDEFINED */

   168

      const_value_uint64_t _uint64; /* status is initialised to UNDEFINED */

   169

      const_value_bool_t     _bool; /* status is initialised to UNDEFINED */

   170

    } const_value_t;

   171

    const_value_t const_value;

   172

   173

    /*** Enumeration datatype checking ***/    

   174

    /* Not all symbols will contain the following anotations, which is why they are not declared here in symbol_c

   175

     * They will be declared only inside the symbols that require them (have a look at absyntax.def)

   176

     */

   177

    typedef std::multimap<std::string, symbol_c *, nocasecmp_c> enumvalue_symtable_t;

   178

   179

    /*

   180

     * Annotations produced during stage 4

   181

     */

   182

    /* Since we support several distinct stage_4 implementations, having explicit entries for each

   183

     * possible use would quickly get out of hand.

   184

     * We therefore simply add a map, that each stage 4 may use for all its needs.

   185

     */

   186

    typedef std::map<std::string, symbol_c *> anotations_map_t;

   187

    anotations_map_t anotations_map;

   188

   189

   190

  public:

   191

    /* default constructor */

   192

    symbol_c(int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0, /* order in which it is read by lexcial analyser */

   193

             int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0  /* order in which it is read by lexcial analyser */

   194

            );

   195

   196

    /* default destructor */

   197

    /* must be virtual so compiler does not complain... */ 

   198

    virtual ~symbol_c(void) {return;};

   199

   200

    virtual void *accept(visitor_c &visitor) {return NULL;};

   201

};

   202

   203

   204

   205

   206

class token_c: public symbol_c {

   207

  public:

   208

    /* WARNING: only use this method for debugging purposes!! */

   209

    virtual const char *absyntax_cname(void) {return "token_c";};

   210

   211

    /* the value of the symbol. */

   212

    const char *value;

   213

   214

  public:

   215

    token_c(const char *value, 

   216

            int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0, /* order in which it is read by lexcial analyser */

   217

            int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0  /* order in which it is read by lexcial analyser */

   218

           );

   219

};

   220

   221

   222

   223

   224

 /* a list of symbols... */

   225

class list_c: public symbol_c {

   226

  public:

   227

    /* WARNING: only use this method for debugging purposes!! */

   228

    virtual const char *absyntax_cname(void) {return "list_c";};

   229

   230

    int c,n; /* c: current capacity of list (malloc'd memory);  n: current number of elements in list */

   231

    symbol_c **elements;

   232

   233

  public:

   234

    list_c(int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0, /* order in which it is read by lexcial analyser */

   235

           int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0  /* order in which it is read by lexcial analyser */

   236

          );

   237

   238

    list_c(symbol_c *elem, 

   239

           int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0, /* order in which it is read by lexcial analyser */

   240

           int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0  /* order in which it is read by lexcial analyser */

   241

          );

   242

     /* append a new element to the end of the list */

   243

    virtual void add_element(symbol_c *elem);

   244

     /* insert a new element before position pos. */

   245

     /* To insert into the begining of list, call with pos=0  */

   246

     /* To insert into the end of list, call with pos=list->n */

   247

    virtual void insert_element(symbol_c *elem, int pos = 0);

   248

     /* remove element at position pos. */

   249

    virtual void remove_element(int pos = 0);

   250

     /* remove all elements from list. Does not delete the elements in the list! */ 

   251

    virtual void clear(void);

   252

};

   253

   254

   255

   256

   257

   258

   259

   260

   261

   262

#define SYM_LIST(class_name_c, ...)											\

   263

class class_name_c:	public list_c {											\

   264

  public:														\

   265

    __VA_ARGS__														\

   266

  public:														\

   267

    class_name_c(													\

   268

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   269

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   270

    class_name_c(symbol_c *elem, 											\

   271

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   272

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   273

    virtual void *accept(visitor_c &visitor);										\

   274

    /* WARNING: only use this method for debugging purposes!! */							\

   275

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   276

};

   277

   278

   279

#define SYM_TOKEN(class_name_c, ...)											\

   280

class class_name_c: 	public token_c {										\

   281

  public:														\

   282

    __VA_ARGS__														\

   283

  public:														\

   284

    class_name_c(const char *value, 											\

   285

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   286

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   287

    virtual void *accept(visitor_c &visitor);										\

   288

    /* WARNING: only use this method for debugging purposes!! */							\

   289

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   290

};

   291

   292

   293

#define SYM_REF0(class_name_c, ...)											\

   294

class class_name_c: public symbol_c {											\

   295

  public:														\

   296

    __VA_ARGS__														\

   297

  public:														\

   298

    class_name_c(		 											\

   299

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   300

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   301

    virtual void *accept(visitor_c &visitor);										\

   302

    /* WARNING: only use this method for debugging purposes!! */							\

   303

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   304

};

   305

   306

   307

#define SYM_REF1(class_name_c, ref1, ...)										\

   308

class class_name_c: public symbol_c {											\

   309

  public:														\

   310

    symbol_c *ref1;													\

   311

    __VA_ARGS__														\

   312

  public:														\

   313

    class_name_c(symbol_c *ref1,											\

   314

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   315

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   316

    virtual void *accept(visitor_c &visitor);										\

   317

    /* WARNING: only use this method for debugging purposes!! */							\

   318

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   319

};

   320

   321

   322

#define SYM_REF2(class_name_c, ref1, ref2, ...)										\

   323

class class_name_c: public symbol_c {											\

   324

  public:														\

   325

    symbol_c *ref1;													\

   326

    symbol_c *ref2;													\

   327

    __VA_ARGS__														\

   328

  public:														\

   329

    class_name_c(symbol_c *ref1,											\

   330

		 symbol_c *ref2 = NULL,											\

   331

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   332

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   333

    virtual void *accept(visitor_c &visitor);										\

   334

    /* WARNING: only use this method for debugging purposes!! */							\

   335

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   336

};

   337

   338

   339

#define SYM_REF3(class_name_c, ref1, ref2, ref3, ...)									\

   340

class class_name_c: public symbol_c {											\

   341

  public:														\

   342

    symbol_c *ref1;													\

   343

    symbol_c *ref2;													\

   344

    symbol_c *ref3;													\

   345

    __VA_ARGS__														\

   346

  public:														\

   347

    class_name_c(symbol_c *ref1,											\

   348

		 symbol_c *ref2,											\

   349

		 symbol_c *ref3,											\

   350

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   351

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   352

    virtual void *accept(visitor_c &visitor);										\

   353

    /* WARNING: only use this method for debugging purposes!! */							\

   354

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   355

};

   356

   357

   358

#define SYM_REF4(class_name_c, ref1, ref2, ref3, ref4, ...)								\

   359

class class_name_c: public symbol_c {											\

   360

  public:														\

   361

    symbol_c *ref1;													\

   362

    symbol_c *ref2;													\

   363

    symbol_c *ref3;													\

   364

    symbol_c *ref4;													\

   365

    __VA_ARGS__														\

   366

  public:														\

   367

    class_name_c(symbol_c *ref1,											\

   368

		 symbol_c *ref2,											\

   369

		 symbol_c *ref3,											\

   370

		 symbol_c *ref4 = NULL,											\

   371

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   372

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   373

    virtual void *accept(visitor_c &visitor);										\

   374

    /* WARNING: only use this method for debugging purposes!! */							\

   375

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   376

};

   377

   378

   379

#define SYM_REF5(class_name_c, ref1, ref2, ref3, ref4, ref5, ...)							\

   380

class class_name_c: public symbol_c {											\

   381

  public:														\

   382

    symbol_c *ref1;													\

   383

    symbol_c *ref2;													\

   384

    symbol_c *ref3;													\

   385

    symbol_c *ref4;													\

   386

    symbol_c *ref5;													\

   387

    __VA_ARGS__														\

   388

  public:														\

   389

    class_name_c(symbol_c *ref1,											\

   390

		 symbol_c *ref2,											\

   391

		 symbol_c *ref3,											\

   392

		 symbol_c *ref4,											\

   393

		 symbol_c *ref5,											\

   394

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   395

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   396

    virtual void *accept(visitor_c &visitor);										\

   397

    /* WARNING: only use this method for debugging purposes!! */							\

   398

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   399

};

   400

   401

   402

#define SYM_REF6(class_name_c, ref1, ref2, ref3, ref4, ref5, ref6, ...)							\

   403

class class_name_c: public symbol_c {											\

   404

  public:														\

   405

    symbol_c *ref1;													\

   406

    symbol_c *ref2;													\

   407

    symbol_c *ref3;													\

   408

    symbol_c *ref4;													\

   409

    symbol_c *ref5;													\

   410

    symbol_c *ref6;													\

   411

    __VA_ARGS__														\

   412

  public:														\

   413

    class_name_c(symbol_c *ref1,											\

   414

		 symbol_c *ref2,											\

   415

		 symbol_c *ref3,											\

   416

		 symbol_c *ref4,											\

   417

		 symbol_c *ref5,											\

   418

		 symbol_c *ref6 = NULL,											\

   419

                 int fl = 0, int fc = 0, const char *ffile = NULL /* filename */, long int forder=0,			\

   420

                 int ll = 0, int lc = 0, const char *lfile = NULL /* filename */, long int lorder=0);			\

   421

    virtual void *accept(visitor_c &visitor);										\

   422

    /* WARNING: only use this method for debugging purposes!! */							\

   423

    virtual const char *absyntax_cname(void) {return #class_name_c;};							\

   424

};

   425

   426

   427

#include "absyntax.def"

   428

   429

   430

   431

#undef SYM_LIST

   432

#undef SYM_TOKEN

   433

#undef SYM_REF0

   434

#undef SYM_REF1

   435

#undef SYM_REF2

   436

#undef SYM_REF3

   437

#undef SYM_REF4

   438

#undef SYM_REF5

   439

#undef SYM_REF6

   440

   441

#endif /*  _ABSYNTAX_HH */