Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » UltraLite - C and C++ Programming » UltraLite C++ API Reference

IsNeverSynchronized function Next Page

ULValue class


Syntax

public ULValue

Remarks

ULValue class class.

The ULValue class class is a wrapper for the data types stored in an UltraLite cursor. This class allows you to store data without having to worry about the data type, and is used to pass values to and from the UltraLite C++ Component.

ULValue class contains many constructors and cast operators, so you can use ULValue class seamlessly (in most cases) without explicitly instantiating a ULValue class.

You can construct the object or assign it from any basic C++ data type. You can also cast it into any basic C++ data type.

   x( 5 );       ULValue// Example of ULValue's constructor
   y = 5;        ULValue// Example of ULValue's assignment operator
  int z = y;            // Example of ULValue's cast operator

This sample works for strings as well:

   x( UL_TEXT( ULValue"hello" ) );
   y = UL_TEXT( ULValue"hello" );
  y.( buffer, BUFFER_LEN );    GetString// NOTE, there is no cast operator

You do not need to explicitly construct a ULValue class object as the compiler does this automatically in many cases. For example, to fetch a value from a column, you can use the following:

  int x = table->Get( UL_TEXT( "my_column" ) );

The table->Get() call returns a ULValue class object. C++ automatically calls the cast operator in order to convert it to an integer. Similarly, the table->Get() call takes a ULValue class parameter as the column identifier. This determines which column to fetch. C++ automatically converts the "my_column" literal string into a ULValue class object.

Members

All members of ULValue, including all inherited members.


GetBinary function
GetBinary function
GetBinaryLength function
GetCombinedStringItem function
GetCombinedStringItem function
GetString function
GetString function
GetStringLength function
InDatabase function
IsNull function
SetBinary function
SetString function
SetString function
StringCompare function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
ULValue function
operator DECL_DATETIME function
operator bool function
operator double function
operator float function
operator int function
operator long function
operator short function
operator ul_s_big function
operator ul_u_big function
operator unsigned char function
operator unsigned int function
operator unsigned long function
operator unsigned short function
operator= function
~ULValue function