sdaiAppend
Table 1 – Required value buffer depending on valueType (on the example of sdaiAppend but valid for all put-functions)
valueType C/C++ C#
sdaiINTEGER int_t val = 123; int_t val = 123;
sdaiAppend (aggr, sdaiINTEGER, &val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiINTEGER, ref val);
sdaiREAL or sdaiNUMBER double val = 123.456; double val = 123.456;
sdaiAppend (aggr, sdaiREAL, &val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiREAL, ref val);
sdaiBOOLEAN bool val = true; bool val = true;
sdaiAppend (aggr, sdaiBOOLEAN, &val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiBOOLEAN, ref val);
sdaiLOGICAL const TCHAR* val = "U"; string val = "U";
sdaiAppend (aggr, sdaiLOGICAL, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiLOGICAL, val);
sdaiENUM const TCHAR* val = "NOTDEFINED"; string val = "NOTDEFINED";
sdaiAppend (aggr, sdaiENUM, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiENUM, val);
sdaiBINARY const TCHAR* val = "0123456ABC"; string val = "0123456ABC";
sdaiAppend (aggr, sdaiBINARY, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiBINARY, val);
sdaiSTRING const char* val = "My Simple String"; string val = "My Simple String";
sdaiAppend (aggr, sdaiSTRING, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiSTRING, val);
sdaiUNICODE const wchar_t* val = L"Any Unicode String"; string val = "Any Unicode String";
sdaiAppend (aggr, sdaiUNICODE, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiUNICODE, val);
sdaiEXPRESSSTRING const char* val = "EXPRESS format, i.e. \\X2\\00FC\\X0\\"; string val = "EXPRESS format, i.e. \\X2\\00FC\\X0\\";
sdaiAppend (aggr, sdaiEXPRESSSTRING, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiEXPRESSSTRING, val);
sdaiINSTANCE SdaiInstance val = sdaiCreateInstanceBN (model, "IFCSITE"); int_t val = ifcengine.sdaiCreateInstanceBN (model, "IFCSITE");
sdaiAppend (aggr, sdaiINSTANCE, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiINSTANCE, val);
sdaiAGGR SdaiAggr val = sdaiCreateAggr (inst, 0); int_t val = sdaiCreateAggr (inst, 0);
sdaiAppend (val, sdaiINSTANCE, inst); ifcengine.sdaiAppend (val, ifcengine.sdaiINSTANCE, inst);
sdaiAppend (aggr, sdaiAGGR, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiAGGR, val);
sdaiADB int_t integerValue = 123; int_t integerValue = 123;
SdaiADB val = sdaiCreateADB (sdaiINTEGER, &integerValue); int_t val = ifcengine.sdaiCreateADB (ifcengine.sdaiINTEGER, ref integerValue);
sdaiPutADBTypePath (val, 1, "IFCINTEGER"); ifcengine.sdaiPutADBTypePath (val, 1, "IFCINTEGER");
sdaiAppend (aggr, sdaiADB, val); ifcengine.sdaiAppend (aggr, ifcengine.sdaiADB, val);
sdaiDeleteADB (val); ifcengine.sdaiDeleteADB (val);
TCHAR is “char” or “wchar_t” depending on setStringUnicode.
(Non-standard behavior) sdaiLOGICAL behaves differently from ISO 10303-24-2001: it expects char* while standard declares int_t
(Non-standard extension) sdiADB in C++ has an option to work without sdaiCreateEmptyADB and sdaiDeleteADB as shown in the table
Table 2 - valueType can be requested depending on actual model data.
valueType Works for following values in the model
integer real .T. or .F. .U. other enum binary string instance list $ (empty)
sdaiINTEGER Yes . . . . . . . . .
sdaiREAL . Yes . . . . . . . .
sdaiNUMBER . Yes . . . . . . . .
sdaiBOOLEAN . . Yes . . . . . . .
sdaiLOGICAL . . Yes Yes . . . . . .
sdaiENUM . . Yes Yes Yes . . . . .
sdaiBINARY . . . . . Yes . . . .
sdaiSTRING . . . . . . Yes . . .
sdaiUNICODE . . . . . . Yes . . .
sdaiEXPRESSSTRING . . . . . . Yes . . .
sdaiINSTANCE . . . . . . . Yes . .
sdaiAGGR . . . . . . . . Yes .
sdaiADB Yes Yes Yes Yes Yes Yes Yes Yes Yes .
Syntax
public const string ifcenginedll = @"ifcengine.dll"; [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, ref bool value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, ref int_t value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, int_t value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, ref double value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, ref IntPtr value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, byte[] value); [DllImport(IFCEngineDLL, EntryPoint = "sdaiAppend")] public static extern void sdaiAppend(int_t aggregate, int_t valueType, string value);
Property aggregate
Size: 64 bit / 8 byte (reference)Property valueType
Size: 64 bit / 8 byte (value)Property value
Size: 64 bit / 8 byte (reference)
Example (based on pure API calls)
Here you can find code snippits that show how the API call sdaiAppend can be used.
using RDF; // include at least engine.cs within your solution // // Created result when stored as IFC: // #31313 = IFCPOSTALADDRESS($, $, $, $, ('RDF Ltd.', 'Main Office'), '32', 'Bankya', 'Sofia', '1320', 'Bulgaria'); // Int64 ifcPostalAddressInstance = ifcengine.sdaiCreateInstanceBN(model, "IFCPOSTALADDRESS"); Int64 addressLines = ifcengine.sdaiCreateAggrBN(ifcPostalAddressInstance, "AddressLines"); ifcengine.sdaiAppend(addressLines, ifcengine.sdaiSTRING, "RDF Ltd."); ifcengine.sdaiAppend(addressLines, ifcengine.sdaiSTRING, "Main Office"); ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "PostalBox", ifcengine.sdaiSTRING, "32"); ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Town", ifcengine.sdaiSTRING, "Bankya"); ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Region", ifcengine.sdaiSTRING, "Sofia"); // It is allowed to mix sdaiUNICODE and sdaiSTRING ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "PostalCode", ifcengine.sdaiUNICODE, "1320"); // as long as each call is consitent in itself. ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Country", ifcengine.sdaiSTRING, "Bulgaria");