1

/*

     2

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

     3

 *

     4

 *  Copyright (C) 2003-2012  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

/* Determine the characteristics of a specific data type

    33

 *  e.g., is it an enumeration, is it an array, is it ANY_INT, etc...

    34

 *

    35

 * The methods of this class may be passed either:

    36

 *  - a data type declaration symbol_c, 

    37

 *   OR

    38

 *  - the name of a data type (identifier_c)

    39

 *    In this case, we shall first serach for the basetype declaration using search_base_type_c, and then 

    40

 *    run the normal process.

    41

 */

    42

#include "absyntax_utils.hh"

    43

    44

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

    45

    46

    47

    48

    49

    50

    51

class get_datatype_info_c { 

    52

    53

    54

  private: // this is a purely static class. No need for constructors!

    55

     get_datatype_info_c(void) {};

    56

    ~get_datatype_info_c(void) {};

    57

    58

    59

  public:

    60

    static symbol_c   *get_id    (symbol_c *datatype); /* get the identifier (name) of the datatype); returns NULL if anonymous datatype! Does not work for elementary datatypes!*/

    61

    static const char *get_id_str(symbol_c *datatype); /* get the identifier (name) of the datatype); returns NULL if anonymous datatype! */

    62

    63

    static bool is_type_equal(symbol_c *first_type, symbol_c *second_type);

    64

    static bool is_type_valid(symbol_c *type);

    65

    66

    static bool is_ANY_REAL_literal(symbol_c *type_symbol); /* Can't we do away with this?? */

    67

    static bool is_ANY_INT_literal (symbol_c *type_symbol); /* Can't we do away with this?? */

    68

    69

    static bool is_sfc_initstep                    (symbol_c *type_symbol);

    70

    static bool is_sfc_step                        (symbol_c *type_symbol);

    71

    static bool is_function_block                  (symbol_c *type_symbol);

    72

    static bool is_subrange                        (symbol_c *type_symbol);

    73

    static bool is_enumerated                      (symbol_c *type_symbol);

    74

    static bool is_array                           (symbol_c *type_symbol);

    75

    static bool is_structure                       (symbol_c *type_symbol);

    76

    77

    78

    static bool is_ANY_ELEMENTARY                  (symbol_c *type_symbol);

    79

    static bool is_ANY_SAFEELEMENTARY              (symbol_c *type_symbol);

    80

    static bool is_ANY_ELEMENTARY_compatible       (symbol_c *type_symbol);

    81

    82

    static bool is_ANY_MAGNITUDE                   (symbol_c *type_symbol);

    83

    static bool is_ANY_SAFEMAGNITUDE               (symbol_c *type_symbol);

    84

    static bool is_ANY_MAGNITUDE_compatible        (symbol_c *type_symbol);

    85

    86

    static bool is_ANY_signed_MAGNITUDE            (symbol_c *type_symbol);

    87

    static bool is_ANY_signed_SAFEMAGNITUDE        (symbol_c *type_symbol);

    88

    static bool is_ANY_signed_MAGNITUDE_compatible (symbol_c *type_symbol);

    89

    90

    static bool is_ANY_NUM                         (symbol_c *type_symbol);

    91

    static bool is_ANY_SAFENUM                     (symbol_c *type_symbol);

    92

    static bool is_ANY_NUM_compatible              (symbol_c *type_symbol);

    93

    94

    static bool is_ANY_signed_NUM                  (symbol_c *type_symbol);

    95

    static bool is_ANY_signed_SAFENUM              (symbol_c *type_symbol);

    96

    static bool is_ANY_signed_NUM_compatible       (symbol_c *type_symbol);

    97

    98

    static bool is_ANY_INT                         (symbol_c *type_symbol);

    99

    static bool is_ANY_SAFEINT                     (symbol_c *type_symbol);

   100

    static bool is_ANY_INT_compatible              (symbol_c *type_symbol);

   101

   102

    static bool is_ANY_signed_INT                  (symbol_c *type_symbol);

   103

    static bool is_ANY_signed_SAFEINT              (symbol_c *type_symbol);

   104

    static bool is_ANY_signed_INT_compatible       (symbol_c *type_symbol);

   105

   106

    static bool is_ANY_unsigned_INT                (symbol_c *type_symbol);

   107

    static bool is_ANY_unsigned_SAFEINT            (symbol_c *type_symbol);

   108

    static bool is_ANY_unsigned_INT_compatible     (symbol_c *type_symbol);

   109

   110

    static bool is_ANY_REAL                        (symbol_c *type_symbol);

   111

    static bool is_ANY_SAFEREAL                    (symbol_c *type_symbol);

   112

    static bool is_ANY_REAL_compatible             (symbol_c *type_symbol);

   113

   114

    static bool is_ANY_nBIT                        (symbol_c *type_symbol);

   115

    static bool is_ANY_SAFEnBIT                    (symbol_c *type_symbol);

   116

    static bool is_ANY_nBIT_compatible             (symbol_c *type_symbol);

   117

   118

    static bool is_BOOL                            (symbol_c *type_symbol);

   119

    static bool is_SAFEBOOL                        (symbol_c *type_symbol);

   120

    static bool is_BOOL_compatible                 (symbol_c *type_symbol);

   121

   122

    static bool is_ANY_BIT                         (symbol_c *type_symbol);

   123

    static bool is_ANY_SAFEBIT                     (symbol_c *type_symbol);

   124

    static bool is_ANY_BIT_compatible              (symbol_c *type_symbol);

   125

   126

    static bool is_ANY_DATE                        (symbol_c *type_symbol);

   127

    static bool is_ANY_SAFEDATE                    (symbol_c *type_symbol);

   128

    static bool is_ANY_DATE_compatible             (symbol_c *type_symbol);

   129

   130

    static bool is_TIME                            (symbol_c *type_symbol);

   131

    static bool is_SAFETIME                        (symbol_c *type_symbol);

   132

    static bool is_TIME_compatible                 (symbol_c *type_symbol);

   133

   134

    static bool is_ANY_STRING                      (symbol_c *type_symbol);

   135

    static bool is_ANY_SAFESTRING                  (symbol_c *type_symbol);

   136

    static bool is_ANY_STRING_compatible           (symbol_c *type_symbol);

   137

   138

   139

   140

   141

  public:

   142

    /* object used to identify an entry in the abstract syntax tree with an invalid data type */

   143

    /* This is only used from stage3 onwards. Stages 1 and 2 will never create any instances of invalid_type_name_c */

   144

    static invalid_type_name_c     invalid_type_name;

   145

   146

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

   147

    /* B.1.3 - Data types */

   148

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

   149

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

   150

    /* B 1.3.1 - Elementary Data Types */

   151

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

   152

    static lreal_type_name_c        lreal_type_name;

   153

    static real_type_name_c         real_type_name;

   154

   155

    static lint_type_name_c         lint_type_name;

   156

    static dint_type_name_c         dint_type_name;

   157

    static int_type_name_c          int_type_name;

   158

    static sint_type_name_c         sint_type_name;

   159

   160

    static ulint_type_name_c        ulint_type_name;

   161

    static udint_type_name_c        udint_type_name;

   162

    static uint_type_name_c         uint_type_name;

   163

    static usint_type_name_c        usint_type_name;

   164

   165

    static lword_type_name_c        lword_type_name;

   166

    static dword_type_name_c        dword_type_name;

   167

    static word_type_name_c         word_type_name;

   168

    static byte_type_name_c         byte_type_name;

   169

    static bool_type_name_c         bool_type_name;

   170

   171

    static wstring_type_name_c      wstring_type_name;

   172

    static string_type_name_c       string_type_name;

   173

   174

    static dt_type_name_c           dt_type_name;

   175

    static date_type_name_c         date_type_name;

   176

    static tod_type_name_c          tod_type_name;

   177

    static time_type_name_c         time_type_name;

   178

   179

   180

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

   181

    /* Extensions to the base standard as defined in      */

   182

    /* "Safety Software Technical Specification,          */

   183

    /*  Part 1: Concepts and Function Blocks,             */

   184

    /*  Version 1.0 – Official Release"                   */

   185

    /* by PLCopen - Technical Committee 5 - 2006-01-31    */

   186

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

   187

    static safelreal_type_name_c    safelreal_type_name;

   188

    static safereal_type_name_c     safereal_type_name;

   189

   190

    static safelint_type_name_c     safelint_type_name;

   191

    static safedint_type_name_c     safedint_type_name;

   192

    static safeint_type_name_c      safeint_type_name;

   193

    static safesint_type_name_c     safesint_type_name;

   194

   195

    static safeulint_type_name_c    safeulint_type_name;

   196

    static safeudint_type_name_c    safeudint_type_name;

   197

    static safeuint_type_name_c     safeuint_type_name;

   198

    static safeusint_type_name_c    safeusint_type_name;

   199

   200

    static safelword_type_name_c    safelword_type_name;

   201

    static safedword_type_name_c    safedword_type_name;

   202

    static safeword_type_name_c     safeword_type_name;

   203

    static safebyte_type_name_c     safebyte_type_name;

   204

    static safebool_type_name_c     safebool_type_name;

   205

   206

    static safewstring_type_name_c  safewstring_type_name;

   207

    static safestring_type_name_c   safestring_type_name;

   208

   209

    static safedt_type_name_c       safedt_type_name;

   210

    static safedate_type_name_c     safedate_type_name;

   211

    static safetod_type_name_c      safetod_type_name;

   212

    static safetime_type_name_c     safetime_type_name;               

   213

};

   214