item.h 57.5 KB
Newer Older
1
/* Copyright (C) 2000-2003 MySQL AB & MySQL Finland AB & TCX DataKonsult AB
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
2

bk@work.mysql.com's avatar
bk@work.mysql.com 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.
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
7

bk@work.mysql.com's avatar
bk@work.mysql.com 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.
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
12

bk@work.mysql.com's avatar
bk@work.mysql.com 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;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
23
struct st_table_list;
24
void item_init(void);			/* Init item functions */
25
class Item_field;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
26

27 28 29

/*
   "Declared Type Collation"
30
   A combination of collation and its derivation.
31 32 33 34
*/

enum Derivation
{
35 36 37
  DERIVATION_IGNORABLE= 5,
  DERIVATION_COERCIBLE= 4,
  DERIVATION_SYSCONST= 3,
38 39 40 41 42
  DERIVATION_IMPLICIT= 2,
  DERIVATION_NONE= 1,
  DERIVATION_EXPLICIT= 0
};

43 44
/*
  Flags for collation aggregation modes:
bar@mysql.com's avatar
bar@mysql.com committed
45 46 47 48
  MY_COLL_ALLOW_SUPERSET_CONV  - allow conversion to a superset
  MY_COLL_ALLOW_COERCIBLE_CONV - allow conversion of a coercible value
                                 (i.e. constant).
  MY_COLL_ALLOW_CONV           - allow any kind of conversion
49
                                 (combination of the above two)
bar@mysql.com's avatar
bar@mysql.com committed
50 51 52 53
  MY_COLL_DISALLOW_NONE        - don't allow return DERIVATION_NONE
                                 (e.g. when aggregating for comparison)
  MY_COLL_CMP_CONV             - combination of MY_COLL_ALLOW_CONV
                                 and MY_COLL_DISALLOW_NONE
54 55 56 57
*/

#define MY_COLL_ALLOW_SUPERSET_CONV   1
#define MY_COLL_ALLOW_COERCIBLE_CONV  2
bar@mysql.com's avatar
bar@mysql.com committed
58 59 60
#define MY_COLL_ALLOW_CONV            3
#define MY_COLL_DISALLOW_NONE         4
#define MY_COLL_CMP_CONV              7
61

62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
class DTCollation {
public:
  CHARSET_INFO     *collation;
  enum Derivation derivation;
  
  DTCollation()
  {
    collation= &my_charset_bin;
    derivation= DERIVATION_NONE;
  }
  DTCollation(CHARSET_INFO *collation_arg, Derivation derivation_arg)
  {
    collation= collation_arg;
    derivation= derivation_arg;
  }
77
  void set(DTCollation &dt)
78
  { 
79 80
    collation= dt.collation;
    derivation= dt.derivation;
81 82 83 84 85 86 87 88 89 90
  }
  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; }
91 92 93
  bool aggregate(DTCollation &dt, uint flags= 0);
  bool set(DTCollation &dt1, DTCollation &dt2, uint flags= 0)
  { set(dt1); return aggregate(dt2, flags); }
94 95 96 97
  const char *derivation_name() const
  {
    switch(derivation)
    {
98
      case DERIVATION_IGNORABLE: return "IGNORABLE";
99 100
      case DERIVATION_COERCIBLE: return "COERCIBLE";
      case DERIVATION_IMPLICIT:  return "IMPLICIT";
101
      case DERIVATION_SYSCONST:  return "SYSCONST";
102 103 104 105 106 107 108
      case DERIVATION_EXPLICIT:  return "EXPLICIT";
      case DERIVATION_NONE:      return "NONE";
      default: return "UNKNOWN";
    }
  }
};

109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 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 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222

/*************************************************************************/
/*
  A framework to easily handle different return types for hybrid items
  (hybrid item is an item whose operand can be of any type, e.g. integer,
  real, decimal).
*/

struct Hybrid_type_traits;

struct Hybrid_type
{
  longlong integer;

  double real;
  /*
    Use two decimal buffers interchangeably to speed up += operation
    which has no native support in decimal library.
    Hybrid_type+= arg is implemented as dec_buf[1]= dec_buf[0] + arg.
    The third decimal is used as a handy temporary storage.
  */
  my_decimal dec_buf[3];
  int used_dec_buf_no;

  /*
    Traits moved to a separate class to
      a) be able to easily change object traits in runtime
      b) they work as a differentiator for the union above
  */
  const Hybrid_type_traits *traits;

  Hybrid_type() {}
  /* XXX: add traits->copy() when needed */
  Hybrid_type(const Hybrid_type &rhs) :traits(rhs.traits) {}
};


/* Hybryd_type_traits interface + default implementation for REAL_RESULT */

struct Hybrid_type_traits
{
  virtual Item_result type() const { return REAL_RESULT; }

  virtual void
  fix_length_and_dec(Item *item, Item *arg) const;

  /* Hybrid_type operations. */
  virtual void set_zero(Hybrid_type *val) const { val->real= 0.0; }
  virtual void add(Hybrid_type *val, Field *f) const
  { val->real+= f->val_real(); }
  virtual void div(Hybrid_type *val, ulonglong u) const
  { val->real/= ulonglong2double(u); }

  virtual longlong val_int(Hybrid_type *val, bool unsigned_flag) const
  { return (longlong) val->real; }
  virtual double val_real(Hybrid_type *val) const { return val->real; }
  virtual my_decimal *val_decimal(Hybrid_type *val, my_decimal *buf) const;
  virtual String *val_str(Hybrid_type *val, String *buf, uint8 decimals) const;
  static const Hybrid_type_traits *instance();
};


struct Hybrid_type_traits_decimal: public Hybrid_type_traits
{
  virtual Item_result type() const { return DECIMAL_RESULT; }

  virtual void
  fix_length_and_dec(Item *arg, Item *item) const;

  /* Hybrid_type operations. */
  virtual void set_zero(Hybrid_type *val) const;
  virtual void add(Hybrid_type *val, Field *f) const;
  virtual void div(Hybrid_type *val, ulonglong u) const;

  virtual longlong val_int(Hybrid_type *val, bool unsigned_flag) const;
  virtual double val_real(Hybrid_type *val) const;
  virtual my_decimal *val_decimal(Hybrid_type *val, my_decimal *buf) const
  { return &val->dec_buf[val->used_dec_buf_no]; }
  virtual String *val_str(Hybrid_type *val, String *buf, uint8 decimals) const;
  static const Hybrid_type_traits_decimal *instance();
};


struct Hybrid_type_traits_integer: public Hybrid_type_traits
{
  virtual Item_result type() const { return INT_RESULT; }

  virtual void
  fix_length_and_dec(Item *arg, Item *item) const;

  /* Hybrid_type operations. */
  virtual void set_zero(Hybrid_type *val) const
  { val->integer= 0; }
  virtual void add(Hybrid_type *val, Field *f) const
  { val->integer+= f->val_int(); }
  virtual void div(Hybrid_type *val, ulonglong u) const
  { val->integer/= (longlong) u; }

  virtual longlong val_int(Hybrid_type *val, bool unsigned_flag) const
  { return val->integer; }
  virtual double val_real(Hybrid_type *val) const
  { return (double) val->integer; }
  virtual my_decimal *val_decimal(Hybrid_type *val, my_decimal *buf) const
  {
    int2my_decimal(E_DEC_FATAL_ERROR, val->integer, 0, &val->dec_buf[2]);
    return &val->dec_buf[2];
  }
  virtual String *val_str(Hybrid_type *val, String *buf, uint8 decimals) const
  { buf->set(val->integer, &my_charset_bin); return buf;}
  static const Hybrid_type_traits_integer *instance();
};

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

bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
223
typedef bool (Item::*Item_processor)(byte *arg);
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
224
typedef Item* (Item::*Item_transformer) (byte *arg);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
225

226
typedef void (*Cond_traverser) (const Item *item, void *arg);
227

bk@work.mysql.com's avatar
bk@work.mysql.com committed
228
class Item {
229
  Item(const Item &);			/* Prevent use of these */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
230 231
  void operator=(Item &);
public:
monty@donna.mysql.com's avatar
monty@donna.mysql.com committed
232
  static void *operator new(size_t size) {return (void*) sql_alloc((uint) size); }
233 234
  static void *operator new(size_t size, MEM_ROOT *mem_root)
  { return (void*) alloc_root(mem_root, (uint) size); }
235
  static void operator delete(void *ptr,size_t size) { TRASH(ptr, size); }
236
  static void operator delete(void *ptr, MEM_ROOT *mem_root) {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
237

238
  enum Type {FIELD_ITEM= 0, FUNC_ITEM, SUM_FUNC_ITEM, STRING_ITEM,
239
	     INT_ITEM, REAL_ITEM, NULL_ITEM, VARBIN_ITEM,
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
240
	     COPY_STR_ITEM, FIELD_AVG_ITEM, DEFAULT_VALUE_ITEM,
241 242
	     PROC_ITEM,COND_ITEM, REF_ITEM, FIELD_STD_ITEM,
	     FIELD_VARIANCE_ITEM, INSERT_VALUE_ITEM,
243
             SUBSELECT_ITEM, ROW_ITEM, CACHE_ITEM, TYPE_HOLDER,
244
             PARAM_ITEM, TRIGGER_FIELD_ITEM, DECIMAL_ITEM};
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
245

bk@work.mysql.com's avatar
bk@work.mysql.com committed
246
  enum cond_result { COND_UNDEF,COND_OK,COND_TRUE,COND_FALSE };
247 248

  enum traverse_order { POSTFIX, PREFIX };
249
  
monty@mysql.com's avatar
monty@mysql.com committed
250 251 252 253 254
  /*
    str_values's main purpose is to be used to cache the value in
    save_in_field
  */
  String str_value;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
255
  my_string name;			/* Name from select */
256 257
  /* Original item name (if it was renamed)*/
  my_string orig_name;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
258 259
  Item *next;
  uint32 max_length;
260
  uint name_length;                     /* Length of name */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
261 262 263
  uint8 marker,decimals;
  my_bool maybe_null;			/* If item may be null */
  my_bool null_value;			/* if item is null */
264
  my_bool unsigned_flag;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
265
  my_bool with_sum_func;
266
  my_bool fixed;                        /* If item fixed with fix_fields */
267
  DTCollation collation;
268

bk@work.mysql.com's avatar
bk@work.mysql.com committed
269 270
  // alloc & destruct is done as start of select using sql_alloc
  Item();
271
  /*
272
     Constructor used by Item_field, Item_ref & aggregate (sum) functions.
273 274
     Used for duplicating lists in processing queries with temporary
     tables
275
     Also it used for Item_cond_and/Item_cond_or for creating
276
     top AND/OR structure of WHERE clause to protect it of
277
     optimisation changes in prepared statements
278
  */
279
  Item(THD *thd, Item *item);
monty@mysql.com's avatar
monty@mysql.com committed
280 281 282 283
  virtual ~Item()
  {
    name=0;
  }		/*lint -e1509 */
bar@bar.mysql.r18.ru's avatar
bar@bar.mysql.r18.ru committed
284
  void set_name(const char *str,uint length, CHARSET_INFO *cs);
285
  void rename(char *new_name);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
286
  void init_make_field(Send_field *tmp_field,enum enum_field_types type);
287
  virtual void cleanup();
288
  virtual void make_field(Send_field *field);
289
  Field *make_string_field(TABLE *table);
290
  virtual bool fix_fields(THD *, struct st_table_list *, Item **);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
291
  /*
monty@mysql.com's avatar
monty@mysql.com committed
292
    should be used in case where we are sure that we do not need
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
293 294 295
    complete fix_fields() procedure.
  */
  inline void quick_fix_field() { fixed= 1; }
monty@mysql.com's avatar
monty@mysql.com committed
296
  /* Function returns 1 on overflow and -1 on fatal errors */
297
  int save_in_field_no_warnings(Field *field, bool no_conversions);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
298
  virtual int save_in_field(Field *field, bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
299
  virtual void save_org_in_field(Field *field)
300
  { (void) save_in_field(field, 1); }
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
301
  virtual int save_safe_in_field(Field *field)
302
  { return save_in_field(field, 1); }
303
  virtual bool send(Protocol *protocol, String *str);
304
  virtual bool eq(const Item *, bool binary_cmp) const;
305 306
  virtual Item_result result_type() const { return REAL_RESULT; }
  virtual Item_result cast_to_int_type() const { return result_type(); }
307
  virtual enum_field_types field_type() const;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
308
  virtual enum Type type() const =0;
309
  /* valXXX methods must return NULL or 0 or 0.0 if null_value is set. */
310 311 312 313 314 315 316 317 318 319
  /*
    Return double precision floating point representation of item.

    SYNOPSIS
      val_real()

    RETURN
      In case of NULL value return 0.0 and set null_value flag to TRUE.
      If value is not null null_value flag will be reset to FALSE.
  */
320
  virtual double val_real()=0;
321 322 323 324 325 326 327 328 329 330
  /*
    Return integer representation of item.

    SYNOPSIS
      val_int()

    RETURN
      In case of NULL value return 0 and set null_value flag to TRUE.
      If value is not null null_value flag will be reset to FALSE.
  */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
331
  virtual longlong val_int()=0;
332 333 334
  /*
    Return string representation of this item object.

335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391
    SYNOPSIS
      val_str()
      str   an allocated buffer this or any nested Item object can use to
            store return value of this method.

    NOTE
      Buffer passed via argument  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 preferable 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 argument, 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.

    RETURN
      In case of NULL value return 0 (NULL pointer) and set null_value flag
      to TRUE.
      If value is not null null_value flag will be reset to FALSE.
  */
  virtual String *val_str(String *str)=0;
  /*
    Return decimal representation of item with fixed point.

    SYNOPSIS
      val_decimal()
      decimal_buffer  buffer which can be used by Item for returning value
                      (but can be not)

    NOTE
      Returned value should not be changed if it is not the same which was
      passed via argument.

    RETURN
      Return pointer on my_decimal (it can be other then passed via argument)
        if value is not NULL (null_value flag will be reset to FALSE).
      In case of NULL value it return 0 pointer and set null_value flag
        to TRUE.
  */
  virtual my_decimal *val_decimal(my_decimal *decimal_buffer)= 0;
  /*
    Return boolean value of item.

    RETURN
      FALSE value is false or NULL
      TRUE value is true (not equal to 0)
392
  */
393
  virtual bool val_bool();
394 395 396 397 398 399 400 401 402 403
  /* Helper functions, see item_sum.cc */
  String *val_string_from_real(String *str);
  String *val_string_from_int(String *str);
  String *val_string_from_decimal(String *str);
  my_decimal *val_decimal_from_real(my_decimal *decimal_value);
  my_decimal *val_decimal_from_int(my_decimal *decimal_value);
  my_decimal *val_decimal_from_string(my_decimal *decimal_value);
  longlong val_int_from_decimal();
  double val_real_from_decimal();

404
  virtual Field *get_tmp_table_field() { return 0; }
405
  virtual Field *tmp_table_field(TABLE *t_arg) { return 0; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
406
  virtual const char *full_name() const { return name ? name : "???"; }
407 408 409 410 411 412 413

  /*
    *result* family of methods is analog of *val* family (see above) but
    return value of result_field of item if it is present. If Item have not
    result field, it return val(). This methods set null_value flag in same
    way as *val* methods do it.
  */
414
  virtual double  val_result() { return val_real(); }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
415 416
  virtual longlong val_int_result() { return val_int(); }
  virtual String *str_result(String* tmp) { return val_str(tmp); }
417 418 419 420
  virtual my_decimal *val_decimal_result(my_decimal *val)
  { return val_decimal(val); }
  virtual bool val_bool_result() { return val_bool(); }

421
  /* bit map of tables used by item */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
422
  virtual table_map used_tables() const { return (table_map) 0L; }
423 424 425 426 427 428 429 430 431 432 433 434 435 436
  /*
    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
437
    a constant expression. Used in the optimizer to propagate basic constants.
438
  */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
439
  virtual bool basic_const_item() const { return 0; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
440 441
  /* cloning of constant items (0 if it is not const) */
  virtual Item *new_item() { return 0; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
442 443 444
  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;}
445 446 447 448
  /* 
    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.
  */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
449
  virtual bool const_item() const { return used_tables() == 0; }
450 451 452 453 454 455
  /* 
    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; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
456
  virtual void print(String *str_arg) { str_arg->append(full_name()); }
457
  void print_item_w_name(String *);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
458
  virtual void update_used_tables() {}
459 460
  virtual void split_sum_func(THD *thd, Item **ref_pointer_array,
                              List<Item> &fields) {}
461 462 463
  /* Called for items that really have to be split */
  void split_sum_func2(THD *thd, Item **ref_pointer_array, List<Item> &fields,
                       Item **ref);
464
  virtual bool get_date(TIME *ltime,uint fuzzydate);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
465
  virtual bool get_time(TIME *ltime);
466
  virtual bool get_date_result(TIME *ltime,uint fuzzydate)
467
  { return get_date(ltime,fuzzydate); }
468 469 470 471 472 473 474 475
  /*
    This function is used only in Item_func_isnull/Item_func_isnotnull
    (implementations of IS NULL/IS NOT NULL clauses). Item_func_is{not}null
    calls this method instead of one of val/result*() methods, which
    normally will set null_value. This allows to determine nullness of
    a complex expression without fully evaluating it.
    Any new item which can be NULL must implement this call.
  */
476
  virtual bool is_null() { return 0; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
477 478 479 480
  /*
    it is "top level" item of WHERE clause and we do not need correct NULL
    handling
  */
481
  virtual void top_level_item() {}
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
482 483
  /*
    set field of temporary table for Item which can be switched on temporary
484
    table during query processing (grouping and so on)
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
485
  */
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
486 487
  virtual void set_result_field(Field *field) {}
  virtual bool is_result_field() { return 0; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
488
  virtual bool is_bool_func() { return 0; }
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
489
  virtual void save_in_result_field(bool no_conversions) {}
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
490
  /*
491
    set value of aggregate function in case of no rows for grouping were found
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
492
  */
493
  virtual void no_rows_in_result() {}
494
  virtual Item *copy_or_same(THD *thd) { return this; }
495
  virtual Item *copy_andor_structure(THD *thd) { return this; }
496
  virtual Item *real_item() { return this; }
497
  virtual Item *get_tmp_table_item(THD *thd) { return copy_or_same(thd); }
498

499
  static CHARSET_INFO *default_charset();
500
  virtual CHARSET_INFO *compare_collation() { return NULL; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
501 502 503 504 505 506

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

507
  virtual Item* transform(Item_transformer transformer, byte *arg)
508
  {
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
509
    return (this->*transformer)(arg);
510
  }
511

512 513
   virtual void traverse_cond(Cond_traverser traverser,
                              void *arg, traverse_order order)
514 515 516
   {
     (*traverser)(this, arg);
   }
517

bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
518
  virtual bool remove_dependence_processor(byte * arg) { return 0; }
519
  virtual bool remove_fixed(byte * arg) { fixed= 0; return 0; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
520
  virtual bool cleanup_processor(byte *arg);
521
  virtual bool collect_item_field_processor(byte * arg) { return 0; }
522
  virtual Item *equal_fields_propagator(byte * arg) { return this; }
monty@mysql.com's avatar
monty@mysql.com committed
523
  virtual Item *set_no_const_sub(byte *arg) { return this; }
524
  virtual Item *replace_equal_field(byte * arg) { return this; }
525
  
526 527
  virtual Item *this_item() { return this; } /* For SPs mostly. */
  virtual Item *this_const_item() const { return const_cast<Item*>(this); } /* For SPs mostly. */
528 529 530 531

  // Row emulation
  virtual uint cols() { return 1; }
  virtual Item* el(uint i) { return this; }
532
  virtual Item** addr(uint i) { return 0; }
533
  virtual bool check_cols(uint c);
534
  // It is not row => null inside is impossible
535 536 537
  virtual bool null_inside() { return 0; }
  // used in row subselects to get value of elements
  virtual void bring_value() {}
538 539

  Field *tmp_table_field_from_field_type(TABLE *table);
540
  virtual Item_field *filed_for_view_update() { return 0; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
541

542
  virtual Item *neg_transformer(THD *thd) { return NULL; }
bar@mysql.com's avatar
bar@mysql.com committed
543
  virtual Item *safe_charset_converter(CHARSET_INFO *tocs);
544 545 546 547
  void delete_self()
  {
    cleanup();
    delete this;
pem@mysql.comhem.se's avatar
pem@mysql.comhem.se committed
548
  }
549 550

  virtual bool is_splocal() { return 0; } /* Needed for error checking */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
551 552 553
};


554 555 556 557 558 559
// A local SP variable (incl. parameters), used in runtime
class Item_splocal : public Item
{
private:
  
  uint m_offset;
560
  LEX_STRING m_name;
561 562 563

public:

564 565
  Item_splocal(LEX_STRING name, uint offset)
    : m_offset(offset), m_name(name)
566 567 568
  {
    Item::maybe_null= TRUE;
  }
569

570 571
  bool is_splocal() { return 1; } /* Needed for error checking */

572 573 574
  Item *this_item();
  Item *this_const_item() const;

575 576 577
  bool fix_fields(THD *, struct st_table_list *, Item **);
  void cleanup();

578 579 580 581 582 583 584
  inline uint get_offset()
  {
    return m_offset;
  }

  // Abstract methods inherited from Item. Just defer the call to
  // the item in the frame
585
  enum Type type() const;
586

587 588 589 590
  double val_real();
  longlong val_int();
  String *val_str(String *sp);
  my_decimal *val_decimal(my_decimal *);
591
  bool is_null();
592
  void print(String *str);
593 594 595

  inline void make_field(Send_field *field)
  {
596 597
    Item *it= this_item();

598 599 600 601
    if (name)
      it->set_name(name, strlen(name), system_charset_info);
    else
      it->set_name(m_name.str, m_name.length, system_charset_info);
602
    it->make_field(field);
603 604
  }

605 606 607 608 609 610 611
  inline Item_result result_type() const
  {
    return this_const_item()->result_type();
  }

  inline bool const_item() const
  {
612
    return TRUE;
613 614
  }

615 616 617 618
  inline int save_in_field(Field *field, bool no_conversions)
  {
    return this_item()->save_in_field(field, no_conversions);
  }
619

620 621 622 623
  inline bool send(Protocol *protocol, String *str)
  {
    return this_item()->send(protocol, str);
  }
624 625 626
};


627 628 629
class Item_num: public Item
{
public:
monty@mysql.com's avatar
monty@mysql.com committed
630
  virtual Item_num *neg()= 0;
631 632
};

633
#define NO_CACHED_FIELD_INDEX ((uint)(-1))
634

635
class st_select_lex;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
636 637
class Item_ident :public Item
{
638
protected:
639 640 641 642 643 644 645 646 647
  /* 
    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;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
648 649 650 651
public:
  const char *db_name;
  const char *table_name;
  const char *field_name;
652
  bool alias_name_used; /* true if item was resolved against alias */
653 654
  /* 
    Cached value of index for this field in table->field array, used by prep. 
655 656 657 658 659 660 661 662
    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.
663
  */
664
  TABLE_LIST *cached_table;
665
  st_select_lex *depended_from;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
666
  Item_ident(const char *db_name_par,const char *table_name_par,
667
	     const char *field_name_par);
pem@mysql.com's avatar
pem@mysql.com committed
668
  Item_ident(THD *thd, Item_ident *item);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
669
  const char *full_name() const;
670
  void cleanup();
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
671
  bool remove_dependence_processor(byte * arg);
672
  void print(String *str);
bell@sanja.is.com.ua's avatar
VIEW  
bell@sanja.is.com.ua committed
673 674 675

  friend bool insert_fields(THD *thd,TABLE_LIST *tables, const char *db_name,
                            const char *table_name, List_iterator<Item> *it,
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
676
                            bool any_privileges, bool allocate_view_names);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
677 678
};

679 680
class Item_equal;
class COND_EQUAL;
681

bk@work.mysql.com's avatar
bk@work.mysql.com committed
682 683
class Item_field :public Item_ident
{
684
protected:
bk@work.mysql.com's avatar
bk@work.mysql.com committed
685 686 687
  void set_field(Field *field);
public:
  Field *field,*result_field;
688 689
  Item_equal *item_equal;
  bool no_const_subst;
bell@sanja.is.com.ua's avatar
VIEW  
bell@sanja.is.com.ua committed
690 691 692 693 694 695 696
  /*
    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;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
697 698 699

  Item_field(const char *db_par,const char *table_name_par,
	     const char *field_name_par)
700
    :Item_ident(db_par,table_name_par,field_name_par),
701
    field(0), result_field(0), item_equal(0), no_const_subst(0),
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
702
     have_privileges(0), any_privileges(0)
703
  { collation.set(DERIVATION_IMPLICIT); }
704 705 706
  /*
    Constructor needed to process subselect with temporary tables (see Item)
  */
707
  Item_field(THD *thd, Item_field *item);
708
  /*
709 710 711
    Constructor used inside setup_wild(), ensures that field, table,
    and database names will live as long as Item_field (this is important
    in prepared statements).
712 713
  */
  Item_field(THD *thd, Field *field);
714 715 716
  /*
    If this constructor is used, fix_fields() won't work, because
    db_name, table_name and column_name are unknown. It's necessary to call
717
    reset_field() before fix_fields() for all fields created this way.
718
  */
bk@work.mysql.com's avatar
bk@work.mysql.com committed
719 720
  Item_field(Field *field);
  enum Type type() const { return FIELD_ITEM; }
721
  bool eq(const Item *item, bool binary_cmp) const;
722
  double val_real();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
723
  longlong val_int();
724
  my_decimal *val_decimal(my_decimal *);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
725 726 727 728
  String *val_str(String*);
  double val_result();
  longlong val_int_result();
  String *str_result(String* tmp);
729 730
  my_decimal *val_decimal_result(my_decimal *);
  bool val_bool_result();
731
  bool send(Protocol *protocol, String *str_arg);
732
  void reset_field(Field *f);
733
  bool fix_fields(THD *, struct st_table_list *, Item **);
734
  void make_field(Send_field *tmp_field);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
735
  int save_in_field(Field *field,bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
736 737 738 739 740 741
  void save_org_in_field(Field *field);
  table_map used_tables() const;
  enum Item_result result_type () const
  {
    return field->result_type();
  }
742 743 744 745
  Item_result cast_to_int_type() const
  {
    return field->cast_to_int_type();
  }
746
  enum_field_types field_type() const
747 748 749
  {
    return field->type();
  }
750
  Field *get_tmp_table_field() { return result_field; }
751
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
752 753
  bool get_date(TIME *ltime,uint fuzzydate);
  bool get_date_result(TIME *ltime,uint fuzzydate);
754
  bool get_time(TIME *ltime);
755
  bool is_null() { return field->is_null(); }
756
  Item *get_tmp_table_item(THD *thd);
757
  bool collect_item_field_processor(byte * arg);
hf@deer.(none)'s avatar
hf@deer.(none) committed
758
  void cleanup();
759 760
  Item_equal *find_item_equal(COND_EQUAL *cond_equal);
  Item *equal_fields_propagator(byte *arg);
monty@mysql.com's avatar
monty@mysql.com committed
761
  Item *set_no_const_sub(byte *arg);
762
  Item *replace_equal_field(byte *arg);
763
  inline uint32 max_disp_length() { return field->max_length(); }
764
  Item_field *filed_for_view_update() { return this; }
monty@mysql.com's avatar
monty@mysql.com committed
765
  Item *safe_charset_converter(CHARSET_INFO *tocs);
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
766
  friend class Item_default_value;
767
  friend class Item_insert_value;
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
768
  friend class st_select_lex_unit;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
769 770 771 772 773 774
};

class Item_null :public Item
{
public:
  Item_null(char *name_par=0)
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
775 776 777 778 779
  {
    maybe_null= null_value= TRUE;
    max_length= 0;
    name= name_par ? name_par : (char*) "NULL";
    fixed= 1;
780
    collation.set(&my_charset_bin, DERIVATION_IGNORABLE);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
781
  }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
782
  enum Type type() const { return NULL_ITEM; }
783
  bool eq(const Item *item, bool binary_cmp) const;
784
  double val_real();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
785 786
  longlong val_int();
  String *val_str(String *str);
787
  my_decimal *val_decimal(my_decimal *);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
788
  int save_in_field(Field *field, bool no_conversions);
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
789
  int save_safe_in_field(Field *field);
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
790
  bool send(Protocol *protocol, String *str);
791 792
  enum Item_result result_type () const { return STRING_RESULT; }
  enum_field_types field_type() const   { return MYSQL_TYPE_NULL; }
793
  /* to prevent drop fixed flag (no need parent cleanup call) */
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
794
  void cleanup() {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
795 796
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_null(name); }
797
  bool is_null() { return 1; }
798
  void print(String *str) { str->append("NULL", 4); }
bar@mysql.com's avatar
bar@mysql.com committed
799
  Item *safe_charset_converter(CHARSET_INFO *tocs);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
800 801
};

802 803 804 805 806 807 808 809 810 811 812
class Item_null_result :public Item_null
{
public:
  Field *result_field;
  Item_null_result() : Item_null(), result_field(0) {}
  bool is_result_field() { return result_field != 0; }
  void save_in_result_field(bool no_conversions)
  {
    save_in_field(result_field, no_conversions);
  }
};  
813 814 815

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

816 817
class Item_param :public Item
{
818
public:
819 820 821
  enum enum_item_param_state
  {
    NO_VALUE, NULL_VALUE, INT_VALUE, REAL_VALUE,
822 823
    STRING_VALUE, TIME_VALUE, LONG_DATA_VALUE,
    DECIMAL_VALUE
824 825
  } state;

826 827 828 829 830 831 832 833 834 835 836
  /*
    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;
837
  my_decimal decimal_value;
838 839
  union
  {
840 841
    longlong integer;
    double   real;
842 843 844 845 846 847 848 849 850 851 852 853
    /*
      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).
854
        Otherwise it's equal to character_set_client (to simplify
855 856 857 858 859 860 861 862
        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.  */
863 864
  enum Item_result item_result_type;
  enum Type item_type;
865 866 867 868 869 870 871 872 873 874

  /*
    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;
875
  /*
876 877
    Offset of placeholder inside statement text. Used to create
    no-placeholders version of this statement for the binary log.
878
  */
879
  uint pos_in_query;
880

881 882 883
  Item_param(uint pos_in_query_arg);

  enum Item_result result_type () const { return item_result_type; }
884
  enum Type type() const { return item_type; }
885
  enum_field_types field_type() const { return param_type; }
886

887
  double val_real();
888
  longlong val_int();
889
  my_decimal *val_decimal(my_decimal*);
890
  String *val_str(String*);
891
  bool get_time(TIME *tm);
892
  bool get_date(TIME *tm, uint fuzzydate);
venu@myvenu.com's avatar
venu@myvenu.com committed
893
  int  save_in_field(Field *field, bool no_conversions);
894
  bool fix_fields(THD *, struct st_table_list *, Item **);
895

896
  void set_null();
897
  void set_int(longlong i, uint32 max_length_arg);
898
  void set_double(double i);
899
  void set_decimal(const char *str, ulong length);
900 901 902
  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);
903
  bool set_from_user_var(THD *thd, const user_var_entry *entry);
904
  void reset();
905 906 907 908 909 910 911 912
  /*
    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);

913 914 915
  const String *query_val_str(String *str) const;

  bool convert_str_value(THD *thd);
916 917 918 919

  /*
    If value for parameter was not set we treat it as non-const
    so noone will use parameters value in fix_fields still
920 921 922
    parameter is constant during execution.
  */
  virtual table_map used_tables() const
923
  { return state != NO_VALUE ? (table_map)0 : PARAM_TABLE_BIT; }
924
  void print(String *str);
925 926
  bool is_null()
  { DBUG_ASSERT(state != NO_VALUE); return state == NULL_VALUE; }
927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944
  bool basic_const_item() const;
  /*
    This method is used to make a copy of a basic constant item when
    propagating constants in the optimizer. The reason to create a new
    item and not use the existing one is not precisely known (2005/04/16).
    Probably we are trying to preserve tree structure of items, in other
    words, avoid pointing at one item from two different nodes of the tree.
    Return a new basic constant item if parameter value is a basic
    constant, assert otherwise. This method is called only if
    basic_const_item returned TRUE.
  */
  Item *new_item();
  /*
    Implement by-value equality evaluation if parameter value
    is set and is a basic constant (integer, real or string).
    Otherwise return FALSE.
  */
  bool eq(const Item *item, bool binary_cmp) const;
945
};
bk@work.mysql.com's avatar
bk@work.mysql.com committed
946

947

948
class Item_int :public Item_num
bk@work.mysql.com's avatar
bk@work.mysql.com committed
949 950
{
public:
951
  longlong value;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
952
  Item_int(int32 i,uint length=11) :value((longlong) i)
953
    { max_length=length; fixed= 1; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
954 955
#ifdef HAVE_LONG_LONG
  Item_int(longlong i,uint length=21) :value(i)
956
    { max_length=length; fixed= 1;}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
957 958
#endif
  Item_int(const char *str_arg,longlong i,uint length) :value(i)
959
    { max_length=length; name=(char*) str_arg; fixed= 1; }
monty@mysql.com's avatar
monty@mysql.com committed
960
  Item_int(const char *str_arg, uint length=64);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
961
  enum Type type() const { return INT_ITEM; }
962 963
  enum Item_result result_type () const { return INT_RESULT; }
  enum_field_types field_type() const { return MYSQL_TYPE_LONGLONG; }
964
  longlong val_int() { DBUG_ASSERT(fixed == 1); return value; }
965
  double val_real() { DBUG_ASSERT(fixed == 1); return (double) value; }
966
  my_decimal *val_decimal(my_decimal *);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
967
  String *val_str(String*);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
968
  int save_in_field(Field *field, bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
969 970
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_int(name,value,max_length); }
971
  // to prevent drop fixed flag (no need parent cleanup call)
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
972
  void cleanup() {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
973
  void print(String *str);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
974
  Item_num *neg() { value= -value; return this; }
975
  bool eq(const Item *, bool binary_cmp) const;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
976 977 978
};


979 980 981 982 983 984 985 986 987 988 989
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); }
};


990 991 992
class Item_uint :public Item_int
{
public:
monty@mysql.com's avatar
monty@mysql.com committed
993
  Item_uint(const char *str_arg, uint length);
994
  Item_uint(uint32 i) :Item_int((longlong) i, 10) 
ram@gw.mysql.r18.ru's avatar
ram@gw.mysql.r18.ru committed
995
    { unsigned_flag= 1; }
996
  double val_real()
997
    { DBUG_ASSERT(fixed == 1); return ulonglong2double((ulonglong)value); }
998 999
  String *val_str(String*);
  Item *new_item() { return new Item_uint(name,max_length); }
monty@mysql.com's avatar
monty@mysql.com committed
1000
  int save_in_field(Field *field, bool no_conversions);
1001
  void print(String *str);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1002
  Item_num *neg ();
1003 1004 1005
};


1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044
/* decimal (fixed point) constant */
class Item_decimal :public Item_num
{
protected:
  my_decimal decimal_value;
public:
  Item_decimal(const char *str_arg, uint length, CHARSET_INFO *charset);
  Item_decimal(const char *str, const my_decimal *val_arg,
               uint decimal_par, uint length);
  Item_decimal(my_decimal *value_par);
  Item_decimal(longlong val, bool unsig);
  Item_decimal(double val, int precision, int scale);
  Item_decimal(const char *bin, int precision, int scale);

  enum Type type() const { return DECIMAL_ITEM; }
  enum Item_result result_type () const { return DECIMAL_RESULT; }
  enum_field_types field_type() const { return MYSQL_TYPE_NEWDECIMAL; }
  longlong val_int();
  double val_real();
  String *val_str(String*);
  my_decimal *val_decimal(my_decimal *val) { return &decimal_value; }
  int save_in_field(Field *field, bool no_conversions);
  bool basic_const_item() const { return 1; }
  Item *new_item()
  {
    return new Item_decimal(name, &decimal_value, decimals, max_length);
  }
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
  void print(String *str);
  Item_num *neg()
  {
    my_decimal_neg(&decimal_value);
    unsigned_flag= !decimal_value.sign();
    return this;
  }
};

class Item_float :public Item_num
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1045
{
1046
  char *presentation;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1047
public:
1048
  double value;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1049
  // Item_real() :value(0) {}
1050 1051
  Item_float(const char *str_arg, uint length);
  Item_float(const char *str,double val_arg,uint decimal_par,uint length)
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1052 1053
    :value(val_arg)
  {
1054
    presentation= name=(char*) str;
1055
    decimals=(uint8) decimal_par;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1056
    max_length=length;
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1057
    fixed= 1;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1058
  }
1059 1060
  Item_float(double value_par) :presentation(0), value(value_par) { fixed= 1; }

monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1061
  int save_in_field(Field *field, bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1062
  enum Type type() const { return REAL_ITEM; }
1063
  enum_field_types field_type() const { return MYSQL_TYPE_DOUBLE; }
1064
  double val_real() { DBUG_ASSERT(fixed == 1); return value; }
1065 1066 1067 1068 1069
  longlong val_int()
  {
    DBUG_ASSERT(fixed == 1);
    return (longlong) (value+(value > 0 ? 0.5 : -0.5));
  }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1070
  String *val_str(String*);
1071
  my_decimal *val_decimal(my_decimal *);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1072
  bool basic_const_item() const { return 1; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1073 1074
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
1075 1076
  Item *new_item()
  { return new Item_float(name, value, decimals, max_length); }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1077
  Item_num *neg() { value= -value; return this; }
1078
  void print(String *str);
1079
  bool eq(const Item *, bool binary_cmp) const;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1080 1081 1082
};


1083
class Item_static_float_func :public Item_float
1084 1085 1086
{
  const char *func_name;
public:
1087
  Item_static_float_func(const char *str, double val_arg, uint decimal_par,
1088
                        uint length)
1089
    :Item_float(NullS, val_arg, decimal_par, length), func_name(str)
1090 1091 1092 1093 1094
  {}
  void print(String *str) { str->append(func_name); }
};


bk@work.mysql.com's avatar
bk@work.mysql.com committed
1095 1096 1097
class Item_string :public Item
{
public:
bar@bar.mysql.r18.ru's avatar
bar@bar.mysql.r18.ru committed
1098
  Item_string(const char *str,uint length,
1099
  	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1100
  {
1101
    collation.set(cs, dv);
1102
    str_value.set_or_copy_aligned(str,length,cs);
1103 1104 1105 1106 1107 1108 1109
    /*
      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).
    */
1110
    max_length= str_value.numchars()*cs->mbmaxlen;
bar@bar.mysql.r18.ru's avatar
bar@bar.mysql.r18.ru committed
1111
    set_name(str, length, cs);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1112
    decimals=NOT_FIXED_DEC;
1113 1114
    // it is constant => can be used without fix_fields (and frequently used)
    fixed= 1;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1115
  }
1116
  Item_string(const char *name_par, const char *str, uint length,
1117
	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1118
  {
1119
    collation.set(cs, dv);
1120
    str_value.set_or_copy_aligned(str,length,cs);
1121
    max_length= str_value.numchars()*cs->mbmaxlen;
bar@bar.mysql.r18.ru's avatar
bar@bar.mysql.r18.ru committed
1122
    set_name(name_par,0,cs);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1123
    decimals=NOT_FIXED_DEC;
1124 1125
    // it is constant => can be used without fix_fields (and frequently used)
    fixed= 1;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1126 1127
  }
  enum Type type() const { return STRING_ITEM; }
1128 1129
  double val_real();
  longlong val_int();
1130 1131 1132 1133 1134
  String *val_str(String*)
  {
    DBUG_ASSERT(fixed == 1);
    return (String*) &str_value;
  }
1135
  my_decimal *val_decimal(my_decimal *);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1136
  int save_in_field(Field *field, bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1137
  enum Item_result result_type () const { return STRING_RESULT; }
1138
  enum_field_types field_type() const { return MYSQL_TYPE_VARCHAR; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1139
  bool basic_const_item() const { return 1; }
1140
  bool eq(const Item *item, bool binary_cmp) const;
1141 1142
  Item *new_item() 
  {
1143
    return new Item_string(name, str_value.ptr(), 
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
1144
    			   str_value.length(), collation.collation);
1145
  }
bar@mysql.com's avatar
bar@mysql.com committed
1146
  Item *safe_charset_converter(CHARSET_INFO *tocs);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1147
  String *const_string() { return &str_value; }
1148
  inline void append(char *str, uint length) { str_value.append(str, length); }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1149
  void print(String *str);
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1150 1151
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1152 1153
};

1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167

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); }
};


bk@work.mysql.com's avatar
bk@work.mysql.com committed
1168 1169 1170 1171 1172
/* for show tables */

class Item_datetime :public Item_string
{
public:
bar@bar.mysql.r18.ru's avatar
bar@bar.mysql.r18.ru committed
1173
  Item_datetime(const char *item_name): Item_string(item_name,"",0,
1174
                                                    &my_charset_bin)
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1175
  { max_length=19;}
1176
  enum_field_types field_type() const { return MYSQL_TYPE_DATETIME; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1177 1178 1179 1180 1181
};

class Item_empty_string :public Item_string
{
public:
1182 1183
  Item_empty_string(const char *header,uint length, CHARSET_INFO *cs= NULL) :
    Item_string("",0, cs ? cs : &my_charset_bin)
1184
    { name=(char*) header; max_length= cs ? length * cs->mbmaxlen : length; }
1185
  void make_field(Send_field *field);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1186 1187
};

1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201
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; }
};


ram@gw.mysql.r18.ru's avatar
ram@gw.mysql.r18.ru committed
1202
class Item_hex_string: public Item
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1203 1204
{
public:
ram@gw.mysql.r18.ru's avatar
ram@gw.mysql.r18.ru committed
1205 1206
  Item_hex_string(): Item() {}
  Item_hex_string(const char *str,uint str_length);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1207
  enum Type type() const { return VARBIN_ITEM; }
1208
  double val_real()
ram@gw.mysql.r18.ru's avatar
ram@gw.mysql.r18.ru committed
1209
    { DBUG_ASSERT(fixed == 1); return (double) Item_hex_string::val_int(); }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1210
  longlong val_int();
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1211
  bool basic_const_item() const { return 1; }
1212
  String *val_str(String*) { DBUG_ASSERT(fixed == 1); return &str_value; }
1213
  my_decimal *val_decimal(my_decimal *);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1214
  int save_in_field(Field *field, bool no_conversions);
1215
  enum Item_result result_type () const { return STRING_RESULT; }
1216
  enum_field_types field_type() const { return MYSQL_TYPE_VARCHAR; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1217 1218
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() {}
1219
  bool eq(const Item *item, bool binary_cmp) const;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1220 1221 1222
};


ram@gw.mysql.r18.ru's avatar
ram@gw.mysql.r18.ru committed
1223 1224 1225 1226 1227 1228
class Item_bin_string: public Item_hex_string
{
public:
  Item_bin_string(const char *str,uint str_length);
};

bk@work.mysql.com's avatar
bk@work.mysql.com committed
1229 1230 1231 1232 1233
class Item_result_field :public Item	/* Item with result field */
{
public:
  Field *result_field;				/* Save result here */
  Item_result_field() :result_field(0) {}
1234
  // Constructor used for Item_sum/Item_cond_and/or (see Item comment)
1235 1236
  Item_result_field(THD *thd, Item_result_field *item):
    Item(thd, item), result_field(item->result_field)
1237
  {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1238
  ~Item_result_field() {}			/* Required with gcc 2.95 */
1239
  Field *get_tmp_table_field() { return result_field; }
1240
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
monty@hundin.mysql.fi's avatar
monty@hundin.mysql.fi committed
1241
  table_map used_tables() const { return 1; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1242
  virtual void fix_length_and_dec()=0;
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1243 1244 1245 1246 1247 1248
  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);
  }
1249
  void cleanup();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1250 1251 1252 1253 1254
};


class Item_ref :public Item_ident
{
1255 1256
protected:
  void set_properties();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1257
public:
hf@deer.(none)'s avatar
hf@deer.(none) committed
1258
  Field *result_field;			 /* Save result here */
serg@serg.mysql.com's avatar
serg@serg.mysql.com committed
1259
  Item **ref;
1260 1261
  Item_ref(const char *db_par, const char *table_name_par,
           const char *field_name_par)
monty@mysql.com's avatar
monty@mysql.com committed
1262
    :Item_ident(db_par, table_name_par, field_name_par), result_field(0), ref(0) {}
1263
  /*
1264 1265 1266 1267 1268 1269 1270 1271 1272 1273
    This constructor is used in two scenarios:
    A) *item = NULL
      No initialization is performed, fix_fields() call will be necessary.
      
    B) *item points to an Item this Item_ref will refer to. This is 
      used for GROUP BY. fix_fields() will not be called in this case,
      so we call set_properties to make this item "fixed". set_properties
      performs a subset of action Item_ref::fix_fields does, and this subset
      is enough for Item_ref's used in GROUP BY.
    
1274 1275 1276
    TODO we probably fix a superset of problems like in BUG#6658. Check this 
         with Bar, and if we have a more broader set of problems like this.
  */
1277
  Item_ref(Item **item, const char *table_name_par, const char *field_name_par);
1278

1279
  /* Constructor need to process subselect with temporary tables (see Item) */
monty@mysql.com's avatar
monty@mysql.com committed
1280
  Item_ref(THD *thd, Item_ref *item) :Item_ident(thd, item), result_field(item->result_field), ref(item->ref) {}
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1281
  enum Type type() const		{ return REF_ITEM; }
1282
  bool eq(const Item *item, bool binary_cmp) const
1283
  { return ref && (*ref)->eq(item, binary_cmp); }
1284 1285 1286 1287 1288 1289 1290
  double val_real();
  longlong val_int();
  my_decimal *val_decimal(my_decimal *);
  bool val_bool();
  String *val_str(String* tmp);
  bool is_null();
  bool get_date(TIME *ltime,uint fuzzydate);
1291 1292 1293
  double val_result();
  longlong val_int_result();
  String *str_result(String* tmp);
1294 1295
  my_decimal *val_decimal_result(my_decimal *);
  bool val_bool_result();
1296
  bool send(Protocol *prot, String *tmp);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1297
  void make_field(Send_field *field)	{ (*ref)->make_field(field); }
1298
  bool fix_fields(THD *, struct st_table_list *, Item **);
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1299
  int save_in_field(Field *field, bool no_conversions)
1300
  { return (*ref)->save_in_field(field, no_conversions); }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1301 1302
  void save_org_in_field(Field *field)	{ (*ref)->save_org_in_field(field); }
  enum Item_result result_type () const { return (*ref)->result_type(); }
1303
  enum_field_types field_type() const   { return (*ref)->field_type(); }
1304
  Field *get_tmp_table_field() { return result_field; }
1305 1306 1307 1308
  table_map used_tables() const		
  { 
    return depended_from ? OUTER_REF_TABLE_BIT : (*ref)->used_tables(); 
  }
1309
  void set_result_field(Field *field)	{ result_field= field; }
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1310 1311 1312 1313 1314
  bool is_result_field() { return 1; }
  void save_in_result_field(bool no_conversions)
  {
    (*ref)->save_in_field(result_field, no_conversions);
  }
1315
  Item *real_item() { return *ref; }
1316 1317
  bool walk(Item_processor processor, byte *arg)
  { return (*ref)->walk(processor, arg); }
1318
  void print(String *str);
monty@mysql.com's avatar
monty@mysql.com committed
1319
  void cleanup();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1320 1321
};

1322

1323 1324 1325 1326
/*
  The same as Item_ref, but get value from val_* family of method to get
  value of item on which it referred instead of result* family.
*/
1327 1328 1329 1330 1331 1332 1333 1334
class Item_direct_ref :public Item_ref
{
public:
  Item_direct_ref(Item **item, const char *table_name_par,
                  const char *field_name_par)
    :Item_ref(item, table_name_par, field_name_par) {}
  /* Constructor need to process subselect with temporary tables (see Item) */
  Item_direct_ref(THD *thd, Item_direct_ref *item) : Item_ref(thd, item) {}
1335

1336 1337 1338 1339 1340 1341 1342
  double val_real();
  longlong val_int();
  String *val_str(String* tmp);
  my_decimal *val_decimal(my_decimal *);
  bool val_bool();
  bool is_null();
  bool get_date(TIME *ltime,uint fuzzydate);
1343 1344 1345
};


1346
class Item_in_subselect;
1347

1348 1349 1350 1351 1352 1353
class Item_ref_null_helper: public Item_ref
{
protected:
  Item_in_subselect* owner;
public:
  Item_ref_null_helper(Item_in_subselect* master, Item **item,
1354
		       const char *table_name_par, const char *field_name_par):
1355
    Item_ref(item, table_name_par, field_name_par), owner(master) {}
1356
  double val_real();
1357 1358
  longlong val_int();
  String* val_str(String* s);
1359 1360
  my_decimal *val_decimal(my_decimal *);
  bool val_bool();
1361
  bool get_date(TIME *ltime, uint fuzzydate);
1362
  void print(String *str);
1363 1364
};

1365 1366 1367 1368 1369 1370
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)
1371 1372
    :Item_ref_null_helper(master, (store= 0, &store), table_name_par,
                          field_name_par),
1373
     store(item)
1374
    { ref= &store; }
1375
  void print(String *str);
1376
};
1377

1378
/*
1379
  The following class is used to optimize comparing of date and bigint columns
1380 1381
  We need to save the original item, to be able to set the field to the
  original value in 'opt_range'.
sergefp@mysql.com's avatar
sergefp@mysql.com committed
1382 1383
  An instance of Item_int_with_ref may refer to a signed or an unsigned
  integer.
1384 1385 1386 1387 1388 1389 1390
*/

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)
1391 1392 1393
  {
    unsigned_flag= ref_arg->unsigned_flag;
  }
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1394
  int save_in_field(Field *field, bool no_conversions)
1395
  {
1396
    return ref->save_in_field(field, no_conversions);
1397
  }
1398 1399 1400 1401 1402
  Item *new_item()
  {
    return (ref->unsigned_flag)? new Item_uint(ref->name, ref->max_length) :
                                 new Item_int(ref->name, ref->max_length);
  }
1403 1404 1405
};


1406
#include "gstream.h"
1407
#include "spatial.h"
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1408 1409
#include "item_sum.h"
#include "item_func.h"
1410
#include "item_row.h"
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1411 1412
#include "item_cmpfunc.h"
#include "item_strfunc.h"
1413
#include "item_geofunc.h"
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1414 1415
#include "item_timefunc.h"
#include "item_uniq.h"
1416
#include "item_subselect.h"
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1417 1418 1419

class Item_copy_string :public Item
{
1420
  enum enum_field_types cached_field_type;
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1421 1422 1423 1424 1425 1426 1427 1428
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;
1429
    cached_field_type= item->field_type();
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1430 1431 1432
  }
  enum Type type() const { return COPY_STR_ITEM; }
  enum Item_result result_type () const { return STRING_RESULT; }
1433
  enum_field_types field_type() const { return cached_field_type; }
1434
  double val_real()
1435
  {
monty@mysql.com's avatar
monty@mysql.com committed
1436 1437
    int err_not_used;
    char *end_not_used;
1438 1439
    return (null_value ? 0.0 :
	    my_strntod(str_value.charset(), (char*) str_value.ptr(),
monty@mysql.com's avatar
monty@mysql.com committed
1440
		       str_value.length(), &end_not_used, &err_not_used));
1441
  }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1442
  longlong val_int()
1443 1444 1445 1446
  { 
    int err;
    return null_value ? LL(0) : my_strntoll(str_value.charset(),str_value.ptr(),str_value.length(),10, (char**) 0,&err); 
  }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1447
  String *val_str(String*);
1448
  my_decimal *val_decimal(my_decimal *);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1449 1450
  void make_field(Send_field *field) { item->make_field(field); }
  void copy();
monty@mysql.com's avatar
monty@mysql.com committed
1451
  int save_in_field(Field *field, bool no_conversions);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1452 1453
  table_map used_tables() const { return (table_map) 1L; }
  bool const_item() const { return 0; }
1454
  bool is_null() { return null_value; }
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496
};


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);
};


1497 1498 1499 1500 1501 1502 1503 1504 1505
class Item_decimal_buff :public Item_buff
{
  Item *item;
  my_decimal value;
public:
  Item_decimal_buff(Item *item_par);
  bool cmp(void);
};

bk@work.mysql.com's avatar
bk@work.mysql.com committed
1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520
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);
};

hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1521 1522 1523 1524
class Item_default_value : public Item_field
{
public:
  Item *arg;
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1525 1526
  Item_default_value() :
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(NULL) {}
1527
  Item_default_value(Item *a) :
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1528
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(a) {}
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1529
  enum Type type() const { return DEFAULT_VALUE_ITEM; }
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1530 1531
  bool eq(const Item *item, bool binary_cmp) const;
  bool fix_fields(THD *, struct st_table_list *, Item **);
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1532
  void print(String *str);
1533
  int save_in_field(Field *field_arg, bool no_conversions);
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
1534
  table_map used_tables() const { return (table_map)0L; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1535 1536 1537 1538 1539 1540
  
  bool walk(Item_processor processor, byte *args)
  {
    return arg->walk(processor, args) ||
      (this->*processor)(args);
  }
1541

igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
1542 1543 1544 1545 1546
  /* 
     This method like the walk method traverses the item tree, but
     at the same time it can replace some nodes in the tree
  */ 
  Item *transform(Item_transformer transformer, byte *args)
1547
  {
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
1548
    Item *new_item= arg->transform(transformer, args);
1549 1550 1551
    if (!new_item)
      return 0;
    arg= new_item;
igor@rurik.mysql.com's avatar
igor@rurik.mysql.com committed
1552
    return (this->*transformer)(args);
1553
  }
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
1554
};
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
1555

1556 1557 1558 1559 1560 1561 1562 1563 1564
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);
1565
  int save_in_field(Field *field_arg, bool no_conversions)
1566
  {
1567
    return Item_field::save_in_field(field_arg, no_conversions);
1568 1569
  }
  table_map used_tables() const { return (table_map)0L; }
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1570 1571 1572 1573 1574 1575

  bool walk(Item_processor processor, byte *args)
  {
    return arg->walk(processor, args) ||
	    (this->*processor)(args);
  }
1576 1577
};

1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612

/*
  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;
1613 1614
  /* Next in list of all Item_trigger_field's in trigger */
  Item_trigger_field *next_trg_field;
1615 1616 1617 1618 1619 1620

  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)
  {}
1621
  void setup_field(THD *thd, TABLE *table, enum trg_event_type event);
1622 1623 1624 1625 1626 1627 1628 1629 1630
  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();
};


1631 1632
class Item_cache: public Item
{
1633 1634
protected:
  Item *example;
1635
  table_map used_table_map;
1636
public:
1637
  Item_cache(): example(0), used_table_map(0) {fixed= 1; null_value= 1;}
1638 1639 1640

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

bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1641
  virtual bool allocate(uint i) { return 0; }
1642
  virtual bool setup(Item *item)
1643
  {
1644 1645 1646 1647 1648 1649
    example= item;
    max_length= item->max_length;
    decimals= item->decimals;
    collation.set(item->collation);
    return 0;
  };
1650 1651
  virtual void store(Item *)= 0;
  enum Type type() const { return CACHE_ITEM; }
1652
  static Item_cache* get_cache(Item_result type);
1653
  table_map used_tables() const { return used_table_map; }
1654
  virtual void keep_array() {}
1655
  // to prevent drop fixed flag (no need parent cleanup call)
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
1656
  void cleanup() {}
1657
  void print(String *str);
1658 1659
};

1660

1661 1662
class Item_cache_int: public Item_cache
{
1663
protected:
1664 1665
  longlong value;
public:
1666
  Item_cache_int(): Item_cache(), value(0) {}
1667

1668
  void store(Item *item);
1669
  double val_real() { DBUG_ASSERT(fixed == 1); return (double) value; }
1670
  longlong val_int() { DBUG_ASSERT(fixed == 1); return value; }
1671 1672
  String* val_str(String *str);
  my_decimal *val_decimal(my_decimal *);
1673 1674 1675
  enum Item_result result_type() const { return INT_RESULT; }
};

1676

1677 1678 1679 1680
class Item_cache_real: public Item_cache
{
  double value;
public:
1681
  Item_cache_real(): Item_cache(), value(0) {}
1682

1683
  void store(Item *item);
1684
  double val_real() { DBUG_ASSERT(fixed == 1); return value; }
1685 1686 1687
  longlong val_int();
  String* val_str(String *str);
  my_decimal *val_decimal(my_decimal *);
1688 1689 1690
  enum Item_result result_type() const { return REAL_RESULT; }
};

1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707

class Item_cache_decimal: public Item_cache
{
protected:
  my_decimal decimal_value;
public:
  Item_cache_decimal(): Item_cache() {}

  void store(Item *item);
  double val_real();
  longlong val_int();
  String* val_str(String *str);
  my_decimal *val_decimal(my_decimal *);
  enum Item_result result_type() const { return DECIMAL_RESULT; }
};


1708 1709
class Item_cache_str: public Item_cache
{
1710
  char buffer[STRING_BUFFER_USUAL_SIZE];
1711
  String *value, value_buff;
1712
public:
1713
  Item_cache_str(): Item_cache(), value(0) { }
1714

1715
  void store(Item *item);
1716
  double val_real();
1717
  longlong val_int();
1718
  String* val_str(String *) { DBUG_ASSERT(fixed == 1); return value; }
1719
  my_decimal *val_decimal(my_decimal *);
1720 1721 1722 1723
  enum Item_result result_type() const { return STRING_RESULT; }
  CHARSET_INFO *charset() const { return value->charset(); };
};

1724 1725 1726
class Item_cache_row: public Item_cache
{
  Item_cache  **values;
1727
  uint item_count;
1728
  bool save_array;
1729
public:
1730 1731
  Item_cache_row()
    :Item_cache(), values(0), item_count(2), save_array(0) {}
1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748
  
  /*
    '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");
  };
1749
  double val_real()
1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763
  {
    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;
  };
1764 1765 1766 1767 1768 1769
  my_decimal *val_decimal(my_decimal *val)
  {
    illegal_method_call((const char*)"val_decimal");
    return 0;
  };

1770 1771
  enum Item_result result_type() const { return ROW_RESULT; }
  
1772
  uint cols() { return item_count; }
1773 1774 1775 1776 1777
  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();
1778
  void keep_array() { save_array= 1; }
hf@deer.(none)'s avatar
hf@deer.(none) committed
1779 1780
  void cleanup()
  {
1781
    DBUG_ENTER("Item_cache_row::cleanup");
hf@deer.(none)'s avatar
hf@deer.(none) committed
1782
    Item_cache::cleanup();
1783 1784 1785 1786
    if (save_array)
      bzero(values, item_count*sizeof(Item**));
    else
      values= 0;
1787
    DBUG_VOID_RETURN;
hf@deer.(none)'s avatar
hf@deer.(none) committed
1788
  }
1789 1790
};

1791 1792

/*
1793 1794 1795 1796 1797
  Item_type_holder used to store type. name, length of Item for UNIONS &
  derived tables.

  Item_type_holder do not need cleanup() because its time of live limited by
  single SP/PS execution.
1798 1799 1800 1801
*/
class Item_type_holder: public Item
{
protected:
1802 1803 1804 1805
  TYPELIB *enum_set_typelib;
  enum_field_types fld_type;

  void get_full_info(Item *item);
1806
public:
1807
  Item_type_holder(THD*, Item*);
1808

1809 1810
  Item_result result_type() const;
  virtual enum_field_types field_type() const { return fld_type; };
1811
  enum Type type() const { return TYPE_HOLDER; }
1812
  double val_real();
1813
  longlong val_int();
1814
  my_decimal *val_decimal(my_decimal *);
1815
  String *val_str(String*);
1816 1817 1818 1819
  bool join_types(THD *thd, Item *);
  Field *make_field_by_type(TABLE *table);
  static uint32 display_length(Item *item);
  static enum_field_types get_real_type(Item *);
1820 1821 1822
};


bk@work.mysql.com's avatar
bk@work.mysql.com committed
1823 1824
extern Item_buff *new_Item_buff(Item *item);
extern Item_result item_cmp_type(Item_result a,Item_result b);
1825
extern void resolve_const_item(THD *thd, Item **ref, Item *cmp_item);
bk@work.mysql.com's avatar
bk@work.mysql.com committed
1826
extern bool field_is_equal_to_item(Field *field,Item *item);