item.h 32.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 */
unknown's avatar
unknown committed
25

26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

/*
   "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;
  
  DTCollation()
  {
    collation= &my_charset_bin;
    derivation= DERIVATION_NONE;
  }
  DTCollation(CHARSET_INFO *collation_arg, Derivation derivation_arg)
  {
    collation= collation_arg;
    derivation= derivation_arg;
  }
55
  void set(DTCollation &dt)
56
  { 
57 58
    collation= dt.collation;
    derivation= dt.derivation;
59 60 61 62 63 64 65 66 67 68
  }
  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; }
69 70 71
  bool aggregate(DTCollation &dt);
  bool set(DTCollation &dt1, DTCollation &dt2)
  { set(dt1); return aggregate(dt2); }
72 73 74 75 76 77 78 79 80 81 82 83 84
  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
85 86
typedef bool (Item::*Item_processor)(byte *arg);

unknown's avatar
unknown committed
87
class Item {
unknown's avatar
unknown committed
88
  Item(const Item &);			/* Prevent use of these */
unknown's avatar
unknown committed
89 90
  void operator=(Item &);
public:
unknown's avatar
unknown committed
91
  static void *operator new(size_t size) {return (void*) sql_alloc((uint) size); }
92 93
  static void *operator new(size_t size, MEM_ROOT *mem_root)
  { return (void*) alloc_root(mem_root, (uint) size); }
unknown's avatar
unknown committed
94 95
  static void operator delete(void *ptr,size_t size) {} /*lint -e715 */

96 97
  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
98
	     COPY_STR_ITEM, FIELD_AVG_ITEM, DEFAULT_VALUE_ITEM,
unknown's avatar
unknown committed
99 100
	     PROC_ITEM,COND_ITEM, REF_ITEM, FIELD_STD_ITEM,
	     FIELD_VARIANCE_ITEM, INSERT_VALUE_ITEM,
101
             SUBSELECT_ITEM, ROW_ITEM, CACHE_ITEM, TYPE_HOLDER};
unknown's avatar
SCRUM  
unknown committed
102

unknown's avatar
unknown committed
103
  enum cond_result { COND_UNDEF,COND_OK,COND_TRUE,COND_FALSE };
104
  
unknown's avatar
unknown committed
105 106 107 108 109 110 111
  String str_value;			/* used to store value */
  my_string name;			/* Name from select */
  Item *next;
  uint32 max_length;
  uint8 marker,decimals;
  my_bool maybe_null;			/* If item may be null */
  my_bool null_value;			/* if item is null */
112
  my_bool unsigned_flag;
unknown's avatar
unknown committed
113
  my_bool with_sum_func;
114
  my_bool fixed;                        /* If item fixed with fix_fields */
115
  DTCollation collation;
116

unknown's avatar
unknown committed
117 118
  // alloc & destruct is done as start of select using sql_alloc
  Item();
119 120 121 122
  /*
     Constructor used by Item_field, Item_ref & agregate (sum) functions.
     Used for duplicating lists in processing queries with temporary
     tables
123 124 125
     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
126
  */
127
  Item(THD *thd, Item *item);
128
  virtual ~Item() { name=0; }		/*lint -e1509 */
unknown's avatar
unknown committed
129
  void set_name(const char *str,uint length, CHARSET_INFO *cs);
unknown's avatar
unknown committed
130
  void init_make_field(Send_field *tmp_field,enum enum_field_types type);
unknown's avatar
unknown committed
131 132 133 134 135 136 137
  virtual void cleanup()
  {
    DBUG_ENTER("Item::cleanup");
    DBUG_PRINT("info", ("Type: %d", (int)type()));
    fixed=0;
    DBUG_VOID_RETURN;
  }
138
  virtual void make_field(Send_field *field);
unknown's avatar
unknown committed
139
  virtual bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
unknown committed
140
  virtual int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
141
  virtual void save_org_in_field(Field *field)
142
  { (void) save_in_field(field, 1); }
unknown's avatar
unknown committed
143
  virtual int save_safe_in_field(Field *field)
144
  { return save_in_field(field, 1); }
145
  virtual bool send(Protocol *protocol, String *str);
146
  virtual bool eq(const Item *, bool binary_cmp) const;
unknown's avatar
unknown committed
147
  virtual Item_result result_type () const { return REAL_RESULT; }
148
  virtual enum_field_types field_type() const;
unknown's avatar
unknown committed
149 150 151 152
  virtual enum Type type() const =0;
  virtual double val()=0;
  virtual longlong val_int()=0;
  virtual String *val_str(String*)=0;
153
  virtual Field *get_tmp_table_field() { return 0; }
154
  virtual Field *tmp_table_field(TABLE *t_arg) { return 0; }
unknown's avatar
unknown committed
155 156 157 158
  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); }
159
  /* bit map of tables used by item */
unknown's avatar
unknown committed
160
  virtual table_map used_tables() const { return (table_map) 0L; }
161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
  /*
    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
177 178 179 180 181
  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;}
182 183 184 185
  /* 
    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
186
  virtual bool const_item() const { return used_tables() == 0; }
187 188 189 190 191 192
  /* 
    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
193
  virtual void print(String *str_arg) { str_arg->append(full_name()); }
unknown's avatar
unknown committed
194
  void print_item_w_name(String *);
unknown's avatar
unknown committed
195
  virtual void update_used_tables() {}
196
  virtual void split_sum_func(Item **ref_pointer_array, List<Item> &fields) {}
197
  virtual bool get_date(TIME *ltime,uint fuzzydate);
unknown's avatar
unknown committed
198
  virtual bool get_time(TIME *ltime);
199
  virtual bool get_date_result(TIME *ltime,uint fuzzydate)
200
  { return get_date(ltime,fuzzydate); }
201
  virtual bool is_null() { return 0; }
202
  virtual void top_level_item() {}
unknown's avatar
unknown committed
203 204 205
  virtual void set_result_field(Field *field) {}
  virtual bool is_result_field() { return 0; }
  virtual void save_in_result_field(bool no_conversions) {}
unknown's avatar
unknown committed
206
  virtual void no_rows_in_result() {}
207
  virtual Item *copy_or_same(THD *thd) { return this; }
208
  virtual Item *copy_andor_structure(THD *thd) { return this; }
unknown's avatar
unknown committed
209
  virtual Item *real_item() { return this; }
210
  virtual Item *get_tmp_table_item(THD *thd) { return copy_or_same(thd); }
unknown's avatar
unknown committed
211

212
  CHARSET_INFO *default_charset() const;
213
  virtual CHARSET_INFO *compare_collation() { return NULL; }
unknown's avatar
unknown committed
214 215 216 217 218 219 220

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

  virtual bool remove_dependence_processor(byte * arg) { return 0; }
221
  virtual bool remove_fixed(byte * arg) { fixed= 0; return 0; }
222
  
unknown's avatar
unknown committed
223 224 225
  // Row emulation
  virtual uint cols() { return 1; }
  virtual Item* el(uint i) { return this; }
226
  virtual Item** addr(uint i) { return 0; }
unknown's avatar
unknown committed
227
  virtual bool check_cols(uint c);
unknown's avatar
unknown committed
228
  // It is not row => null inside is impossible
229 230 231
  virtual bool null_inside() { return 0; }
  // used in row subselects to get value of elements
  virtual void bring_value() {}
232 233

  Field *tmp_table_field_from_field_type(TABLE *table);
234 235
  
  /* Used in sql_select.cc:eliminate_not_funcs() */
236
  virtual Item *neg_transformer(THD *thd) { return NULL; }
237 238 239 240 241
  void delete_self()
  {
    cleanup();
    delete this;
  }
unknown's avatar
unknown committed
242 243 244
};


unknown's avatar
unknown committed
245
class st_select_lex;
unknown's avatar
unknown committed
246 247
class Item_ident :public Item
{
248
  Item **changed_during_fix_field;
unknown's avatar
unknown committed
249 250 251 252
public:
  const char *db_name;
  const char *table_name;
  const char *field_name;
unknown's avatar
unknown committed
253
  st_select_lex *depended_from;
unknown's avatar
unknown committed
254
  Item_ident(const char *db_name_par,const char *table_name_par,
255
	     const char *field_name_par);
256
  Item_ident(THD *thd, Item_ident *item);
unknown's avatar
unknown committed
257
  const char *full_name() const;
258 259 260
  void cleanup();
  void register_item_tree_changing(Item **ref)
    { changed_during_fix_field= ref; }
unknown's avatar
unknown committed
261
  bool remove_dependence_processor(byte * arg);
unknown's avatar
unknown committed
262 263
};

unknown's avatar
unknown committed
264

unknown's avatar
unknown committed
265 266 267 268 269
class Item_field :public Item_ident
{
  void set_field(Field *field);
public:
  Field *field,*result_field;
270 271 272
#ifndef DBUG_OFF
  bool double_fix;
#endif
unknown's avatar
unknown committed
273 274 275

  Item_field(const char *db_par,const char *table_name_par,
	     const char *field_name_par)
276 277 278 279 280
    :Item_ident(db_par,table_name_par,field_name_par),
     field(0), result_field(0)
#ifndef DBUG_OFF
    ,double_fix(0)
#endif
281
  { collation.set(DERIVATION_IMPLICIT); }
282
  // Constructor need to process subselect with temporary tables (see Item)
283
  Item_field(THD *thd, Item_field *item);
unknown's avatar
unknown committed
284 285
  Item_field(Field *field);
  enum Type type() const { return FIELD_ITEM; }
286
  bool eq(const Item *item, bool binary_cmp) const;
unknown's avatar
unknown committed
287 288 289 290 291 292
  double val();
  longlong val_int();
  String *val_str(String*);
  double val_result();
  longlong val_int_result();
  String *str_result(String* tmp);
293
  bool send(Protocol *protocol, String *str_arg);
unknown's avatar
unknown committed
294
  bool fix_fields(THD *, struct st_table_list *, Item **);
295
  void make_field(Send_field *tmp_field);
unknown's avatar
unknown committed
296
  int save_in_field(Field *field,bool no_conversions);
unknown's avatar
unknown committed
297 298 299 300 301 302
  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
303
  enum_field_types field_type() const
304 305 306
  {
    return field->type();
  }
307
  Field *get_tmp_table_field() { return result_field; }
308
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
309 310
  bool get_date(TIME *ltime,uint fuzzydate);
  bool get_date_result(TIME *ltime,uint fuzzydate);
311
  bool get_time(TIME *ltime);
unknown's avatar
unknown committed
312
  bool is_null() { return field->is_null(); }
313
  Item *get_tmp_table_item(THD *thd);
unknown's avatar
unknown committed
314
  void cleanup();
unknown's avatar
SCRUM  
unknown committed
315
  friend class Item_default_value;
unknown's avatar
unknown committed
316
  friend class Item_insert_value;
unknown's avatar
unknown committed
317 318 319 320 321 322 323 324
};

class Item_null :public Item
{
public:
  Item_null(char *name_par=0)
    { maybe_null=null_value=TRUE; name= name_par ? name_par : (char*) "NULL";}
  enum Type type() const { return NULL_ITEM; }
325
  bool eq(const Item *item, bool binary_cmp) const;
unknown's avatar
unknown committed
326 327 328
  double val();
  longlong val_int();
  String *val_str(String *str);
unknown's avatar
unknown committed
329
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
330
  int save_safe_in_field(Field *field);
unknown's avatar
unknown committed
331
  bool send(Protocol *protocol, String *str);
332 333 334 335
  enum Item_result result_type () const { return STRING_RESULT; }
  enum_field_types field_type() const   { return MYSQL_TYPE_NULL; }
  bool fix_fields(THD *thd, struct st_table_list *list, Item **item)
  {
336
    DBUG_ASSERT(fixed == 0);
337 338 339 340
    bool res= Item::fix_fields(thd, list, item);
    max_length=0;
    return res;
  }
unknown's avatar
unknown committed
341 342
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_null(name); }
unknown's avatar
unknown committed
343
  bool is_null() { return 1; }
344
  void print(String *str) { str->append("NULL", 4); }
unknown's avatar
unknown committed
345 346
};

unknown's avatar
unknown committed
347 348 349
class Item_param :public Item
{
public:    
350
  bool value_is_set;
unknown's avatar
unknown committed
351 352
  longlong int_value;
  double   real_value;
353
  TIME     ltime;
unknown's avatar
unknown committed
354 355 356
  enum Item_result item_result_type;
  enum Type item_type;
  enum enum_field_types buffer_type;
357
  bool item_is_time;
358 359
  bool long_data_supplied;
  uint pos_in_query;
unknown's avatar
unknown committed
360

361
  Item_param(uint position);
unknown's avatar
unknown committed
362 363 364 365
  enum Type type() const { return item_type; }
  double val();
  longlong val_int();
  String *val_str(String*);
unknown's avatar
unknown committed
366
  int  save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
367 368 369
  void set_null();
  void set_int(longlong i);
  void set_double(double i);
unknown's avatar
unknown committed
370 371 372 373
  void set_value(const char *str, uint length);
  void set_long_str(const char *str, ulong length);
  void set_long_binary(const char *str, ulong length);
  void set_longdata(const char *str, ulong length);
unknown's avatar
unknown committed
374
  void set_long_end();
375 376
  void set_time(TIME *tm, timestamp_type type);
  bool get_time(TIME *tm);
377
  void reset() {}
378 379 380 381 382 383 384 385
  /*
    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);

unknown's avatar
unknown committed
386
  enum Item_result result_type () const
unknown's avatar
unknown committed
387
  { return item_result_type; }
388
  String *query_val_str(String *str);
389
  enum_field_types field_type() const { return MYSQL_TYPE_STRING; }
390
  Item *new_item() { return new Item_param(pos_in_query); }
391 392 393 394 395 396 397
  /* 
    If value for parameter was not set we treat it as non-const 
    so noone will use parameters value in fix_fields still 
    parameter is constant during execution.
  */
  virtual table_map used_tables() const
  { return value_is_set ? (table_map)0 : PARAM_TABLE_BIT; }
unknown's avatar
unknown committed
398
  void print(String *str) { str->append('?'); }
unknown's avatar
unknown committed
399
};
unknown's avatar
unknown committed
400 401 402 403 404 405

class Item_int :public Item
{
public:
  const longlong value;
  Item_int(int32 i,uint length=11) :value((longlong) i)
406
    { max_length=length; fixed= 1; }
unknown's avatar
unknown committed
407 408
#ifdef HAVE_LONG_LONG
  Item_int(longlong i,uint length=21) :value(i)
409
    { max_length=length; fixed= 1;}
unknown's avatar
unknown committed
410 411
#endif
  Item_int(const char *str_arg,longlong i,uint length) :value(i)
412
    { max_length=length; name=(char*) str_arg; fixed= 1; }
unknown's avatar
unknown committed
413 414 415
  Item_int(const char *str_arg) :
    value(str_arg[0] == '-' ? strtoll(str_arg,(char**) 0,10) :
	  (longlong) strtoull(str_arg,(char**) 0,10))
416
    { max_length= (uint) strlen(str_arg); name=(char*) str_arg; fixed= 1; }
unknown's avatar
unknown committed
417
  enum Type type() const { return INT_ITEM; }
418 419
  enum Item_result result_type () const { return INT_RESULT; }
  enum_field_types field_type() const { return MYSQL_TYPE_LONGLONG; }
unknown's avatar
unknown committed
420 421 422
  longlong val_int() { return value; }
  double val() { return (double) value; }
  String *val_str(String*);
unknown's avatar
unknown committed
423
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
424 425
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_int(name,value,max_length); }
426 427
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() { fixed= 1; }
unknown's avatar
unknown committed
428 429 430 431
  void print(String *str);
};


unknown's avatar
unknown committed
432 433 434 435
class Item_uint :public Item_int
{
public:
  Item_uint(const char *str_arg, uint length) :
436 437 438 439
    Item_int(str_arg, (longlong) strtoull(str_arg,(char**) 0,10), length) 
    { fixed= 0; }
  Item_uint(uint32 i) :Item_int((longlong) i, 10) 
    { fixed= 0; }
440
  double val() { return ulonglong2double((ulonglong)value); }
unknown's avatar
unknown committed
441 442
  String *val_str(String*);
  Item *new_item() { return new Item_uint(name,max_length); }
unknown's avatar
unknown committed
443
  int save_in_field(Field *field, bool no_conversions);
444 445
  bool fix_fields(THD *thd, struct st_table_list *list, Item **item)
  {
446
    DBUG_ASSERT(fixed == 0);
447 448 449 450
    bool res= Item::fix_fields(thd, list, item);
    unsigned_flag= 1;
    return res;
  }
unknown's avatar
unknown committed
451 452 453 454
  void print(String *str);
};


unknown's avatar
unknown committed
455 456 457 458 459
class Item_real :public Item
{
public:
  const double value;
  // Item_real() :value(0) {}
unknown's avatar
unknown committed
460
  Item_real(const char *str_arg,uint length) :value(my_atof(str_arg))
unknown's avatar
unknown committed
461 462
  {
    name=(char*) str_arg;
unknown's avatar
unknown committed
463
    decimals=(uint8) nr_of_decimals(str_arg);
unknown's avatar
unknown committed
464 465 466 467 468 469
    max_length=length;
  }
  Item_real(const char *str,double val_arg,uint decimal_par,uint length)
    :value(val_arg)
  {
    name=(char*) str;
unknown's avatar
unknown committed
470
    decimals=(uint8) decimal_par;
unknown's avatar
unknown committed
471 472 473
    max_length=length;
  }
  Item_real(double value_par) :value(value_par) {}
unknown's avatar
unknown committed
474
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
475
  enum Type type() const { return REAL_ITEM; }
476
  enum_field_types field_type() const { return MYSQL_TYPE_DOUBLE; }
unknown's avatar
unknown committed
477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497
  double val() { return value; }
  longlong val_int() { return (longlong) (value+(value > 0 ? 0.5 : -0.5));}
  String *val_str(String*);
  bool basic_const_item() const { return 1; }
  Item *new_item() { return new Item_real(name,value,decimals,max_length); }
};


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
498
  Item_string(const char *str,uint length,
499
  	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
unknown's avatar
unknown committed
500
  {
501
    collation.set(cs, dv);
unknown's avatar
unknown committed
502
    str_value.set_or_copy_aligned(str,length,cs);
503 504 505 506 507 508 509
    /*
      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).
    */
510
    max_length= str_value.numchars()*cs->mbmaxlen;
unknown's avatar
unknown committed
511
    set_name(str, length, cs);
unknown's avatar
unknown committed
512 513
    decimals=NOT_FIXED_DEC;
  }
514
  Item_string(const char *name_par, const char *str, uint length,
515
	      CHARSET_INFO *cs, Derivation dv= DERIVATION_COERCIBLE)
unknown's avatar
unknown committed
516
  {
517
    collation.set(cs, dv);
unknown's avatar
unknown committed
518
    str_value.set_or_copy_aligned(str,length,cs);
519
    max_length= str_value.numchars()*cs->mbmaxlen;
unknown's avatar
unknown committed
520
    set_name(name_par,0,cs);
unknown's avatar
unknown committed
521 522 523
    decimals=NOT_FIXED_DEC;
  }
  enum Type type() const { return STRING_ITEM; }
524 525
  double val()
  { 
526
    int err;
527
    return my_strntod(str_value.charset(), (char*) str_value.ptr(),
528
		      str_value.length(), (char**) 0, &err);
529 530 531
  }
  longlong val_int()
  {
532
    int err;
533
    return my_strntoll(str_value.charset(), str_value.ptr(),
534
		       str_value.length(), 10, (char**) 0, &err);
535
  }
unknown's avatar
unknown committed
536
  String *val_str(String*) { return (String*) &str_value; }
unknown's avatar
unknown committed
537
  int save_in_field(Field *field, bool no_conversions);
unknown's avatar
unknown committed
538
  enum Item_result result_type () const { return STRING_RESULT; }
539
  enum_field_types field_type() const { return MYSQL_TYPE_STRING; }
unknown's avatar
unknown committed
540
  bool basic_const_item() const { return 1; }
541
  bool eq(const Item *item, bool binary_cmp) const;
542 543
  Item *new_item() 
  {
544 545
    return new Item_string(name, str_value.ptr(), 
    			   str_value.length(), &my_charset_bin);
546
  }
unknown's avatar
unknown committed
547
  String *const_string() { return &str_value; }
548
  inline void append(char *str, uint length) { str_value.append(str, length); }
unknown's avatar
unknown committed
549 550 551 552 553 554 555 556
  void print(String *str);
};

/* for show tables */

class Item_datetime :public Item_string
{
public:
unknown's avatar
unknown committed
557 558
  Item_datetime(const char *item_name): Item_string(item_name,"",0,
  						    &my_charset_bin)
unknown's avatar
unknown committed
559
  { max_length=19;}
560
  enum_field_types field_type() const { return MYSQL_TYPE_DATETIME; }
unknown's avatar
unknown committed
561 562 563 564 565
};

class Item_empty_string :public Item_string
{
public:
unknown's avatar
unknown committed
566 567
  Item_empty_string(const char *header,uint length) :Item_string("",0,
  							&my_charset_bin)
unknown's avatar
unknown committed
568
    { name=(char*) header; max_length=length;}
569
  void make_field(Send_field *field);
unknown's avatar
unknown committed
570 571
};

572 573 574 575 576 577 578 579 580 581 582 583 584 585
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
586 587 588
class Item_varbinary :public Item
{
public:
589
  Item_varbinary(const char *str,uint str_length);
unknown's avatar
unknown committed
590 591 592 593
  enum Type type() const { return VARBIN_ITEM; }
  double val() { return (double) Item_varbinary::val_int(); }
  longlong val_int();
  String *val_str(String*) { return &str_value; }
unknown's avatar
unknown committed
594
  int save_in_field(Field *field, bool no_conversions);
595
  enum Item_result result_type () const { return STRING_RESULT; }
596
  enum_field_types field_type() const { return MYSQL_TYPE_STRING; }
unknown's avatar
unknown committed
597 598 599 600 601 602 603 604
};


class Item_result_field :public Item	/* Item with result field */
{
public:
  Field *result_field;				/* Save result here */
  Item_result_field() :result_field(0) {}
605
  // Constructor used for Item_sum/Item_cond_and/or (see Item comment)
606 607
  Item_result_field(THD *thd, Item_result_field *item):
    Item(thd, item), result_field(item->result_field)
608
  {}
unknown's avatar
unknown committed
609
  ~Item_result_field() {}			/* Required with gcc 2.95 */
610
  Field *get_tmp_table_field() { return result_field; }
611
  Field *tmp_table_field(TABLE *t_arg) { return result_field; }
unknown's avatar
unknown committed
612
  table_map used_tables() const { return 1; }
unknown's avatar
unknown committed
613
  virtual void fix_length_and_dec()=0;
unknown's avatar
unknown committed
614 615 616 617 618 619
  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
620 621 622 623 624 625
};


class Item_ref :public Item_ident
{
public:
unknown's avatar
unknown committed
626
  Field *result_field;			 /* Save result here */
unknown's avatar
unknown committed
627
  Item **ref;
unknown's avatar
unknown committed
628 629 630 631 632 633 634 635 636 637
  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)
    :Item_ident(db_par,table_name_par,field_name_par),ref(0), hook_ptr(hook),
    orig_item(original) {}
  Item_ref(Item **item, Item **hook, 
	   const char *table_name_par, const char *field_name_par)
    :Item_ident(NullS,table_name_par,field_name_par),
    ref(item), hook_ptr(hook), orig_item(hook ? *hook:0) {}
638
  // Constructor need to process subselect with temporary tables (see Item)
639 640
  Item_ref(THD *thd, Item_ref *item, Item **hook)
    :Item_ident(thd, item), ref(item->ref), 
unknown's avatar
unknown committed
641
    hook_ptr(hook), orig_item(hook ? *hook : 0) {}
unknown's avatar
unknown committed
642
  enum Type type() const		{ return REF_ITEM; }
643
  bool eq(const Item *item, bool binary_cmp) const
unknown's avatar
unknown committed
644
  { return ref && (*ref)->eq(item, binary_cmp); }
unknown's avatar
unknown committed
645 646 647
  double val()
  {
    double tmp=(*ref)->val_result();
unknown's avatar
unknown committed
648
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
649 650 651 652 653
    return tmp;
  }
  longlong val_int()
  {
    longlong tmp=(*ref)->val_int_result();
unknown's avatar
unknown committed
654
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
655 656 657 658 659
    return tmp;
  }
  String *val_str(String* tmp)
  {
    tmp=(*ref)->str_result(tmp);
unknown's avatar
unknown committed
660
    null_value=(*ref)->null_value;
unknown's avatar
unknown committed
661 662
    return tmp;
  }
663 664 665
  bool is_null()
  {
    (void) (*ref)->val_int_result();
unknown's avatar
unknown committed
666
    return (*ref)->null_value;
667
  }
668
  bool get_date(TIME *ltime,uint fuzzydate)
669 670
  {
    return (null_value=(*ref)->get_date_result(ltime,fuzzydate));
unknown's avatar
unknown committed
671
  }
672
  bool send(Protocol *prot, String *tmp){ return (*ref)->send(prot, tmp); }
unknown's avatar
unknown committed
673
  void make_field(Send_field *field)	{ (*ref)->make_field(field); }
unknown's avatar
unknown committed
674
  bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
unknown committed
675
  int save_in_field(Field *field, bool no_conversions)
676
  { return (*ref)->save_in_field(field, no_conversions); }
unknown's avatar
unknown committed
677 678
  void save_org_in_field(Field *field)	{ (*ref)->save_org_in_field(field); }
  enum Item_result result_type () const { return (*ref)->result_type(); }
679
  enum_field_types field_type() const   { return (*ref)->field_type(); }
unknown's avatar
unknown committed
680
  table_map used_tables() const		{ return (*ref)->used_tables(); }
681
  void set_result_field(Field *field)	{ result_field= field; }
unknown's avatar
unknown committed
682 683 684 685 686
  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
687
  Item *real_item() { return *ref; }
unknown's avatar
unknown committed
688
  void print(String *str);
unknown's avatar
unknown committed
689
  void cleanup();
unknown's avatar
unknown committed
690 691
};

692 693 694 695 696 697 698
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
699
		       const char *table_name_par, const char *field_name_par):
unknown's avatar
unknown committed
700
    Item_ref(item, NULL, table_name_par, field_name_par), owner(master) {}
701 702 703
  double val();
  longlong val_int();
  String* val_str(String* s);
704
  bool get_date(TIME *ltime, uint fuzzydate);
unknown's avatar
unknown committed
705
  void print(String *str);
706 707
};

708 709 710 711 712 713 714 715 716
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
717
  void print(String *str);
718
};
unknown's avatar
unknown committed
719

720 721 722 723 724 725 726 727 728 729 730 731
/*
  The following class is used to optimize comparing of date columns
  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)
  {}
unknown's avatar
unknown committed
732
  int save_in_field(Field *field, bool no_conversions)
733
  {
734
    return ref->save_in_field(field, no_conversions);
735 736 737 738
  }
};


739
#include "gstream.h"
unknown's avatar
unknown committed
740
#include "spatial.h"
unknown's avatar
unknown committed
741 742
#include "item_sum.h"
#include "item_func.h"
743
#include "item_row.h"
unknown's avatar
unknown committed
744 745
#include "item_cmpfunc.h"
#include "item_strfunc.h"
746
#include "item_geofunc.h"
unknown's avatar
unknown committed
747 748
#include "item_timefunc.h"
#include "item_uniq.h"
749
#include "item_subselect.h"
unknown's avatar
unknown committed
750 751 752

class Item_copy_string :public Item
{
753
  enum enum_field_types cached_field_type;
unknown's avatar
unknown committed
754 755 756 757 758 759 760 761
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;
762
    cached_field_type= item->field_type();
unknown's avatar
unknown committed
763 764 765
  }
  enum Type type() const { return COPY_STR_ITEM; }
  enum Item_result result_type () const { return STRING_RESULT; }
766
  enum_field_types field_type() const { return cached_field_type; }
unknown's avatar
unknown committed
767
  double val()
768
  {
769
    int err;
770 771
    return (null_value ? 0.0 :
	    my_strntod(str_value.charset(), (char*) str_value.ptr(),
772
		       str_value.length(),NULL,&err));
773
  }
unknown's avatar
unknown committed
774
  longlong val_int()
775 776 777 778
  { 
    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
779 780 781 782 783
  String *val_str(String*);
  void make_field(Send_field *field) { item->make_field(field); }
  void copy();
  table_map used_tables() const { return (table_map) 1L; }
  bool const_item() const { return 0; }
unknown's avatar
unknown committed
784
  bool is_null() { return null_value; }
unknown's avatar
unknown committed
785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841
};


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
842 843 844 845
class Item_default_value : public Item_field
{
public:
  Item *arg;
unknown's avatar
SCRUM  
unknown committed
846 847
  Item_default_value() :
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(NULL) {}
unknown's avatar
unknown committed
848
  Item_default_value(Item *a) :
unknown's avatar
SCRUM  
unknown committed
849
    Item_field((const char *)NULL, (const char *)NULL, (const char *)NULL), arg(a) {}
unknown's avatar
SCRUM  
unknown committed
850
  enum Type type() const { return DEFAULT_VALUE_ITEM; }
unknown's avatar
SCRUM  
unknown committed
851 852
  bool eq(const Item *item, bool binary_cmp) const;
  bool fix_fields(THD *, struct st_table_list *, Item **);
unknown's avatar
SCRUM  
unknown committed
853
  void print(String *str);
unknown's avatar
SCRUM  
unknown committed
854
  virtual bool basic_const_item() const { return true; }
855
  int save_in_field(Field *field_arg, bool no_conversions)
unknown's avatar
SCRUM  
unknown committed
856 857 858
  {
    if (!arg)
    {
859
      field_arg->set_default();
unknown's avatar
SCRUM  
unknown committed
860 861
      return 0;
    }
862
    return Item_field::save_in_field(field_arg, no_conversions);
unknown's avatar
SCRUM  
unknown committed
863
  }
unknown's avatar
SCRUM  
unknown committed
864
  table_map used_tables() const { return (table_map)0L; }
unknown's avatar
unknown committed
865 866 867 868 869 870
  
  bool walk(Item_processor processor, byte *args)
  {
    return arg->walk(processor, args) ||
      (this->*processor)(args);
  }
unknown's avatar
unknown committed
871
};
unknown's avatar
unknown committed
872

unknown's avatar
unknown committed
873 874 875 876 877 878 879 880 881 882
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);
  virtual bool basic_const_item() const { return true; }
883
  int save_in_field(Field *field_arg, bool no_conversions)
unknown's avatar
unknown committed
884
  {
885
    return Item_field::save_in_field(field_arg, no_conversions);
unknown's avatar
unknown committed
886 887
  }
  table_map used_tables() const { return (table_map)0L; }
unknown's avatar
unknown committed
888 889 890 891 892 893

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

896 897
class Item_cache: public Item
{
unknown's avatar
unknown committed
898 899
protected:
  Item *example;
900
  table_map used_table_map;
901
public:
unknown's avatar
unknown committed
902
  Item_cache(): example(0), used_table_map(0) {fixed= 1; null_value= 1;}
903 904 905

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

unknown's avatar
unknown committed
906
  virtual bool allocate(uint i) { return 0; };
907 908 909 910 911 912 913 914
  virtual bool setup(Item *item)
  {
    example= item;
    max_length= item->max_length;
    decimals= item->decimals;
    collation.set(item->collation);
    return 0;
  };
915 916
  virtual void store(Item *)= 0;
  enum Type type() const { return CACHE_ITEM; }
917
  static Item_cache* get_cache(Item_result type);
918
  table_map used_tables() const { return used_table_map; }
919
  virtual void keep_array() {}
920 921
  // to prevent drop fixed flag (no need parent cleanup call)
  void cleanup() { fixed= 1; }
unknown's avatar
unknown committed
922
  void print(String *str);
923 924 925 926 927 928
};

class Item_cache_int: public Item_cache
{
  longlong value;
public:
929
  Item_cache_int(): Item_cache() {}
930
  
unknown's avatar
unknown committed
931
  void store(Item *item);
932 933
  double val() { return (double) value; }
  longlong val_int() { return value; }
934
  String* val_str(String *str) { str->set(value, default_charset()); return str; }
935 936 937 938 939 940 941
  enum Item_result result_type() const { return INT_RESULT; }
};

class Item_cache_real: public Item_cache
{
  double value;
public:
942
  Item_cache_real(): Item_cache() {}
943

unknown's avatar
unknown committed
944
  void store(Item *item);
945 946 947 948
  double val() { return value; }
  longlong val_int() { return (longlong) (value+(value > 0 ? 0.5 : -0.5)); }
  String* val_str(String *str)
  {
949
    str->set(value, decimals, default_charset());
950 951 952 953 954 955 956 957
    return str;
  }
  enum Item_result result_type() const { return REAL_RESULT; }
};

class Item_cache_str: public Item_cache
{
  char buffer[80];
958
  String *value, value_buff;
959
public:
960
  Item_cache_str(): Item_cache() { }
961
  
962 963 964
  void store(Item *item);
  double val();
  longlong val_int();
965 966 967 968 969
  String* val_str(String *) { return value; }
  enum Item_result result_type() const { return STRING_RESULT; }
  CHARSET_INFO *charset() const { return value->charset(); };
};

unknown's avatar
unknown committed
970 971 972
class Item_cache_row: public Item_cache
{
  Item_cache  **values;
unknown's avatar
unknown committed
973
  uint item_count;
974
  bool save_array;
unknown's avatar
unknown committed
975
public:
976 977
  Item_cache_row()
    :Item_cache(), values(0), item_count(2), save_array(0) {}
unknown's avatar
unknown committed
978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011
  
  /*
    '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
1012
  uint cols() { return item_count; }
unknown's avatar
unknown committed
1013 1014 1015 1016 1017
  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();
1018
  void keep_array() { save_array= 1; }
unknown's avatar
unknown committed
1019 1020
  void cleanup()
  {
unknown's avatar
unknown committed
1021
    DBUG_ENTER("Item_cache_row::cleanup");
unknown's avatar
unknown committed
1022
    Item_cache::cleanup();
1023 1024 1025 1026
    if (save_array)
      bzero(values, item_count*sizeof(Item**));
    else
      values= 0;
unknown's avatar
unknown committed
1027
    DBUG_VOID_RETURN;
unknown's avatar
unknown committed
1028
  }
unknown's avatar
unknown committed
1029 1030
};

1031 1032 1033 1034 1035 1036 1037 1038

/*
  Used to store type. name, length of Item for UNIONS & derived table
*/
class Item_type_holder: public Item
{
protected:
  Item_result item_type;
1039
  Item_result orig_type;
1040 1041 1042 1043 1044 1045 1046 1047 1048
  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*);
1049
  bool join_types(THD *thd, Item *);
1050
  Field *example() { return field_example; }
1051 1052
  void cleanup()
  {
unknown's avatar
unknown committed
1053
    DBUG_ENTER("Item_type_holder::cleanup");
1054 1055
    Item::cleanup();
    item_type= orig_type;
unknown's avatar
unknown committed
1056
    DBUG_VOID_RETURN;
1057
  }
1058 1059 1060
};


unknown's avatar
unknown committed
1061 1062 1063 1064
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);