Importante
This C++ SDK uses outdated technology that limits your extension opportunities. We've built a new Platform SDK using Python and the latest open-source technology to deliver a vastly improved development experience. Go to Platform SDK to get started!
The FieldBase
class represents a field within a record and is obtained through the RecordInfo
class.
m_bIsVarLength
: Evaluates If the field is of variable length. Returns True if the field's length is variable.
m_ft
: The field type. Valid values include:
E_FT_Unknown
E_FT_Bool
E_FT_Byte
E_FT_Int16
E_FT_Int32
E_FT_Int64
E_FT_FixedDecimal
E_FT_Float
E_FT_Double
E_FT_String
E_FT_WString
E_FT_V_String
E_FT_V_WString
E_FT_Date
E_FT_Time
E_FT_DateTime
E_FT_Blob
E_FT_SpatialObj
m_nScale: The degrees of precision after a decimal point for numeric values.
m_nSize: The field's size in bytes.
==
: Evaluate if two instances of FieldBase are the same. Returns True if instances are identical.
!=
: Evaluate if two instances of FieldBase are not the same. Returns True if instances are not identical.
[]
: Return the FieldBase object that represents the field at the specified index. Use the syntax below, where n is the index.
const FieldBase * operator [](size_t n)
Create an exact copy of a FieldBase instance. Returns a smart pointer to the duplicate object.
SmartPointerRefObj<FieldBase> Copy()
Evaluate if two FieldBase instances are identical except for names. Returns True if the objects are the same except for names.
bool EqualType(const FieldBase &o)
o
: A reference to the object being compared against.
Obtain the value of the field as an 8-bit string. Returns the string value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<AString> GetAsAString(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a binary blob. Returns the blob value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<BlobVal> GetAsBlob(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a boolean. Returns the boolean value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<bool> GetAsBool(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a double. Returns the double value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<double> GetAsDouble(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a 32-bit integer. Returns the integer value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<int> GetAsInt32(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a 64-bit integer. Returns the integer value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<__int64> GetAsInt64(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a spatial blob. Returns the spatial blob value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<BlobVal> GetAsSpatialBlob(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the value of the field as a 16-bit string value. Returns the string value wrapped in a TFieldVal structure to handle Null values.
TFieldVal<WString> GetAsWString(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the description associated with a field. Returns the description.
WString GetDescription()
Obtain the name of the field. Returns the name.
WStringNoCase GetFieldName()
GetGenericEngine
Obtain the generic Alteryxengine assigned to this object. Returns a pointer to the generic Alteryxengine.
GenericEngineBase * GetGenericEngine()
The most commonly used generic engine is GenericEngine_Alteryx
, which provides a base-line set of functionality.
Evaluate if the field contains a Null value. Returns True if the field contains a Null.
bool GetNull(const RecordData * pRecord)
pRecord
: A pointer to the RecordData structure that contains the data.
Obtain the name of the source of the field, such as the file name or the tool that created the field. Returns the name.
WString GetSource()
Evaluate if the Generic Engine associated with the object can report field conversion errors. Returns True if the object can report field conversion errors.
bool IsReportingFieldConversionErrors()
Notify the Alteryxengine that a field conversion error has occurred. Returns the text of the reported error message.
void ReportFieldConversionError(const wchar_t *pMessage)
The Alteryxengine issues a message with the TCallbackMessage
with a status type of 4
.
Set the field's description.
void SetDescription(WString strDescription)
strDescription
: The description being added.
Set a field's value to that from a specified binary blob value.
void SetFromBlob(Record *pRecord, BlobVal & val)
pRecord
: A pointer to the Record structure that is receiving the data.
val
: The value the field is set to.
Set a field's value to that from a specified boolean value.
void SetFromBool(Record *pRecord, bool bVal)
pRecord
: A pointer to the Record structure that is receiving the data.
bVal
: The value the field is set to.
Set a field's value to that from a specified double value.
void SetFromDouble(Record *pRecord, double dVal)
pRecord
: A pointer to the Record structure that is receiving the data.
dVal
: The value the field is set to.
Set a field's value to that from a specified 32-bit integer value.
void SetFromInt32(Record *pRecord, int nVal)
pRecord
: A pointer to the Record structure that is receiving the data.
nVal
: The value the field is set to.
Set a field's value to that from a specified 64-bit integer value.
void SetFromInt64(Record *pRecord, __int64 nVal)
pRecord
: A pointer to the Record structure that is receiving the data.
nVal
: The value the field is set to.
Set a field's value to that from a specified spatial blob value.
void SetFromSpatialBlob(Record *pRecord, BlobVal & val)
pRecord
: A pointer to the Record structure that is receiving the data.
val
: The value the field is set to.
Set a field's value to that from a specified 8-bit string value.
void SetFromString(Record *pRecord, const char * pVal, size_t nLen)
You can use the same method to set a field's value to that from a specified 16-bit string value.
void SetFromString(Record *pRecord, const wchar_t * pVal, size_t nLen)
pRecord
: A pointer to the Record structure that is receiving the data.
pVal
: The value the field is set to.
nLen
: The length of the string.
Set a field's value to Null.
void SetNull(const RecordData * pRecord)
pRecord
: A pointer to the Record structure that is being set to Null.
Set the source metadata for the field.
void SetSource(WString strSource)
You can also set the scope of the source. The scope cannot contain the character :.
void SetSource(WString strScope, WString strValue)
strScope
: The scope of the source.
strValue
: The source of the field.