item.h 43.2 KB
Newer Older
1
/* Copyright (C) 2000-2003 MySQL AB & MySQL Finland AB & TCX DataKonsult AB
unknown's avatar
unknown committed
2

unknown's avatar
unknown committed
3 4 5 6
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
unknown's avatar
unknown committed
7

unknown's avatar
unknown committed
8 9 10 11
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
unknown's avatar
unknown committed
12

unknown's avatar
unknown committed
13 14 15 16 17 18 19 20 21
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */


#ifdef __GNUC__
#pragma interface			/* gcc class implementation */
#endif

22
class Protocol;
unknown's avatar
unknown committed
23
struct st_table_list;
unknown's avatar
unknown committed
24
void item_init(void);			/* Init item functions */
25
class Item_field;
unknown's avatar
unknown committed
26

27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44

/*
   "Declared Type Collation"
   A combination of collation and its deriviation.
*/

enum Derivation
{
  DERIVATION_COERCIBLE= 3,
  DERIVATION_IMPLICIT= 2,
  DERIVATION_NONE= 1,
  DERIVATION_EXPLICIT= 0
};

class DTCollation {
public:
  CHARSET_INFO     *collation;
  enum Derivation derivation;
45 46
  uint nagg;    // Total number of aggregated collations.
  uint strong;  // Number of the strongest collation.
47 48 49 50 51
  
  DTCollation()
  {
    collation= &my_charset_bin;
    derivation= DERIVATION_NONE;
52 53
    nagg= 0;
    strong= 0;
54 55 56 57 58
  }
  DTCollation(CHARSET_INFO *collation_arg, Derivation derivation_arg)
  {
    collation= collation_arg;
    derivation= derivation_arg;
59 60
    nagg= 0;
    strong= 0;
61
  }
62
  void set(DTCollation &dt)
63
  { 
64 65
    collation= dt.collation;
    derivation= dt.derivation;
66 67 68 69 70 71 72 73 74 75
  }
  void set(CHARSET_INFO *collation_arg, Derivation derivation_arg)
  {
    collation= collation_arg;
    derivation= derivation_arg;
  }
  void set(CHARSET_INFO *collation_arg)
  { collation= collation_arg; }
  void set(Derivation derivation_arg)
  { derivation= derivation_arg; }
76 77 78
  bool aggregate(DTCollation &dt, bool superset_conversion= FALSE);
  bool set(DTCollation &dt1, DTCollation &dt2, bool superset_conversion= FALSE)
  { set(dt1); return aggregate(dt2, superset_conversion); }
79 80 81 82 83 84 85 86 87 88 89 90 91
  const char *derivation_name() const
  {
    switch(derivation)
    {
      case DERIVATION_COERCIBLE: return "COERCIBLE";
      case DERIVATION_IMPLICIT:  return "IMPLICIT";
      case DERIVATION_EXPLICIT:  return "EXPLICIT";
      case DERIVATION_NONE:      return "NONE";
      default: return "UNKNOWN";
    }
  }
};

unknown's avatar
unknown committed
92 93
typedef bool (Item::*Item_processor)(byte *arg);

unknown's avatar
unknown committed
94
class Item {
unknown's avatar
unknown committed
95
  Item(const Item &);			/* Prevent use of these */
unknown's avatar
unknown committed
96 97
  void operator=(Item &);
public:
unknown's avatar
unknown committed
98
  static void *operator new(size_t size) {return (void*) sql_alloc((uint) size); }
99 100
  static void *operator new(size_t size, MEM_ROOT *mem_root)
  { return (void*) alloc_root(mem_root, (uint) size); }
unknown's avatar
unknown committed
101 102
  static void operator delete(void *ptr,size_t size) {} /*lint -e715 */

103 104
  enum Type {FIELD_ITEM, FUNC_ITEM, SUM_FUNC_ITEM, STRING_ITEM,
	     INT_ITEM, REAL_ITEM, NULL_ITEM, VARBIN_ITEM,
unknown's avatar
SCRUM  
unknown committed
105
	     COPY_STR_ITEM, FIELD_AVG_ITEM, DEFAULT_VALUE_ITEM,
unknown's avatar
unknown committed
106 107
	     PROC_ITEM,COND_ITEM, REF_ITEM, FIELD_STD_ITEM,
	     FIELD_VARIANCE_ITEM, INSERT_VALUE_ITEM,
108
             SUBSELECT_ITEM, ROW_ITEM, CACHE_ITEM, TYPE_HOLDER,
109
             PARAM_ITEM, TRIGGER_FIELD_ITEM};
unknown's avatar
SCRUM  
unknown committed
110

unknown's avatar
unknown committed
111
  enum cond_result { COND_UNDEF,COND_OK,COND_TRUE,COND_FALSE };
112
  
unknown's avatar
unknown committed
113 114 115 116 117
  /*
    str_values's main purpose is to be used to cache the value in
    save_in_field
  */
  String str_value;
unknown's avatar
unknown committed
118 119 120
  my_string name;			/* Name from select */
  Item *next;
  uint32 max_length;
121
  uint name_length;                     /* Length of name */
unknown's avatar
unknown committed
122 123 124
  uint8 marker,decimals;
  my_bool maybe_null;			/* If item may be null */
  my_bool null_value;			/* if item is null */
125
  my_bool unsigned_flag;
unknown's avatar
unknown committed
126
  my_bool with_sum_func;
127
  my_bool fixed;                        /* If item fixed with fix_fields */
128
  DTCollation collation;
129

unknown's avatar
unknown committed
130 131
  // alloc & destruct is done as start of select using sql_alloc
  Item();
132 133 134 135
  /*
     Constructor used by Item_field, Item_ref & agregate (sum) functions.
     Used for duplicating lists in processing queries with temporary
     tables
136 137 138
     Also it used for Item_cond_and/Item_cond_or for creating
     top AND/OR ctructure of WHERE clause to protect it of
     optimisation changes in prepared statements
139
  */
140
  Item(THD *thd, Item *item);
unknown's avatar
unknown committed
141 142 143 144
  virtual ~Item()
  {
    name=0;
  }		/*lint -e1509 */
unknown's avatar
unknown committed
145
  void set_name(const char *str,uint length, CHARSET_INFO *cs);
unknown's avatar
unknown committed
146
  void init_make_field(Send_field *tmp_field,enum enum_field_types type);
147
  virtual void cleanup();
148
  virtual void make_field(Send_field *field);
unknown's avatar
unknown committed
149
  virtual bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
unknown committed
150
  /*
unknown's avatar
unknown committed
151
    should be used in case where we are sure that we do not need
unknown's avatar
unknown committed
152 153 154
    complete fix_fields() procedure.
  */
  inline void quick_fix_field() { fixed= 1; }
unknown's avatar
unknown committed
155
  /* Function returns 1 on overflow and -1 on fatal errors */
156
  int save_in_field_no_warnings(Field *field, bool no_conversions);
unknown's avatar
unknown committed
157
  virtual int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
158
  virtual void save_org_in_field(Field *field)
159
  { (void) save_in_field(field, 1); }
unknown's avatar
unknown committed
160
  virtual int save_safe_in_field(Field *field)
161
  { return save_in_field(field, 1); }
162
  virtual bool send(Protocol *protocol, String *str);
163
  virtual bool eq(const Item *, bool binary_cmp) const;
unknown's avatar
unknown committed
164
  virtual Item_result result_type () const { return REAL_RESULT; }
165
  virtual enum_field_types field_type() const;
unknown's avatar
unknown committed
166
  virtual enum Type type() const =0;
167
  /* valXXX methods must return NULL or 0 or 0.0 if null_value is set. */
unknown's avatar
unknown committed
168 169
  virtual double val()=0;
  virtual longlong val_int()=0;
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194
  /*
    Return string representation of this item object.

    The argument to val_str() is an allocated buffer this or any
    nested Item object can use to store return value of this method.
    This buffer should only be used if the item itself doesn't have an
    own String buffer. In case when the item maintains it's own string
    buffer, it's preferrable to return it instead to minimize number of
    mallocs/memcpys.
    The caller of this method can modify returned string, but only in
    case when it was allocated on heap, (is_alloced() is true).  This
    allows the caller to efficiently use a buffer allocated by a child
    without having to allocate a buffer of it's own. The buffer, given
    to val_str() as agrument, belongs to the caller and is later used
    by the caller at it's own choosing.
    A few implications from the above:
    - unless you return a string object which only points to your buffer
      but doesn't manages it you should be ready that it will be
      modified.
    - even for not allocated strings (is_alloced() == false) the caller
      can change charset (see Item_func_{typecast/binary}. XXX: is this
      a bug?
    - still you should try to minimize data copying and return internal
      object whenever possible.
  */
unknown's avatar
unknown committed
195
  virtual String *val_str(String*)=0;
196
  virtual Field *get_tmp_table_field() { return 0; }
197
  virtual Field *tmp_table_field(TABLE *t_arg) { return 0; }
unknown's avatar
unknown committed
198 199 200 201
  virtual const char *full_name() const { return name ? name : "???"; }
  virtual double  val_result() { return val(); }
  virtual longlong val_int_result() { return val_int(); }
  virtual String *str_result(String* tmp) { return val_str(tmp); }
202
  /* bit map of tables used by item */
unknown's avatar
unknown committed
203
  virtual table_map used_tables() const { return (table_map) 0L; }
204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219
  /*
    Return table map of tables that can't be NULL tables (tables that are
    used in a context where if they would contain a NULL row generated
    by a LEFT or RIGHT join, the item would not be true).
    This expression is used on WHERE item to determinate if a LEFT JOIN can be
    converted to a normal join.
    Generally this function should return used_tables() if the function
    would return null if any of the arguments are null
    As this is only used in the beginning of optimization, the value don't
    have to be updated in update_used_tables()
  */
  virtual table_map not_null_tables() const { return used_tables(); }
  /*
    Returns true if this is a simple constant item like an integer, not
    a constant expression
  */
unknown's avatar
unknown committed
220 221 222 223 224
  virtual bool basic_const_item() const { return 0; }
  virtual Item *new_item() { return 0; }	/* Only for const items */
  virtual cond_result eq_cmp_result() const { return COND_OK; }
  inline uint float_length(uint decimals_par) const
  { return decimals != NOT_FIXED_DEC ? (DBL_DIG+2+decimals_par) : DBL_DIG+8;}
225 226 227 228
  /* 
    Returns true if this is constant (during query execution, i.e. its value
    will not change until next fix_fields) and its value is known.
  */
unknown's avatar
unknown committed
229
  virtual bool const_item() const { return used_tables() == 0; }
230 231 232 233 234 235
  /* 
    Returns true if this is constant but its value may be not known yet.
    (Can be used for parameters of prep. stmts or of stored procedures.)
  */
  virtual bool const_during_execution() const 
  { return (used_tables() & ~PARAM_TABLE_BIT) == 0; }
unknown's avatar
unknown committed
236
  virtual void print(String *str_arg) { str_arg->append(full_name()); }
unknown's avatar
unknown committed
237
  void print_item_w_name(String *);
unknown's avatar
unknown committed
238
  virtual void update_used_tables() {}
239
  virtual void split_sum_func(Item **ref_pointer_array, List<Item> &fields) {}
240
  virtual bool get_date(TIME *ltime,uint fuzzydate);
unknown's avatar
unknown committed
241
  virtual bool get_time(TIME *ltime);
242
  virtual bool get_date_result(TIME *ltime,uint fuzzydate)
243
  { return get_date(ltime,fuzzydate); }
244
  virtual bool is_null() { return 0; }
245
  virtual void top_level_item() {}
unknown's avatar
unknown committed
246 247
  virtual void set_result_field(Field *field) {}
  virtual bool is_result_field() { return 0; }
unknown's avatar
unknown committed
248
  virtual bool is_bool_func() { return 0; }
unknown's avatar
unknown committed
249
  virtual void save_in_result_field(bool no_conversions) {}
unknown's avatar
unknown committed
250
  virtual void no_rows_in_result() {}
251
  virtual Item *copy_or_same(THD *thd) { return this; }
252
  virtual Item *copy_andor_structure(THD *thd) { return this; }
unknown's avatar
unknown committed
253
  virtual Item *real_item() { return this; }
254
  virtual Item *get_tmp_table_item(THD *thd) { return copy_or_same(thd); }
unknown's avatar
unknown committed
255

256
  static CHARSET_INFO *default_charset();
257
  virtual CHARSET_INFO *compare_collation() { return NULL; }
unknown's avatar
unknown committed
258 259 260 261 262 263 264

  virtual bool walk(Item_processor processor, byte *arg)
  {
    return (this->*processor)(arg);
  }

  virtual bool remove_dependence_processor(byte * arg) { return 0; }
265
  virtual bool remove_fixed(byte * arg) { fixed= 0; return 0; }
266
  
267 268
  virtual Item *this_item() { return this; } /* For SPs mostly. */
  virtual Item *this_const_item() const { return const_cast<Item*>(this); } /* For SPs mostly. */
unknown's avatar
unknown committed
269 270 271 272

  // Row emulation
  virtual uint cols() { return 1; }
  virtual Item* el(uint i) { return this; }
273
  virtual Item** addr(uint i) { return 0; }
unknown's avatar
unknown committed
274
  virtual bool check_cols(uint c);
unknown's avatar
unknown committed
275
  // It is not row => null inside is impossible
276 277 278
  virtual bool null_inside() { return 0; }
  // used in row subselects to get value of elements
  virtual void bring_value() {}
279 280

  Field *tmp_table_field_from_field_type(TABLE *table);
281
  virtual Item_field *filed_for_view_update() { return 0; }
unknown's avatar
unknown committed
282

283
  virtual Item *neg_transformer(THD *thd) { return NULL; }
284 285 286 287
  void delete_self()
  {
    cleanup();
    delete this;
unknown's avatar
unknown committed
288
  }
unknown's avatar
unknown committed
289 290 291
};


292 293 294 295 296 297
// A local SP variable (incl. parameters), used in runtime
class Item_splocal : public Item
{
private:
  
  uint m_offset;
unknown's avatar
unknown committed
298
  LEX_STRING m_name;
299 300 301

public:

unknown's avatar
unknown committed
302 303
  Item_splocal(LEX_STRING name, uint offset)
    : m_offset(offset), m_name(name)
304 305 306
  {
    Item::maybe_null= TRUE;
  }
307 308 309 310 311 312 313 314 315 316 317

  Item *this_item();
  Item *this_const_item() const;

  inline uint get_offset()
  {
    return m_offset;
  }

  // Abstract methods inherited from Item. Just defer the call to
  // the item in the frame
318
  enum Type type() const;
319 320 321

  inline double val()
  {
322 323 324 325
    Item *it= this_item();
    double ret= it->val();
    Item::null_value= it->null_value;
    return ret;
326 327 328 329
  }

  inline longlong val_int()
  {
330 331 332 333
    Item *it= this_item();
    longlong ret= it->val_int();
    Item::null_value= it->null_value;
    return ret;
334 335 336 337
  }

  inline String *val_str(String *sp)
  {
338 339 340 341 342 343 344 345 346 347 348 349
    Item *it= this_item();
    String *ret= it->val_str(sp);
    Item::null_value= it->null_value;
    return ret;
  }

  inline bool is_null()
  {
    Item *it= this_item();
    bool ret= it->is_null();
    Item::null_value= it->null_value;
    return ret;
350 351 352 353
  }

  inline void make_field(Send_field *field)
  {
354 355 356 357
    Item *it= this_item();

    it->set_name(m_name.str, m_name.length, system_charset_info);
    it->make_field(field);
358 359
  }

360 361 362 363 364 365 366
  inline Item_result result_type() const
  {
    return this_const_item()->result_type();
  }

  inline bool const_item() const
  {
367
    return TRUE;
368 369
  }

370 371 372 373
  inline int save_in_field(Field *field, bool no_conversions)
  {
    return this_item()->save_in_field(field, no_conversions);
  }
unknown's avatar
unknown committed
374

375
  void print(String *str)
unknown's avatar
unknown committed
376
  {
377
    str->reserve(m_name.length+8);
unknown's avatar
unknown committed
378
    str->append(m_name.str, m_name.length);
379 380
    str->append('@');
    str->qs_append(m_offset);
unknown's avatar
unknown committed
381
  }
382 383 384 385 386

  inline bool send(Protocol *protocol, String *str)
  {
    return this_item()->send(protocol, str);
  }
387 388 389
};


390 391 392
class Item_num: public Item
{
public:
unknown's avatar
unknown committed
393
  virtual Item_num *neg()= 0;
394 395
};

396
#define NO_CACHED_FIELD_INDEX ((uint)(-1))
397

unknown's avatar
unknown committed
398
class st_select_lex;
unknown's avatar
unknown committed
399 400
class Item_ident :public Item
{
401 402 403 404 405 406 407 408 409
  /* 
    We have to store initial values of db_name, table_name and field_name
    to be able to restore them during cleanup() because they can be 
    updated during fix_fields() to values from Field object and life-time 
    of those is shorter than life-time of Item_field.
  */
  const char *orig_db_name;
  const char *orig_table_name;
  const char *orig_field_name;
410
  Item **changed_during_fix_field;
unknown's avatar
unknown committed
411 412 413 414
public:
  const char *db_name;
  const char *table_name;
  const char *field_name;
415 416
  /* 
    Cached value of index for this field in table->field array, used by prep. 
417 418 419 420 421 422 423 424
    stmts for speeding up their re-execution. Holds NO_CACHED_FIELD_INDEX 
    if index value is not known.
  */
  uint cached_field_index;
  /*
    Cached pointer to table which contains this field, used for the same reason
    by prep. stmt. too in case then we have not-fully qualified field.
    0 - means no cached value.
425
  */
426
  TABLE_LIST *cached_table;
unknown's avatar
unknown committed
427
  st_select_lex *depended_from;
unknown's avatar
unknown committed
428
  Item_ident(const char *db_name_par,const char *table_name_par,
429
	     const char *field_name_par);
unknown's avatar
unknown committed
430
  Item_ident(THD *thd, Item_ident *item);
unknown's avatar
unknown committed
431
  const char *full_name() const;
432 433 434
  void cleanup();
  void register_item_tree_changing(Item **ref)
    { changed_during_fix_field= ref; }
unknown's avatar
unknown committed
435
  bool remove_dependence_processor(byte * arg);
436
  void print(String *str);
unknown's avatar
VIEW  
unknown committed
437 438 439

  friend bool insert_fields(THD *thd,TABLE_LIST *tables, const char *db_name,
                            const char *table_name, List_iterator<Item> *it,
unknown's avatar
unknown committed
440
                            bool any_privileges, bool allocate_view_names);
unknown's avatar
unknown committed
441 442
};

unknown's avatar
unknown committed
443

unknown's avatar
unknown committed
444 445
class Item_field :public Item_ident
{
446
protected:
unknown's avatar
unknown committed
447 448 449
  void set_field(Field *field);
public:
  Field *field,*result_field;
unknown's avatar
VIEW  
unknown committed
450 451 452 453 454 455 456
  /*
    if any_privileges set to TRUE then here real effective privileges will
    be stored
  */
  uint have_privileges;
  /* field need any privileges (for VIEW creation) */
  bool any_privileges;
unknown's avatar
unknown committed
457 458 459

  Item_field(const char *db_par,const char *table_name_par,
	     const char *field_name_par)
460
    :Item_ident(db_par,table_name_par,field_name_par),
unknown's avatar
VIEW  
unknown committed
461
     field(0), result_field(0), have_privileges(0), any_privileges(0)
462
  { collation.set(DERIVATION_IMPLICIT); }
463
  // Constructor need to process subselect with temporary tables (see Item)
464
  Item_field(THD *thd, Item_field *item);
465 466 467 468 469
  /*
    Constructor used inside setup_wild(), ensures that field and table
    names will live as long as Item_field (important in prep. stmt.)
  */
  Item_field(THD *thd, Field *field);
unknown's avatar
unknown committed
470 471
  Item_field(Field *field);
  enum Type type() const { return FIELD_ITEM; }
472
  bool eq(const Item *item, bool binary_cmp) const;
unknown's avatar
unknown committed
473 474 475 476 477 478
  double val();
  longlong val_int();
  String *val_str(String*);
  double val_result();
  longlong val_int_result();
  String *str_result(String* tmp);
479
  bool send(Protocol *protocol, String *str_arg);
unknown's avatar
unknown committed
480
  bool fix_fields(THD *, struct st_table_list *, Item **);
481
  void make_field(Send_field *tmp_field);
unknown's avatar
unknown committed
482
  int save_in_field(Field *field,bool no_conversions);
unknown's avatar
unknown committed
483 484 485 486 487 488
  void save_org_in_field(Field *field);
  table_map used_tables() const;
  enum Item_result result_type () const
  {
    return field->result_type();
  }
unknown's avatar
unknown committed
489
  enum_field_types field_type() const
490 491 492
  {
    return field->type();
  }
493
  Field *get_tmp_table_field() { return result_field; }
494
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
495 496
  bool get_date(TIME *ltime,uint fuzzydate);
  bool get_date_result(TIME *ltime,uint fuzzydate);
497
  bool get_time(TIME *ltime);
unknown's avatar
unknown committed
498
  bool is_null() { return field->is_null(); }
499
  Item *get_tmp_table_item(THD *thd);
unknown's avatar
unknown committed
500
  void cleanup();
unknown's avatar
unknown committed
501
  inline uint32 max_disp_length() { return field->max_length(); }
502
  Item_field *filed_for_view_update() { return this; }
unknown's avatar
SCRUM  
unknown committed
503
  friend class Item_default_value;
unknown's avatar
unknown committed
504
  friend class Item_insert_value;
unknown's avatar
unknown committed
505
  friend class st_select_lex_unit;
unknown's avatar
unknown committed
506 507 508 509 510 511
};

class Item_null :public Item
{
public:
  Item_null(char *name_par=0)
unknown's avatar
unknown committed
512 513 514 515 516 517
  {
    maybe_null= null_value= TRUE;
    max_length= 0;
    name= name_par ? name_par : (char*) "NULL";
    fixed= 1;
  }
unknown's avatar
unknown committed
518
  enum Type type() const { return NULL_ITEM; }
519
  bool eq(const Item *item, bool binary_cmp) const;
unknown's avatar
unknown committed
520 521 522
  double val();
  longlong val_int();
  String *val_str(String *str);
unknown's avatar
unknown committed
523
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
524
  int save_safe_in_field(Field *field);
unknown's avatar
unknown committed
525
  bool send(Protocol *protocol, String *str);
526 527
  enum Item_result result_type () const { return STRING_RESULT; }
  enum_field_types field_type() const   { return MYSQL_TYPE_NULL; }
unknown's avatar
unknown committed
528 529
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
unknown's avatar
unknown committed
530 531
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_null(name); }
unknown's avatar
unknown committed
532
  bool is_null() { return 1; }
533
  void print(String *str) { str->append("NULL", 4); }
unknown's avatar
unknown committed
534 535
};

536 537 538

/* Item represents one placeholder ('?') of prepared statement */

unknown's avatar
unknown committed
539 540
class Item_param :public Item
{
541
public:
542 543 544 545 546 547
  enum enum_item_param_state
  {
    NO_VALUE, NULL_VALUE, INT_VALUE, REAL_VALUE,
    STRING_VALUE, TIME_VALUE, LONG_DATA_VALUE
  } state;

548 549 550 551 552 553 554 555 556 557 558
  /*
    A buffer for string and long data values. Historically all allocated
    values returned from val_str() were treated as eligible to
    modification. I. e. in some cases Item_func_concat can append it's
    second argument to return value of the first one. Because of that we
    can't return the original buffer holding string data from val_str(),
    and have to have one buffer for data and another just pointing to
    the data. This is the latter one and it's returned from val_str().
    Can not be declared inside the union as it's not a POD type.
  */
  String str_value_ptr;
559 560
  union
  {
561 562
    longlong integer;
    double   real;
563 564 565 566 567 568 569 570 571 572 573 574
    /*
      Character sets conversion info for string values.
      Character sets of client and connection defined at bind time are used
      for all conversions, even if one of them is later changed (i.e.
      between subsequent calls to mysql_stmt_execute).
    */
    struct CONVERSION_INFO
    {
      CHARSET_INFO *character_set_client;
      /*
        This points at character set of connection if conversion
        to it is required (i. e. if placeholder typecode is not BLOB).
575
        Otherwise it's equal to character_set_client (to simplify
576 577 578 579 580 581 582 583
        check in convert_str_value()).
      */
      CHARSET_INFO *final_character_set_of_str_value;
    } cs_info;
    TIME     time;
  } value;

  /* Cached values for virtual methods to save us one switch.  */
unknown's avatar
unknown committed
584 585
  enum Item_result item_result_type;
  enum Type item_type;
586 587 588 589 590 591 592 593 594 595

  /*
    Used when this item is used in a temporary table.
    This is NOT placeholder metadata sent to client, as this value
    is assigned after sending metadata (in setup_one_conversion_function).
    For example in case of 'SELECT ?' you'll get MYSQL_TYPE_STRING both
    in result set and placeholders metadata, no matter what type you will
    supply for this placeholder in mysql_stmt_execute.
  */
  enum enum_field_types param_type;
596
  /*
597 598
    Offset of placeholder inside statement text. Used to create
    no-placeholders version of this statement for the binary log.
599
  */
600
  uint pos_in_query;
unknown's avatar
unknown committed
601

602 603 604
  Item_param(uint pos_in_query_arg);

  enum Item_result result_type () const { return item_result_type; }
unknown's avatar
unknown committed
605
  enum Type type() const { return item_type; }
606
  enum_field_types field_type() const { return param_type; }
607

unknown's avatar
unknown committed
608 609 610
  double val();
  longlong val_int();
  String *val_str(String*);
611
  bool get_time(TIME *tm);
612
  bool get_date(TIME *tm, uint fuzzydate);
unknown's avatar
unknown committed
613
  int  save_in_field(Field *field, bool no_conversions);
614

unknown's avatar
unknown committed
615
  void set_null();
616
  void set_int(longlong i, uint32 max_length_arg);
unknown's avatar
unknown committed
617
  void set_double(double i);
618 619 620
  bool set_str(const char *str, ulong length);
  bool set_longdata(const char *str, ulong length);
  void set_time(TIME *tm, timestamp_type type, uint32 max_length_arg);
621
  bool set_from_user_var(THD *thd, const user_var_entry *entry);
622
  void reset();
623 624 625 626 627 628 629 630
  /*
    Assign placeholder value from bind data.
    Note, that 'len' has different semantics in embedded library (as we
    don't need to check that packet is not broken there). See
    sql_prepare.cc for details.
  */
  void (*set_param_func)(Item_param *param, uchar **pos, ulong len);

631 632 633
  const String *query_val_str(String *str) const;

  bool convert_str_value(THD *thd);
634

635
  Item *new_item() { return new Item_param(pos_in_query); }
636 637 638
  /*
    If value for parameter was not set we treat it as non-const
    so noone will use parameters value in fix_fields still
639 640 641
    parameter is constant during execution.
  */
  virtual table_map used_tables() const
642
  { return state != NO_VALUE ? (table_map)0 : PARAM_TABLE_BIT; }
643
  void print(String *str);
644 645
  /* parameter never equal to other parameter of other item */
  bool eq(const Item *item, bool binary_cmp) const { return 0; }
unknown's avatar
unknown committed
646
};
unknown's avatar
unknown committed
647

648
class Item_int :public Item_num
unknown's avatar
unknown committed
649 650
{
public:
651
  longlong value;
unknown's avatar
unknown committed
652
  Item_int(int32 i,uint length=11) :value((longlong) i)
653
    { max_length=length; fixed= 1; }
unknown's avatar
unknown committed
654 655
#ifdef HAVE_LONG_LONG
  Item_int(longlong i,uint length=21) :value(i)
656
    { max_length=length; fixed= 1;}
unknown's avatar
unknown committed
657 658
#endif
  Item_int(const char *str_arg,longlong i,uint length) :value(i)
659
    { max_length=length; name=(char*) str_arg; fixed= 1; }
unknown's avatar
unknown committed
660
  Item_int(const char *str_arg, uint length=64);
unknown's avatar
unknown committed
661
  enum Type type() const { return INT_ITEM; }
662 663
  enum Item_result result_type () const { return INT_RESULT; }
  enum_field_types field_type() const { return MYSQL_TYPE_LONGLONG; }
664 665
  longlong val_int() { DBUG_ASSERT(fixed == 1); return value; }
  double val() { DBUG_ASSERT(fixed == 1); return (double) value; }
unknown's avatar
unknown committed
666
  String *val_str(String*);
unknown's avatar
unknown committed
667
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
668 669
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_int(name,value,max_length); }
670
  // to prevent drop fixed flag (no need parent cleanup call)
unknown's avatar
unknown committed
671
  void cleanup() {}
unknown's avatar
unknown committed
672
  void print(String *str);
unknown's avatar
unknown committed
673
  Item_num *neg() { value= -value; return this; }
unknown's avatar
unknown committed
674 675 676
};


677 678 679 680 681 682 683 684 685 686 687
class Item_static_int_func :public Item_int
{
  const char *func_name;
public:
  Item_static_int_func(const char *str_arg, longlong i, uint length)
    :Item_int(NullS, i, length), func_name(str_arg)
  {}
  void print(String *str) { str->append(func_name); }
};


unknown's avatar
unknown committed
688 689 690
class Item_uint :public Item_int
{
public:
unknown's avatar
unknown committed
691
  Item_uint(const char *str_arg, uint length);
692
  Item_uint(uint32 i) :Item_int((longlong) i, 10) 
unknown's avatar
unknown committed
693
    { unsigned_flag= 1; }
694 695
  double val()
    { DBUG_ASSERT(fixed == 1); return ulonglong2double((ulonglong)value); }
unknown's avatar
unknown committed
696 697
  String *val_str(String*);
  Item *new_item() { return new Item_uint(name,max_length); }
unknown's avatar
unknown committed
698
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
699
  void print(String *str);
unknown's avatar
unknown committed
700
  Item_num *neg ();
unknown's avatar
unknown committed
701 702 703
};


704
class Item_real :public Item_num
unknown's avatar
unknown committed
705
{
706
  char *presentation;
unknown's avatar
unknown committed
707
public:
708
  double value;
unknown's avatar
unknown committed
709
  // Item_real() :value(0) {}
unknown's avatar
unknown committed
710
  Item_real(const char *str_arg, uint length) :value(my_atof(str_arg))
unknown's avatar
unknown committed
711
  {
712
    presentation= name=(char*) str_arg;
unknown's avatar
unknown committed
713
    decimals=(uint8) nr_of_decimals(str_arg);
unknown's avatar
unknown committed
714
    max_length=length;
unknown's avatar
unknown committed
715
    fixed= 1;
unknown's avatar
unknown committed
716 717 718 719
  }
  Item_real(const char *str,double val_arg,uint decimal_par,uint length)
    :value(val_arg)
  {
720
    presentation= name=(char*) str;
unknown's avatar
unknown committed
721
    decimals=(uint8) decimal_par;
unknown's avatar
unknown committed
722
    max_length=length;
unknown's avatar
unknown committed
723
    fixed= 1;
unknown's avatar
unknown committed
724
  }
725
  Item_real(double value_par) :presentation(0), value(value_par) { fixed= 1; }
unknown's avatar
unknown committed
726
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
727
  enum Type type() const { return REAL_ITEM; }
728
  enum_field_types field_type() const { return MYSQL_TYPE_DOUBLE; }
729 730 731 732 733 734
  double val() { DBUG_ASSERT(fixed == 1); return value; }
  longlong val_int()
  {
    DBUG_ASSERT(fixed == 1);
    return (longlong) (value+(value > 0 ? 0.5 : -0.5));
  }
unknown's avatar
unknown committed
735 736
  String *val_str(String*);
  bool basic_const_item() const { return 1; }
unknown's avatar
unknown committed
737 738
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
unknown's avatar
unknown committed
739
  Item *new_item() { return new Item_real(name,value,decimals,max_length); }
unknown's avatar
unknown committed
740
  Item_num *neg() { value= -value; return this; }
741
  void print(String *str);
unknown's avatar
unknown committed
742 743 744
};


745 746 747 748 749 750 751 752 753 754 755 756
class Item_static_real_func :public Item_real
{
  const char *func_name;
public:
  Item_static_real_func(const char *str, double val_arg, uint decimal_par,
                        uint length)
    :Item_real(NullS, val_arg, decimal_par, length), func_name(str)
  {}
  void print(String *str) { str->append(func_name); }
};


unknown's avatar
unknown committed
757 758 759 760 761 762 763 764 765 766 767 768 769
class Item_float :public Item_real
{
public:
  Item_float(const char *str,uint length) :Item_real(str,length)
  {
    decimals=NOT_FIXED_DEC;
    max_length=DBL_DIG+8;
  }
};

class Item_string :public Item
{
public:
unknown's avatar
unknown committed
770
  Item_string(const char *str,uint length,
771
  	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
unknown's avatar
unknown committed
772
  {
773
    collation.set(cs, dv);
unknown's avatar
unknown committed
774
    str_value.set_or_copy_aligned(str,length,cs);
775 776 777 778 779 780 781
    /*
      We have to have a different max_length than 'length' here to
      ensure that we get the right length if we do use the item
      to create a new table. In this case max_length must be the maximum
      number of chars for a string of this type because we in create_field::
      divide the max_length with mbmaxlen).
    */
782
    max_length= str_value.numchars()*cs->mbmaxlen;
unknown's avatar
unknown committed
783
    set_name(str, length, cs);
unknown's avatar
unknown committed
784
    decimals=NOT_FIXED_DEC;
785 786
    // it is constant => can be used without fix_fields (and frequently used)
    fixed= 1;
unknown's avatar
unknown committed
787
  }
788
  Item_string(const char *name_par, const char *str, uint length,
789
	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
unknown's avatar
unknown committed
790
  {
791
    collation.set(cs, dv);
unknown's avatar
unknown committed
792
    str_value.set_or_copy_aligned(str,length,cs);
793
    max_length= str_value.numchars()*cs->mbmaxlen;
unknown's avatar
unknown committed
794
    set_name(name_par,0,cs);
unknown's avatar
unknown committed
795
    decimals=NOT_FIXED_DEC;
796 797
    // it is constant => can be used without fix_fields (and frequently used)
    fixed= 1;
unknown's avatar
unknown committed
798 799
  }
  enum Type type() const { return STRING_ITEM; }
800
  double val()
801 802
  {
    DBUG_ASSERT(fixed == 1);
803
    int err;
804
    return my_strntod(str_value.charset(), (char*) str_value.ptr(),
805
		      str_value.length(), (char**) 0, &err);
806 807 808
  }
  longlong val_int()
  {
809
    DBUG_ASSERT(fixed == 1);
810
    int err;
811
    return my_strntoll(str_value.charset(), str_value.ptr(),
812
		       str_value.length(), 10, (char**) 0, &err);
813
  }
814 815 816 817 818
  String *val_str(String*)
  {
    DBUG_ASSERT(fixed == 1);
    return (String*) &str_value;
  }
unknown's avatar
unknown committed
819
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
820
  enum Item_result result_type () const { return STRING_RESULT; }
821
  enum_field_types field_type() const { return MYSQL_TYPE_STRING; }
unknown's avatar
unknown committed
822
  bool basic_const_item() const { return 1; }
823
  bool eq(const Item *item, bool binary_cmp) const;
824 825
  Item *new_item() 
  {
826 827
    return new Item_string(name, str_value.ptr(), 
    			   str_value.length(), &my_charset_bin);
828
  }
unknown's avatar
unknown committed
829
  String *const_string() { return &str_value; }
830
  inline void append(char *str, uint length) { str_value.append(str, length); }
unknown's avatar
unknown committed
831
  void print(String *str);
unknown's avatar
unknown committed
832 833
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
unknown's avatar
unknown committed
834 835
};

836 837 838 839 840 841 842 843 844 845 846 847 848 849

class Item_static_string_func :public Item_string
{
  const char *func_name;
public:
  Item_static_string_func(const char *name_par, const char *str, uint length,
                          CHARSET_INFO *cs,
                          Derivation dv= DERIVATION_COERCIBLE)
    :Item_string(NullS, str, length, cs, dv), func_name(name_par)
  {}
  void print(String *str) { str->append(func_name); }
};


unknown's avatar
unknown committed
850 851 852 853 854
/* for show tables */

class Item_datetime :public Item_string
{
public:
unknown's avatar
unknown committed
855 856
  Item_datetime(const char *item_name): Item_string(item_name,"",0,
  						    &my_charset_bin)
unknown's avatar
unknown committed
857
  { max_length=19;}
858
  enum_field_types field_type() const { return MYSQL_TYPE_DATETIME; }
unknown's avatar
unknown committed
859 860 861 862 863
};

class Item_empty_string :public Item_string
{
public:
unknown's avatar
unknown committed
864 865
  Item_empty_string(const char *header,uint length) :Item_string("",0,
  							&my_charset_bin)
unknown's avatar
unknown committed
866
    { name=(char*) header; max_length=length;}
867
  void make_field(Send_field *field);
unknown's avatar
unknown committed
868 869
};

870 871 872 873 874 875 876 877 878 879 880 881 882 883
class Item_return_int :public Item_int
{
  enum_field_types int_field_type;
public:
  Item_return_int(const char *name, uint length,
		  enum_field_types field_type_arg)
    :Item_int(name, 0, length), int_field_type(field_type_arg)
  {
    unsigned_flag=1;
  }
  enum_field_types field_type() const { return int_field_type; }
};


unknown's avatar
unknown committed
884 885 886
class Item_varbinary :public Item
{
public:
887
  Item_varbinary(const char *str,uint str_length);
unknown's avatar
unknown committed
888
  enum Type type() const { return VARBIN_ITEM; }
889 890
  double val()
    { DBUG_ASSERT(fixed == 1); return (double) Item_varbinary::val_int(); }
unknown's avatar
unknown committed
891
  longlong val_int();
unknown's avatar
unknown committed
892
  bool basic_const_item() const { return 1; }
893
  String *val_str(String*) { DBUG_ASSERT(fixed == 1); return &str_value; }
unknown's avatar
unknown committed
894
  int save_in_field(Field *field, bool no_conversions);
895
  enum Item_result result_type () const { return STRING_RESULT; }
896
  enum_field_types field_type() const { return MYSQL_TYPE_STRING; }
unknown's avatar
unknown committed
897 898
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
unknown's avatar
unknown committed
899 900 901 902 903 904 905 906
};


class Item_result_field :public Item	/* Item with result field */
{
public:
  Field *result_field;				/* Save result here */
  Item_result_field() :result_field(0) {}
907
  // Constructor used for Item_sum/Item_cond_and/or (see Item comment)
908 909
  Item_result_field(THD *thd, Item_result_field *item):
    Item(thd, item), result_field(item->result_field)
910
  {}
unknown's avatar
unknown committed
911
  ~Item_result_field() {}			/* Required with gcc 2.95 */
912
  Field *get_tmp_table_field() { return result_field; }
913
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
unknown's avatar
unknown committed
914
  table_map used_tables() const { return 1; }
unknown's avatar
unknown committed
915
  virtual void fix_length_and_dec()=0;
unknown's avatar
unknown committed
916 917 918 919 920 921
  void set_result_field(Field *field) { result_field= field; }
  bool is_result_field() { return 1; }
  void save_in_result_field(bool no_conversions)
  {
    save_in_field(result_field, no_conversions);
  }
unknown's avatar
unknown committed
922 923 924 925 926 927
};


class Item_ref :public Item_ident
{
public:
unknown's avatar
unknown committed
928
  Field *result_field;			 /* Save result here */
unknown's avatar
unknown committed
929
  Item **ref;
unknown's avatar
unknown committed
930 931 932 933
  Item **hook_ptr;                       /* These two to restore  */
  Item *orig_item;                       /* things in 'cleanup()' */
  Item_ref(Item **hook, Item *original,const char *db_par,
	   const char *table_name_par, const char *field_name_par)
unknown's avatar
unknown committed
934 935 936
    :Item_ident(db_par, table_name_par, field_name_par), result_field(0),
     ref(0), hook_ptr(hook), orig_item(original) {}
  Item_ref(Item **item, Item **hook,
unknown's avatar
unknown committed
937
	   const char *table_name_par, const char *field_name_par)
unknown's avatar
unknown committed
938
    :Item_ident(NullS, table_name_par, field_name_par), result_field(0),
unknown's avatar
unknown committed
939
    ref(item), hook_ptr(hook), orig_item(hook ? *hook:0) {}
940
  // Constructor need to process subselect with temporary tables (see Item)
941
  Item_ref(THD *thd, Item_ref *item, Item **hook)
unknown's avatar
unknown committed
942
    :Item_ident(thd, item), result_field(item->result_field), ref(item->ref),
unknown's avatar
unknown committed
943
    hook_ptr(hook), orig_item(hook ? *hook : 0) {}
unknown's avatar
unknown committed
944
  enum Type type() const		{ return REF_ITEM; }
945
  bool eq(const Item *item, bool binary_cmp) const
unknown's avatar
unknown committed
946
  { return ref && (*ref)->eq(item, binary_cmp); }
unknown's avatar
unknown committed
947 948 949
  double val()
  {
    double tmp=(*ref)->val_result();
unknown's avatar
unknown committed
950
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
951 952 953 954 955
    return tmp;
  }
  longlong val_int()
  {
    longlong tmp=(*ref)->val_int_result();
unknown's avatar
unknown committed
956
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
957 958 959 960 961
    return tmp;
  }
  String *val_str(String* tmp)
  {
    tmp=(*ref)->str_result(tmp);
unknown's avatar
unknown committed
962
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
963 964
    return tmp;
  }
965 966 967
  bool is_null()
  {
    (void) (*ref)->val_int_result();
unknown's avatar
unknown committed
968
    return (*ref)->null_value;
969
  }
970
  bool get_date(TIME *ltime,uint fuzzydate)
971 972
  {
    return (null_value=(*ref)->get_date_result(ltime,fuzzydate));
unknown's avatar
unknown committed
973
  }
974 975 976
  double val_result();
  longlong val_int_result();
  String *str_result(String* tmp);
977
  bool send(Protocol *prot, String *tmp);
unknown's avatar
unknown committed
978
  void make_field(Send_field *field)	{ (*ref)->make_field(field); }
unknown's avatar
unknown committed
979
  bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
unknown committed
980
  int save_in_field(Field *field, bool no_conversions)
981
  { return (*ref)->save_in_field(field, no_conversions); }
unknown's avatar
unknown committed
982 983
  void save_org_in_field(Field *field)	{ (*ref)->save_org_in_field(field); }
  enum Item_result result_type () const { return (*ref)->result_type(); }
984
  enum_field_types field_type() const   { return (*ref)->field_type(); }
985 986 987 988
  table_map used_tables() const		
  { 
    return depended_from ? OUTER_REF_TABLE_BIT : (*ref)->used_tables(); 
  }
989
  void set_result_field(Field *field)	{ result_field= field; }
unknown's avatar
unknown committed
990
  Field *get_tmp_table_field() { return result_field; }
unknown's avatar
unknown committed
991 992 993 994 995
  bool is_result_field() { return 1; }
  void save_in_result_field(bool no_conversions)
  {
    (*ref)->save_in_field(result_field, no_conversions);
  }
unknown's avatar
unknown committed
996
  Item *real_item() { return *ref; }
unknown's avatar
unknown committed
997
  void print(String *str);
unknown's avatar
unknown committed
998
  void cleanup();
unknown's avatar
unknown committed
999 1000
};

1001 1002 1003 1004 1005 1006 1007
class Item_in_subselect;
class Item_ref_null_helper: public Item_ref
{
protected:
  Item_in_subselect* owner;
public:
  Item_ref_null_helper(Item_in_subselect* master, Item **item,
unknown's avatar
unknown committed
1008
		       const char *table_name_par, const char *field_name_par):
unknown's avatar
unknown committed
1009
    Item_ref(item, NULL, table_name_par, field_name_par), owner(master) {}
1010 1011 1012
  double val();
  longlong val_int();
  String* val_str(String* s);
1013
  bool get_date(TIME *ltime, uint fuzzydate);
unknown's avatar
unknown committed
1014
  void print(String *str);
1015 1016
};

1017 1018 1019 1020 1021 1022 1023 1024 1025
class Item_null_helper :public Item_ref_null_helper
{
  Item *store;
public:
  Item_null_helper(Item_in_subselect* master, Item *item,
		   const char *table_name_par, const char *field_name_par)
    :Item_ref_null_helper(master, &store, table_name_par, field_name_par),
     store(item)
    {}
unknown's avatar
unknown committed
1026
  void print(String *str);
1027
};
unknown's avatar
unknown committed
1028

1029
/*
1030
  The following class is used to optimize comparing of date and bigint columns
1031 1032 1033 1034 1035 1036 1037 1038 1039
  We need to save the original item, to be able to set the field to the
  original value in 'opt_range'.
*/

class Item_int_with_ref :public Item_int
{
  Item *ref;
public:
  Item_int_with_ref(longlong i, Item *ref_arg) :Item_int(i), ref(ref_arg)
1040 1041 1042
  {
    unsigned_flag= ref_arg->unsigned_flag;
  }
unknown's avatar
unknown committed
1043
  int save_in_field(Field *field, bool no_conversions)
1044
  {
1045
    return ref->save_in_field(field, no_conversions);
1046 1047 1048 1049
  }
};


1050
#include "gstream.h"
unknown's avatar
unknown committed
1051
#include "spatial.h"
unknown's avatar
unknown committed
1052 1053
#include "item_sum.h"
#include "item_func.h"
1054
#include "item_row.h"
unknown's avatar
unknown committed
1055 1056
#include "item_cmpfunc.h"
#include "item_strfunc.h"
1057
#include "item_geofunc.h"
unknown's avatar
unknown committed
1058 1059
#include "item_timefunc.h"
#include "item_uniq.h"
1060
#include "item_subselect.h"
unknown's avatar
unknown committed
1061 1062 1063

class Item_copy_string :public Item
{
1064
  enum enum_field_types cached_field_type;
unknown's avatar
unknown committed
1065 1066 1067 1068 1069 1070 1071 1072
public:
  Item *item;
  Item_copy_string(Item *i) :item(i)
  {
    null_value=maybe_null=item->maybe_null;
    decimals=item->decimals;
    max_length=item->max_length;
    name=item->name;
1073
    cached_field_type= item->field_type();
unknown's avatar
unknown committed
1074 1075 1076
  }
  enum Type type() const { return COPY_STR_ITEM; }
  enum Item_result result_type () const { return STRING_RESULT; }
1077
  enum_field_types field_type() const { return cached_field_type; }
unknown's avatar
unknown committed
1078
  double val()
1079
  {
1080
    int err;
1081 1082
    return (null_value ? 0.0 :
	    my_strntod(str_value.charset(), (char*) str_value.ptr(),
1083
		       str_value.length(),NULL,&err));
1084
  }
unknown's avatar
unknown committed
1085
  longlong val_int()
1086 1087 1088 1089
  { 
    int err;
    return null_value ? LL(0) : my_strntoll(str_value.charset(),str_value.ptr(),str_value.length(),10, (char**) 0,&err); 
  }
unknown's avatar
unknown committed
1090 1091 1092
  String *val_str(String*);
  void make_field(Send_field *field) { item->make_field(field); }
  void copy();
unknown's avatar
unknown committed
1093
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
1094 1095
  table_map used_tables() const { return (table_map) 1L; }
  bool const_item() const { return 0; }
unknown's avatar
unknown committed
1096
  bool is_null() { return null_value; }
unknown's avatar
unknown committed
1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153
};


class Item_buff :public Sql_alloc
{
public:
  my_bool null_value;
  Item_buff() :null_value(0) {}
  virtual bool cmp(void)=0;
  virtual ~Item_buff(); /*line -e1509 */
};

class Item_str_buff :public Item_buff
{
  Item *item;
  String value,tmp_value;
public:
  Item_str_buff(Item *arg) :item(arg),value(arg->max_length) {}
  bool cmp(void);
  ~Item_str_buff();				// Deallocate String:s
};


class Item_real_buff :public Item_buff
{
  Item *item;
  double value;
public:
  Item_real_buff(Item *item_par) :item(item_par),value(0.0) {}
  bool cmp(void);
};

class Item_int_buff :public Item_buff
{
  Item *item;
  longlong value;
public:
  Item_int_buff(Item *item_par) :item(item_par),value(0) {}
  bool cmp(void);
};


class Item_field_buff :public Item_buff
{
  char *buff;
  Field *field;
  uint length;

public:
  Item_field_buff(Item_field *item)
  {
    field=item->field;
    buff= (char*) sql_calloc(length=field->pack_length());
  }
  bool cmp(void);
};

unknown's avatar
SCRUM  
unknown committed
1154 1155 1156 1157
class Item_default_value : public Item_field
{
public:
  Item *arg;
unknown's avatar
SCRUM  
unknown committed
1158 1159
  Item_default_value() :
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(NULL) {}
unknown's avatar
unknown committed
1160
  Item_default_value(Item *a) :
unknown's avatar
SCRUM  
unknown committed
1161
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(a) {}
unknown's avatar
SCRUM  
unknown committed
1162
  enum Type type() const { return DEFAULT_VALUE_ITEM; }
unknown's avatar
SCRUM  
unknown committed
1163 1164
  bool eq(const Item *item, bool binary_cmp) const;
  bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
SCRUM  
unknown committed
1165
  void print(String *str);
1166
  int save_in_field(Field *field_arg, bool no_conversions)
unknown's avatar
SCRUM  
unknown committed
1167 1168 1169
  {
    if (!arg)
    {
1170
      field_arg->set_default();
unknown's avatar
SCRUM  
unknown committed
1171 1172
      return 0;
    }
1173
    return Item_field::save_in_field(field_arg, no_conversions);
unknown's avatar
SCRUM  
unknown committed
1174
  }
unknown's avatar
SCRUM  
unknown committed
1175
  table_map used_tables() const { return (table_map)0L; }
unknown's avatar
unknown committed
1176 1177 1178 1179 1180 1181
  
  bool walk(Item_processor processor, byte *args)
  {
    return arg->walk(processor, args) ||
      (this->*processor)(args);
  }
unknown's avatar
unknown committed
1182
};
unknown's avatar
unknown committed
1183

unknown's avatar
unknown committed
1184 1185 1186 1187 1188 1189 1190 1191 1192
class Item_insert_value : public Item_field
{
public:
  Item *arg;
  Item_insert_value(Item *a) :
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(a) {}
  bool eq(const Item *item, bool binary_cmp) const;
  bool fix_fields(THD *, struct st_table_list *, Item **);
  void print(String *str);
1193
  int save_in_field(Field *field_arg, bool no_conversions)
unknown's avatar
unknown committed
1194
  {
1195
    return Item_field::save_in_field(field_arg, no_conversions);
unknown's avatar
unknown committed
1196 1197
  }
  table_map used_tables() const { return (table_map)0L; }
unknown's avatar
unknown committed
1198 1199 1200 1201 1202 1203

  bool walk(Item_processor processor, byte *args)
  {
    return arg->walk(processor, args) ||
	    (this->*processor)(args);
  }
unknown's avatar
unknown committed
1204 1205
};

1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256

/*
  We need this two enums here instead of sql_lex.h because
  at least one of them is used by Item_trigger_field interface.

  Time when trigger is invoked (i.e. before or after row actually
  inserted/updated/deleted).
*/
enum trg_action_time_type
{
  TRG_ACTION_BEFORE= 0, TRG_ACTION_AFTER= 1
};

/*
  Event on which trigger is invoked.
*/
enum trg_event_type
{
  TRG_EVENT_INSERT= 0 , TRG_EVENT_UPDATE= 1, TRG_EVENT_DELETE= 2
};

/*
  Represents NEW/OLD version of field of row which is
  changed/read in trigger.

  Note: For this item actual binding to Field object happens not during
        fix_fields() (like for Item_field) but during parsing of trigger
        definition, when table is opened, with special setup_field() call.
*/
class Item_trigger_field : public Item_field
{
public:
  /* Is this item represents row from NEW or OLD row ? */
  enum row_version_type {OLD_ROW, NEW_ROW};
  row_version_type row_version;

  Item_trigger_field(row_version_type row_ver_par,
                     const char *field_name_par):
    Item_field((const char *)NULL, (const char *)NULL, field_name_par),
    row_version(row_ver_par)
  {}
  bool setup_field(THD *thd, TABLE *table, enum trg_event_type event);
  enum Type type() const { return TRIGGER_FIELD_ITEM; }
  bool eq(const Item *item, bool binary_cmp) const;
  bool fix_fields(THD *, struct st_table_list *, Item **);
  void print(String *str);
  table_map used_tables() const { return (table_map)0L; }
  void cleanup();
};


1257 1258
class Item_cache: public Item
{
unknown's avatar
unknown committed
1259 1260
protected:
  Item *example;
1261
  table_map used_table_map;
1262
public:
unknown's avatar
unknown committed
1263
  Item_cache(): example(0), used_table_map(0) {fixed= 1; null_value= 1;}
1264 1265 1266

  void set_used_tables(table_map map) { used_table_map= map; }

unknown's avatar
unknown committed
1267
  virtual bool allocate(uint i) { return 0; }
1268
  virtual bool setup(Item *item)
1269
  {
1270 1271 1272 1273 1274 1275
    example= item;
    max_length= item->max_length;
    decimals= item->decimals;
    collation.set(item->collation);
    return 0;
  };
1276 1277
  virtual void store(Item *)= 0;
  enum Type type() const { return CACHE_ITEM; }
1278
  static Item_cache* get_cache(Item_result type);
1279
  table_map used_tables() const { return used_table_map; }
1280
  virtual void keep_array() {}
1281
  // to prevent drop fixed flag (no need parent cleanup call)
unknown's avatar
unknown committed
1282
  void cleanup() {}
unknown's avatar
unknown committed
1283
  void print(String *str);
1284 1285 1286 1287 1288 1289
};

class Item_cache_int: public Item_cache
{
  longlong value;
public:
1290
  Item_cache_int(): Item_cache() {}
1291
  
unknown's avatar
unknown committed
1292
  void store(Item *item);
1293 1294 1295 1296 1297 1298 1299 1300
  double val() { DBUG_ASSERT(fixed == 1); return (double) value; }
  longlong val_int() { DBUG_ASSERT(fixed == 1); return value; }
  String* val_str(String *str)
  {
    DBUG_ASSERT(fixed == 1);
    str->set(value, default_charset());
    return str;
  }
1301 1302 1303 1304 1305 1306 1307
  enum Item_result result_type() const { return INT_RESULT; }
};

class Item_cache_real: public Item_cache
{
  double value;
public:
1308
  Item_cache_real(): Item_cache() {}
1309

unknown's avatar
unknown committed
1310
  void store(Item *item);
1311 1312 1313 1314 1315 1316
  double val() { DBUG_ASSERT(fixed == 1); return value; }
  longlong val_int()
  {
    DBUG_ASSERT(fixed == 1);
    return (longlong) (value+(value > 0 ? 0.5 : -0.5));
  }
1317 1318
  String* val_str(String *str)
  {
1319
    str->set(value, decimals, default_charset());
1320 1321 1322 1323 1324 1325 1326 1327
    return str;
  }
  enum Item_result result_type() const { return REAL_RESULT; }
};

class Item_cache_str: public Item_cache
{
  char buffer[80];
1328
  String *value, value_buff;
1329
public:
1330
  Item_cache_str(): Item_cache() { }
1331
  
1332 1333 1334
  void store(Item *item);
  double val();
  longlong val_int();
1335
  String* val_str(String *) { DBUG_ASSERT(fixed == 1); return value; }
1336 1337 1338 1339
  enum Item_result result_type() const { return STRING_RESULT; }
  CHARSET_INFO *charset() const { return value->charset(); };
};

unknown's avatar
unknown committed
1340 1341 1342
class Item_cache_row: public Item_cache
{
  Item_cache  **values;
unknown's avatar
unknown committed
1343
  uint item_count;
1344
  bool save_array;
unknown's avatar
unknown committed
1345
public:
1346 1347
  Item_cache_row()
    :Item_cache(), values(0), item_count(2), save_array(0) {}
unknown's avatar
unknown committed
1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381
  
  /*
    'allocate' used only in row transformer, to preallocate space for row 
    cache.
  */
  bool allocate(uint num);
  /*
    'setup' is needed only by row => it not called by simple row subselect
    (only by IN subselect (in subselect optimizer))
  */
  bool setup(Item *item);
  void store(Item *item);
  void illegal_method_call(const char *);
  void make_field(Send_field *)
  {
    illegal_method_call((const char*)"make_field");
  };
  double val()
  {
    illegal_method_call((const char*)"val");
    return 0;
  };
  longlong val_int()
  {
    illegal_method_call((const char*)"val_int");
    return 0;
  };
  String *val_str(String *)
  {
    illegal_method_call((const char*)"val_str");
    return 0;
  };
  enum Item_result result_type() const { return ROW_RESULT; }
  
unknown's avatar
unknown committed
1382
  uint cols() { return item_count; }
unknown's avatar
unknown committed
1383 1384 1385 1386 1387
  Item* el(uint i) { return values[i]; }
  Item** addr(uint i) { return (Item **) (values + i); }
  bool check_cols(uint c);
  bool null_inside();
  void bring_value();
1388
  void keep_array() { save_array= 1; }
unknown's avatar
unknown committed
1389 1390
  void cleanup()
  {
unknown's avatar
unknown committed
1391
    DBUG_ENTER("Item_cache_row::cleanup");
unknown's avatar
unknown committed
1392
    Item_cache::cleanup();
1393 1394 1395 1396
    if (save_array)
      bzero(values, item_count*sizeof(Item**));
    else
      values= 0;
unknown's avatar
unknown committed
1397
    DBUG_VOID_RETURN;
unknown's avatar
unknown committed
1398
  }
unknown's avatar
unknown committed
1399 1400
};

1401 1402 1403 1404 1405 1406 1407 1408

/*
  Used to store type. name, length of Item for UNIONS & derived table
*/
class Item_type_holder: public Item
{
protected:
  Item_result item_type;
1409
  Item_result orig_type;
1410 1411 1412 1413 1414 1415 1416 1417 1418
  Field *field_example;
public:
  Item_type_holder(THD*, Item*);

  Item_result result_type () const { return item_type; }
  enum Type type() const { return TYPE_HOLDER; }
  double val();
  longlong val_int();
  String *val_str(String*);
1419
  bool join_types(THD *thd, Item *);
1420
  Field *example() { return field_example; }
1421
  static uint32 real_length(Item *item);
1422 1423
  void cleanup()
  {
unknown's avatar
unknown committed
1424
    DBUG_ENTER("Item_type_holder::cleanup");
1425 1426
    Item::cleanup();
    item_type= orig_type;
unknown's avatar
unknown committed
1427
    DBUG_VOID_RETURN;
1428
  }
1429 1430 1431
};


unknown's avatar
unknown committed
1432 1433 1434 1435
extern Item_buff *new_Item_buff(Item *item);
extern Item_result item_cmp_type(Item_result a,Item_result b);
extern Item *resolve_const_item(Item *item,Item *cmp_item);
extern bool field_is_equal_to_item(Field *field,Item *item);