drizzle
C++ MySQL-protocol-compatible database server
Loading...
Searching...
No Matches
drizzled::Item_null Class Reference
Inheritance diagram for drizzled::Item_null:
[legend]
Collaboration diagram for drizzled::Item_null:
[legend]

Public Member Functions

 Item_null (const char *name_par=0)
Type type () const
bool eq (const Item *item, bool binary_cmp) const
double val_real ()
int64_t val_int ()
String * val_str (String *str)
type::Decimal * val_decimal (type::Decimal *)
int save_in_field (Field *field, bool no_conversions)
int save_safe_in_field (Field *field)
void send (plugin::Client *client, String *str)
enum Item_result result_type () const
enum_field_types field_type () const
bool basic_const_item () const
Item * clone_item ()
bool is_null ()
virtual void print (String *str)
Item * safe_charset_converter (const charset_info_st *const tocs)
Public Member Functions inherited from drizzled::Item_basic_constant
void cleanup ()
Public Member Functions inherited from drizzled::Item
bool is_unsigned () const
virtual bool negative () const
 Item ()
 Item (Session *session, Item *item)
void set_name (str_ref arg)
void set_name (const char *arg)
void set_name (const char *str, uint32_t length, const charset_info_st *cs=system_charset_info)
void init_make_field (SendField *tmp_field, enum_field_types type)
virtual void make_field (SendField *field)
Field * make_string_field (Table *table)
virtual bool fix_fields (Session *, Item **)
virtual void fix_after_pullout (Select_Lex *new_parent, Item **ref)
void quick_fix_field ()
virtual void save_org_in_field (Field *field)
virtual Item_result cast_to_int_type () const
virtual enum_field_types string_field_type () const
virtual int64_t val_int_endpoint (bool left_endp, bool *incl_endp)
uint64_t val_uint ()
virtual bool val_bool ()
String * val_string_from_real (String *str)
String * val_string_from_int (String *str)
String * val_string_from_decimal (String *str)
type::Decimal * val_decimal_from_real (type::Decimal *decimal_value)
type::Decimal * val_decimal_from_int (type::Decimal *decimal_value)
type::Decimal * val_decimal_from_string (type::Decimal *decimal_value)
type::Decimal * val_decimal_from_date (type::Decimal *decimal_value)
type::Decimal * val_decimal_from_time (type::Decimal *decimal_value)
int64_t val_int_from_decimal ()
double val_real_from_decimal ()
bool save_time_in_field (Field *field)
bool save_date_in_field (Field *field)
int save_str_value_in_field (Field *field, String *result)
virtual Field * get_tmp_table_field (void)
virtual Field * tmp_table_field (Table *t_arg)
virtual const char * full_name (void) const
virtual double val_result ()
virtual int64_t val_int_result ()
virtual String * str_result (String *tmp)
virtual type::Decimal * val_decimal_result (type::Decimal *val)
virtual bool val_bool_result ()
virtual table_map used_tables () const
virtual table_map not_null_tables () const
virtual cond_result eq_cmp_result () const
uint32_t float_length (uint32_t decimals_par) const
virtual uint32_t decimal_precision () const
int decimal_int_part () const
virtual bool const_item () const
virtual bool const_during_execution () const
void print_item_w_name (String *)
virtual void update_used_tables ()
virtual void split_sum_func (Session *session, Item **ref_pointer_array, List< Item > &fields)
void split_sum_func (Session *session, Item **ref_pointer_array, List< Item > &fields, Item **ref, bool skip_registered)
virtual bool get_date (type::Time &ltime, uint32_t fuzzydate)
virtual bool get_time (type::Time &ltime)
virtual bool get_date_result (type::Time &ltime, uint32_t fuzzydate)
virtual void update_null_value ()
virtual void top_level_item (void)
virtual void set_result_field (Field *field)
virtual bool is_result_field (void)
virtual bool is_bool_func (void)
virtual void save_in_result_field (bool no_conversions)
virtual void no_rows_in_result (void)
virtual Item * copy_or_same (Session *session)
virtual Item * copy_andor_structure (Session *session)
virtual Item * real_item (void)
virtual const Item * real_item (void) const
virtual Item * get_tmp_table_item (Session *session)
virtual const charset_info_st * compare_collation ()
virtual bool walk (Item_processor processor, bool walk_subquery, unsigned char *arg)
virtual Item * transform (Item_transformer transformer, unsigned char *arg)
virtual Item * compile (Item_analyzer analyzer, unsigned char **arg_p, Item_transformer transformer, unsigned char *arg_t)
virtual void traverse_cond (Cond_traverser traverser, void *arg, traverse_order order)
virtual bool remove_dependence_processor (unsigned char *arg)
virtual bool collect_item_field_processor (unsigned char *arg)
virtual bool find_item_in_field_list_processor (unsigned char *arg)
virtual bool change_context_processor (unsigned char *context)
virtual bool register_field_in_read_map (unsigned char *arg)
virtual bool subst_argument_checker (unsigned char **arg)
virtual bool cache_const_expr_analyzer (unsigned char **arg)
virtual Item * cache_const_expr_transformer (unsigned char *arg)
virtual Item * equal_fields_propagator (unsigned char *arg)
virtual bool set_no_const_sub (unsigned char *arg)
virtual Item * replace_equal_field (unsigned char *arg)
virtual uint32_t cols ()
virtual Item * element_index (uint32_t i)
virtual Item ** addr (uint32_t i)
virtual bool check_cols (uint32_t c)
virtual bool null_inside ()
virtual void bring_value ()
Field * tmp_table_field_from_field_type (Table *table, bool fixed_length)
virtual Item * neg_transformer (Session *session)
virtual Item * update_value_transformer (unsigned char *select_arg)
void delete_self ()
virtual bool result_as_int64_t ()
bool is_datetime ()
virtual bool is_expensive ()
String * check_well_formed_result (String *str, bool send_error=0)
bool eq_by_collation (Item *item, bool binary_cmp, const charset_info_st *const cs)
uint32_t char_to_byte_length_safe (uint32_t char_length_arg, uint32_t mbmaxlen_arg)
uint32_t max_char_length () const
void fix_char_length (uint32_t max_char_length_arg)

Additional Inherited Members

Public Types inherited from drizzled::Item
enum  Type {
  FIELD_ITEM = 0 , FUNC_ITEM , SUM_FUNC_ITEM , STRING_ITEM ,
  INT_ITEM , REAL_ITEM , NULL_ITEM , VARBIN_ITEM ,
  COPY_STR_ITEM , FIELD_AVG_ITEM , DEFAULT_VALUE_ITEM , PROC_ITEM ,
  COND_ITEM , REF_ITEM , FIELD_STD_ITEM , FIELD_VARIANCE_ITEM ,
  INSERT_VALUE_ITEM , SUBSELECT_ITEM , ROW_ITEM , CACHE_ITEM ,
  TYPE_HOLDER , PARAM_ITEM , BOOLEAN_ITEM , DECIMAL_ITEM
}
enum  traverse_order { T_POSTFIX , T_PREFIX }
enum  cond_result { COND_UNDEF , COND_OK , COND_TRUE , COND_FALSE }
Static Public Member Functions inherited from drizzled::Item
static const charset_info_st * default_charset ()
Static Public Member Functions inherited from drizzled::memory::SqlAlloc
static void * operator new (size_t size)
static void * operator new[] (size_t size)
static void * operator new (size_t size, Root &root)
static void * operator new[] (size_t size, Root &root)
static void * operator new (size_t size, Root *root)
static void * operator new[] (size_t size, Root *root)
static void operator delete (void *)
static void operator delete[] (void *)
static void operator delete (void *, Root &)
static void operator delete[] (void *, Root &)
static void operator delete (void *, Root *)
static void operator delete[] (void *, Root *)
Public Attributes inherited from drizzled::Item
String str_value
const char * name
uint32_t name_length
Item * next
uint32_t max_length
int8_t marker
uint8_t decimals
bool fixed
bool maybe_null
bool null_value
bool unsigned_flag
bool with_sum_func
bool is_autogenerated_name
bool with_subselect
DTCollation collation
Item_result cmp_context
Protected Member Functions inherited from drizzled::Item
Session & getSession ()

Detailed Description

Definition at line 27 of file item/null.h.

Constructor & Destructor Documentation

◆ Item_null()

drizzled::Item_null::Item_null ( const char * name_par = 0)
inline

Definition at line 31 of file item/null.h.

Member Function Documentation

◆ basic_const_item()

bool drizzled::Item_null::basic_const_item ( ) const
inlinevirtual

Returns true if this is a simple constant item like an integer, not a constant expression. Used in the optimizer to propagate basic constants.

Reimplemented from drizzled::Item.

Definition at line 50 of file item/null.h.

◆ clone_item()

Item * drizzled::Item_null::clone_item ( )
inlinevirtual

Reimplemented from drizzled::Item.

Definition at line 51 of file item/null.h.

◆ eq()

bool drizzled::Item_null::eq ( const Item * item,
bool binary_cmp ) const
virtual

Compares this Item to another Item, returning true if Item's are functionally equal.

This function is called when:

  • Comparing items in the WHERE clause (when doing where optimization)
  • When trying to find an order_st BY/GROUP BY item in the SELECT part

Reimplemented from drizzled::Item.

Definition at line 29 of file item/null.cc.

◆ field_type()

enum_field_types drizzled::Item_null::field_type ( ) const
inlinevirtual

Reimplemented from drizzled::Item.

Definition at line 49 of file item/null.h.

◆ is_null()

bool drizzled::Item_null::is_null ( )
inlinevirtual

The method allows to determine nullness of a complex expression without fully evaluating it, instead of calling val/result*() then checking null_value. Used in Item_func_isnull/Item_func_isnotnull and Item_sum_count/Item_sum_count_distinct. Any new item which can be NULL must implement this method.

Reimplemented from drizzled::Item.

Definition at line 52 of file item/null.h.

◆ print()

void drizzled::Item_null::print ( String * str)
virtual

This method is used for to:

  • to generate a view definition query (SELECT-statement);
  • to generate a SQL-query for EXPLAIN EXTENDED;
  • to generate a SQL-query to be shown in INFORMATION_SCHEMA;
  • debug.

For more information about view definition query, INFORMATION_SCHEMA query and why they should be generated from the Item-tree,

See also
register_view().

Reimplemented from drizzled::Item.

Definition at line 61 of file item/null.cc.

◆ result_type()

enum Item_result drizzled::Item_null::result_type ( ) const
inlinevirtual

Reimplemented from drizzled::Item.

Definition at line 48 of file item/null.h.

◆ safe_charset_converter()

Item * drizzled::Item_null::safe_charset_converter ( const charset_info_st *const tocs)
virtual

Reimplemented from drizzled::Item.

Definition at line 67 of file item/null.cc.

◆ save_in_field()

int drizzled::Item_null::save_in_field ( Field * field,
bool no_conversions )
virtual

Store null in field.

This is used on INSERT. Allow NULL to be inserted in timestamp and auto_increment values.

Parameters
fieldField where we want to store NULL
Return values
0ok
1Field doesn't support NULL values and can't handle 'field = NULL'

Reimplemented from drizzled::Item.

Definition at line 87 of file item/null.cc.

◆ save_safe_in_field()

int drizzled::Item_null::save_safe_in_field ( Field * field)
virtual

Store null in field.

Parameters
fieldField where we want to store NULL
Return values
0OK
1Field doesn't support NULL values

Reimplemented from drizzled::Item.

Definition at line 103 of file item/null.cc.

◆ send()

void drizzled::Item_null::send ( plugin::Client * client,
String * str )
virtual

Pack data in buffer for sending.

Reimplemented from drizzled::Item.

Definition at line 112 of file item/null.cc.

◆ type()

Type drizzled::Item_null::type ( ) const
inlinevirtual

Implements drizzled::Item.

Definition at line 39 of file item/null.h.

◆ val_decimal()

type::Decimal * drizzled::Item_null::val_decimal ( type::Decimal * decimal_buffer)
virtual

Return decimal representation of item with fixed point.

Parameters
bufferwhich 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 values
Returnpointer on type::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.

Implements drizzled::Item.

Definition at line 55 of file item/null.cc.

◆ val_int()

int64_t drizzled::Item_null::val_int ( )
virtual

Returns integer representation of item.

Return values
Incase 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.

Implements drizzled::Item.

Definition at line 39 of file item/null.cc.

◆ val_real()

double drizzled::Item_null::val_real ( )
virtual

Returns double precision floating point representation of item.

Return values
Incase 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.

Implements drizzled::Item.

Definition at line 32 of file item/null.cc.

◆ val_str()

String * drizzled::Item_null::val_str ( String * str)
virtual

Return string representation of this item object.

Parameters
anallocated 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 values
Incase 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.

Implements drizzled::Item.

Definition at line 47 of file item/null.cc.


The documentation for this class was generated from the following files: