Utility functions generated by BladeSmith
BladeSmith generates utility functions that it calls from other generated code.
These functions include:
| Function name | Description |
|---|---|
| Gen_IsMMXMachine() | This function determines whether the database server is running on a computer with an Intel™ MMX processor. This function is only generated if you specify that you want MMX-enabled functions when you generate source code. See The Gen_IsMMXMachine() utility function for more information. |
| Gen_LoadLOFromFile() | When an opaque type includes a large object handle, BladeSmith includes this function to retrieve the large object data from a disk file. |
| Gen_nstrwords() | This function counts the number of values (each separated by a blank space) in a formatted string. This function is called from input and import functions to retrieve values from variable-length opaque types. |
| Gen_sscanf() | This function is called from input and import functions to convert text data to the C structure for an opaque type. See The Gen_sscanf() utility function for more information. |
| Gen_StoreLOToFile() | When an opaque type includes a large object handle, BladeSmith includes this function to write large object data to a disk file. |
| Gen_Trace() | This function processes trace messages and errors. This function is generally started by the macros DBDK_TRACE_ENTER(), DBDK_TRACE_EXIT(), DBDK_TRACE_MSG(), and DBDK_TRACE_ERROR(). See Tracing and error handling for more information. |
Most of the generated utility functions are called by code that BladeSmith generates, and you typically do not use them in your code. The Gen_sscanf() utility function, however, can be useful in your input/output functions. You can use the Gen_IsMMXMachine() function if you use Intel MMX instructions in your code.