Bin MembersAerospike

The Bin type exposes the following members.
Constructors

  NameDescription
Public methodBin(String, Value)
Constructor, specifying bin name and value. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Boolean)
Constructor, specifying bin name and boolean value. The server will convert all bools to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Byte)
Constructor, specifying bin name and byte value. The server will convert all byte integers to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String,  Byte )
Constructor, specifying bin name and byte array value. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, IDictionary)
Create bin with a map value. The map value will be serialized as a Aerospike 3 server map type. Supported by Aerospike 3 servers only.

If connecting to Aerospike 2 servers, use the following instead:

Bin bin = new Bin(name, (Object)map);

For servers configured as "single-bin", enter a null or empty name.

Public methodBin(String, IList)
Create bin with a list value. The list value will be serialized as a Aerospike 3 server list type. Supported by Aerospike 3 servers only.

If connecting to Aerospike 2 servers, use the following instead:

Bin bin = new Bin(name, (Object)list);

For servers configured as "single-bin", enter a null or empty name.

Public methodBin(String, Double)
Constructor, specifying bin name and double value. Aerospike server versions >= 3.6.0 natively support floating point values. If your cluster supports floating point values, then this is always the correct constructor for double. Remember to also set UseDoubleType to true;

If your cluster does not support floating point, the value is converted to long bits. On reads, it's important to call GetDouble(String) to indicate that the long returned by the server should be converted back to a double. If the same bin name holds different types for different records, then this constructor should not be used because there is no way to know when reading if the long should be converted to a double. Instead, use Bin(String, Object) which converts the double to a C# serialized blob.

double value = 22.7;
Bin bin = new Bin("mybin", (Object) value);

This is slower and not portable to other languages, but the double type is preserved, so a double will be returned without knowing if a conversion should be made.

For servers configured as "single-bin", enter a null or empty name.

Public methodBin(String, Int16)
Constructor, specifying bin name and short value. The server will convert all shorts to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Int32)
Constructor, specifying bin name and integer value. The server will convert all integers to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Int64)
Constructor, specifying bin name and long value. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Object)
Constructor, specifying bin name and object value. This is the slowest of the Bin constructors because the type must be determined using multiple "instanceof" checks.

For servers configured as "single-bin", enter a null or empty name.

Public methodBin(String, SByte)
Constructor, specifying bin name and signed byte value. The server will convert all byte integers to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, Single)
Constructor, specifying bin name and float value. Aerospike server versions >= 3.6.0 natively support floating point values. If your cluster supports floating point values, then this is always the correct constructor for float. Remember to also set UseDoubleType to true;

If your cluster does not support floating point, the value is converted to long bits. On reads, it's important to call GetFloat(String) to indicate that the long returned by the server should be converted back to a float. If the same bin name holds different types for different records, then this constructor should not be used because there is no way to know when reading if the long should be converted to a float. Instead, use Bin(String, Object) which converts the float to a C# serialized blob.

float value = 22.7;
Bin bin = new Bin("mybin", (Object) value);

This is slower and not portable to other languages, but the float type is preserved, so a float will be returned without knowing if a conversion should be made.

For servers configured as "single-bin", enter a null or empty name.

Public methodBin(String, String)
Constructor, specifying bin name and string value. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, UInt16)
Constructor, specifying bin name and unsigned short value. The server will convert all shorts to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, UInt32)
Constructor, specifying bin name and unsigned integer value. The server will convert all integers to longs. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String, UInt64)
Constructor, specifying bin name and unsigned long value. For servers configured as "single-bin", enter a null or empty name.
Public methodBin(String,  Byte , Int32, Int32)
Constructor, specifying bin name and byte array segment value. For servers configured as "single-bin", enter a null or empty name.
Back to Top
Methods

  NameDescription
Public methodStatic memberAsBlob
Create bin with a blob value. The value will be java serialized. This method is faster than the bin Object constructor because the blob is converted directly instead of using multiple "instanceof" type checks with a blob default.

For servers configured as "single-bin", enter a null or empty name.

Public methodStatic memberAsListObsolete.
Create bin with a list value. The list value will be serialized as a Aerospike 3 server list type. Supported by Aerospike 3 servers only. For servers configured as "single-bin", enter a null or empty name.
Public methodStatic memberAsMapObsolete.
Create bin with a map value. The map value will be serialized as a Aerospike 3 server map type. Supported by Aerospike 3 servers only. For servers configured as "single-bin", enter a null or empty name.
Public methodStatic memberAsNull
Create bin with a null value. This is useful for bin deletions within a record. For servers configured as "single-bin", enter a null or empty name.
Public methodToString
Return string representation of bin.
(Overrides OnlineObject ToString .)
Back to Top
Fields

  NameDescription
Public fieldname
Bin name. Current limit is 14 characters.
Public fieldvalue
Bin value.
Back to Top
See Also