sqlanywhere 0.1.6-x86-mingw32

data/ext/sacapidll.c

@@ -0,0 +1,182 @@
+//====================================================
+//
+//      Copyright 2008-2010 iAnywhere Solutions, Inc.
+//
+//   Licensed under the Apache License, Version 2.0 (the "License");
+//   you may not use this file except in compliance with the License.
+//   You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+//   Unless required by applicable law or agreed to in writing, software
+//   distributed under the License is distributed on an "AS IS" BASIS,
+//   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+//   See the License for the specific language governing permissions and
+//   limitations under the License.
+//
+//   While not a requirement of the license, if you do modify this file, we
+//   would appreciate hearing about it. Please email
+//   sqlany_interfaces@sybase.com
+//
+//====================================================
+#include <string.h>
+#include <stdlib.h>
+#include <stdio.h>
+
+#if defined( _WIN32 )
+    #include <windows.h>
+    #define DEFAULT_LIBRARY_NAME "dbcapi.dll"
+#else
+    #include <dlfcn.h>
+    /* assume we are running on a UNIX platform */
+    #if defined( __APPLE__ )
+	#define LIB_EXT "dylib"
+    #else
+	#define LIB_EXT "so"
+    #endif
+    #if defined( _REENTRANT ) || defined( _THREAD_SAFE ) \
+	|| defined( __USE_REENTRANT )
+    /* if building a thread-safe library, we need to load 
+       the thread-safe dbcapi library */
+	#define DEFAULT_LIBRARY_NAME "libdbcapi_r." LIB_EXT
+    #else
+	#define DEFAULT_LIBRARY_NAME "libdbcapi." LIB_EXT
+    #endif
+#endif
+
+#include "sacapidll.h"
+
+static 
+void * loadLibrary( const char * name )
+/*************************************/
+{
+    void * handle;
+#if defined( _WIN32 )
+    handle = LoadLibrary( name );
+#else
+    handle = dlopen( name, RTLD_LAZY );
+#endif
+    return handle;
+}
+
+static 
+void unloadLibrary( void * handle )
+/**********************************/
+{
+#if defined( _WIN32 )
+    FreeLibrary( handle );
+#else
+    dlclose( handle );
+#endif
+}
+
+static 
+void * findSymbol( void * dll_handle, char * name )
+/**************************************************/
+{
+#if defined( _WIN32 )
+    return GetProcAddress( dll_handle, name );
+#else
+    return dlsym( dll_handle, name );
+#endif
+}
+
+#define LookupSymbol( api, sym )					\
+	api->sym = (sym ## _func)findSymbol( api->dll_handle, #sym );
+
+#define LookupSymbolAndCheck( api, sym )				\
+	api->sym = (sym ## _func)findSymbol( api->dll_handle, #sym );	\
+	if( api->sym == NULL ) {					\
+	    unloadLibrary( api->dll_handle );				\
+	    return 0;							\
+	}
+	
+int sqlany_initialize_interface( SQLAnywhereInterface * api, const char * path )
+/*******************************************************************************/
+{
+    char * env;
+    memset( api, 0, sizeof(*api));
+
+    if( path != NULL ) {
+	api->dll_handle = loadLibrary( path );
+	if( api->dll_handle != NULL ) {
+	    goto loaded;
+	}
+    }
+    env = getenv( "SQLANY_API_DLL" );
+    if( env != NULL ) {
+	api->dll_handle = loadLibrary( env );
+	if( api->dll_handle != NULL ) {
+	    goto loaded;
+	}
+    }
+    api->dll_handle = loadLibrary( DEFAULT_LIBRARY_NAME );
+    if( api->dll_handle != NULL ) {
+	goto loaded;
+    }
+    return 0;
+
+loaded:
+    LookupSymbolAndCheck( api, sqlany_init );
+    LookupSymbolAndCheck( api, sqlany_fini );
+    LookupSymbolAndCheck( api, sqlany_new_connection );
+    LookupSymbolAndCheck( api, sqlany_free_connection );
+    LookupSymbolAndCheck( api, sqlany_make_connection );
+    LookupSymbolAndCheck( api, sqlany_connect );
+    LookupSymbolAndCheck( api, sqlany_disconnect );
+    LookupSymbolAndCheck( api, sqlany_execute_immediate );
+    LookupSymbolAndCheck( api, sqlany_prepare );
+    LookupSymbolAndCheck( api, sqlany_free_stmt );
+    LookupSymbolAndCheck( api, sqlany_num_params );
+    LookupSymbolAndCheck( api, sqlany_describe_bind_param );
+    LookupSymbolAndCheck( api, sqlany_bind_param );
+    LookupSymbolAndCheck( api, sqlany_send_param_data );
+    LookupSymbolAndCheck( api, sqlany_reset );
+    LookupSymbolAndCheck( api, sqlany_get_bind_param_info );
+    LookupSymbolAndCheck( api, sqlany_execute );
+    LookupSymbolAndCheck( api, sqlany_execute_direct );
+    LookupSymbolAndCheck( api, sqlany_fetch_absolute );
+    LookupSymbolAndCheck( api, sqlany_fetch_next );
+    LookupSymbolAndCheck( api, sqlany_get_next_result );
+    LookupSymbolAndCheck( api, sqlany_affected_rows );
+    LookupSymbolAndCheck( api, sqlany_num_cols );
+    LookupSymbolAndCheck( api, sqlany_num_rows );
+    LookupSymbolAndCheck( api, sqlany_get_column );
+    LookupSymbolAndCheck( api, sqlany_get_data );
+    LookupSymbolAndCheck( api, sqlany_get_data_info );
+    LookupSymbolAndCheck( api, sqlany_get_column_info );
+    LookupSymbolAndCheck( api, sqlany_commit );
+    LookupSymbolAndCheck( api, sqlany_rollback );
+    LookupSymbolAndCheck( api, sqlany_client_version );
+    LookupSymbolAndCheck( api, sqlany_error );
+    LookupSymbolAndCheck( api, sqlany_sqlstate );
+    LookupSymbolAndCheck( api, sqlany_clear_error );
+
+#if _SACAPI_VERSION+0 >= 2
+    /* We don't report an error if we don't find the v2 entry points.
+       That allows the calling app to revert to v1 */
+    LookupSymbol( api, sqlany_init_ex );
+    LookupSymbol( api, sqlany_fini_ex );
+    LookupSymbol( api, sqlany_new_connection_ex );
+    LookupSymbol( api, sqlany_make_connection_ex );
+    LookupSymbol( api, sqlany_client_version_ex );
+    LookupSymbolAndCheck( api, sqlany_cancel );
+#endif
+
+    api->initialized = 1;
+    return 1;
+}
+#undef LookupSymbolAndCheck
+
+void sqlany_finalize_interface( SQLAnywhereInterface * api )
+/***********************************************************/
+{
+    if( !api->initialized ) {
+	return;
+    }
+    unloadLibrary( api->dll_handle );
+    memset( api, 0, sizeof(*api));
+}
+
+

data/ext/sacapidll.h

@@ -0,0 +1,332 @@
+/* ====================================================
+ * 
+ *       Copyright 2008-2010 iAnywhere Solutions, Inc.
+ * 
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ * 
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * 
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ * 
+ *    While not a requirement of the license, if you do modify this file, we
+ *    would appreciate hearing about it. Please email
+ *    sqlany_interfaces@sybase.com
+ * 
+ * ====================================================
+ */
+
+#ifndef SACAPIDLL_H
+#define SACAPIDLL_H
+
+#include "sacapi.h"
+
+/** \file sacapidll.h
+ * \brief Header file for stub that can dynamically load the main API DLL.
+ * The user will need to include sacapidll.h in their source files and compile in sacapidll.c
+ */
+
+
+#if defined( __cplusplus )
+extern "C" {
+#endif
+typedef sacapi_bool (*sqlany_init_func)( const char * app_name, sacapi_u32 api_version, sacapi_u32 * max_version );
+typedef void (*sqlany_fini_func)();
+typedef a_sqlany_connection * (*sqlany_new_connection_func)( );
+typedef void (*sqlany_free_connection_func)( a_sqlany_connection *sqlany_conn );
+typedef a_sqlany_connection * (*sqlany_make_connection_func)( void * arg );
+typedef sacapi_bool (*sqlany_connect_func)( a_sqlany_connection * sqlany_conn, const char * str );
+typedef sacapi_bool (*sqlany_disconnect_func)( a_sqlany_connection * sqlany_conn );
+typedef sacapi_bool (*sqlany_execute_immediate_func)( a_sqlany_connection * sqlany_conn, const char * sql );
+typedef a_sqlany_stmt * (*sqlany_prepare_func)( a_sqlany_connection * sqlany_conn, const char * sql_str );
+typedef void (*sqlany_free_stmt_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_i32 (*sqlany_num_params_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_bool (*sqlany_describe_bind_param_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 index, a_sqlany_bind_param * params );
+typedef sacapi_bool (*sqlany_bind_param_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 index, a_sqlany_bind_param * params );
+typedef sacapi_bool (*sqlany_send_param_data_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 index, char * buffer, size_t size );
+typedef sacapi_bool (*sqlany_reset_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_bool (*sqlany_get_bind_param_info_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 index, a_sqlany_bind_param_info * info );
+typedef sacapi_bool (*sqlany_execute_func)( a_sqlany_stmt * sqlany_stmt );
+typedef a_sqlany_stmt * (*sqlany_execute_direct_func)( a_sqlany_connection * sqlany_conn, const char * sql_str );
+typedef sacapi_bool (*sqlany_fetch_absolute_func)( a_sqlany_stmt * sqlany_result, sacapi_i32 row_num );
+typedef sacapi_bool (*sqlany_fetch_next_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_bool (*sqlany_get_next_result_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_i32 (*sqlany_affected_rows_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_i32 (*sqlany_num_cols_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_i32 (*sqlany_num_rows_func)( a_sqlany_stmt * sqlany_stmt );
+typedef sacapi_bool (*sqlany_get_column_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 col_index, a_sqlany_data_value * buffer );
+typedef sacapi_i32 (*sqlany_get_data_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 col_index, size_t offset, void * buffer, size_t size );
+typedef sacapi_bool (*sqlany_get_data_info_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 col_index, a_sqlany_data_info * buffer );
+typedef sacapi_bool (*sqlany_get_column_info_func)( a_sqlany_stmt * sqlany_stmt, sacapi_u32 col_index, a_sqlany_column_info * buffer );
+typedef sacapi_bool (*sqlany_commit_func)( a_sqlany_connection * sqlany_conn );
+typedef sacapi_bool (*sqlany_rollback_func)( a_sqlany_connection * sqlany_conn );
+typedef sacapi_bool (*sqlany_client_version_func)( char * buffer, size_t len );
+typedef sacapi_i32 (*sqlany_error_func)( a_sqlany_connection * sqlany_conn, char * buffer, size_t size );
+typedef size_t (*sqlany_sqlstate_func)( a_sqlany_connection * sqlany_conn, char * buffer, size_t size );
+typedef void (*sqlany_clear_error_func)( a_sqlany_connection * sqlany_conn );
+#if _SACAPI_VERSION+0 >= 2
+    typedef a_sqlany_interface_context *(*sqlany_init_ex_func)( const char *app_name, sacapi_u32 api_version, sacapi_u32 *max_version );
+    typedef void (*sqlany_fini_ex_func)( a_sqlany_interface_context *context );
+    typedef a_sqlany_connection *(*sqlany_new_connection_ex_func)( a_sqlany_interface_context *context );
+    typedef a_sqlany_connection *(*sqlany_make_connection_ex_func)( a_sqlany_interface_context *context, void *arg );
+    typedef sacapi_bool (*sqlany_client_version_ex_func)( a_sqlany_interface_context *context, char *buffer, size_t len );
+    typedef void (*sqlany_cancel_func)( a_sqlany_connection * sqlany_conn );
+#endif
+
+#if defined( __cplusplus )
+}
+#endif
+
+/// @internal
+#define function( x ) 	x ## _func x
+
+/** The SQL Anywhere C API interface structure.
+ *
+ * Only one instance of this structure is required in your application environment.  This structure
+ * is initialized by the sqlany_initialize_interface method.   It attempts to load the SQL Anywhere C
+ * API DLL or shared object dynamically and looks up all the entry points of the DLL.  The fields in
+ * the SQLAnywhereInterface structure is populated to point to the corresponding functions in the DLL.
+ * \sa sqlany_initialize_interface()
+ */
+typedef struct SQLAnywhereInterface {
+    /** DLL handle.
+     */
+    void	* dll_handle;			
+
+    /** Flag to know if initialized or not.
+     */
+    int		  initialized;			
+
+    /** Pointer to ::sqlany_init() function.
+     */
+    function( sqlany_init );		
+
+    /** Pointer to ::sqlany_fini() function.
+     */
+    function( sqlany_fini );			
+
+    /** Pointer to ::sqlany_new_connection() function.
+     */
+    function( sqlany_new_connection );		
+
+    /** Pointer to ::sqlany_free_connection() function.
+     */
+    function( sqlany_free_connection );		
+
+    /** Pointer to ::sqlany_make_connection() function.
+     */
+    function( sqlany_make_connection );		
+
+    /** Pointer to ::sqlany_connect() function.
+     */
+    function( sqlany_connect );			
+
+    /** Pointer to ::sqlany_disconnect() function.
+     */
+    function( sqlany_disconnect );		
+
+    /** Pointer to ::sqlany_execute_immediate() function.
+     */
+    function( sqlany_execute_immediate );	
+
+    /** Pointer to ::sqlany_prepare() function.
+     */
+    function( sqlany_prepare );			
+
+    /** Pointer to ::sqlany_free_stmt() function.
+     */
+    function( sqlany_free_stmt );		
+
+    /** Pointer to ::sqlany_num_params() function.
+     */
+    function( sqlany_num_params );		
+
+    /** Pointer to ::sqlany_describe_bind_param() function.
+     */
+    function( sqlany_describe_bind_param );		
+
+    /** Pointer to ::sqlany_bind_param() function.
+     */
+    function( sqlany_bind_param );	
+
+    /** Pointer to ::sqlany_send_param_data() function.
+     */
+    function( sqlany_send_param_data );		
+
+    /** Pointer to ::sqlany_reset() function.
+     */
+    function( sqlany_reset );		
+
+    /** Pointer to ::sqlany_get_bind_param_info() function.
+     */
+    function( sqlany_get_bind_param_info );		
+
+    /** Pointer to ::sqlany_execute() function.
+     */
+    function( sqlany_execute );			
+
+    /** Pointer to ::sqlany_execute_direct() function.
+     */
+    function( sqlany_execute_direct );		
+
+    /** Pointer to ::sqlany_fetch_absolute() function.
+     */
+    function( sqlany_fetch_absolute );		
+
+    /** Pointer to ::sqlany_fetch_next() function.
+     */
+    function( sqlany_fetch_next );		
+
+    /** Pointer to ::sqlany_get_next_result() function.
+     */
+    function( sqlany_get_next_result );		
+
+    /** Pointer to ::sqlany_affected_rows() function.
+     */
+    function( sqlany_affected_rows );		
+
+    /** Pointer to ::sqlany_num_cols() function.
+     */
+    function( sqlany_num_cols );		
+
+    /** Pointer to ::sqlany_num_rows() function.
+     */
+    function( sqlany_num_rows );		
+
+    /** Pointer to ::sqlany_get_column() function.
+     */
+    function( sqlany_get_column );		
+
+    /** Pointer to ::sqlany_get_data() function.
+     */
+    function( sqlany_get_data );		
+
+    /** Pointer to ::sqlany_get_data_info() function.
+     */
+    function( sqlany_get_data_info );		
+
+    /** Pointer to ::sqlany_get_column_info() function.
+     */
+    function( sqlany_get_column_info );		
+
+    /** Pointer to ::sqlany_commit() function.
+     */
+    function( sqlany_commit );			
+
+    /** Pointer to ::sqlany_rollback() function.
+     */
+    function( sqlany_rollback );		
+
+    /** Pointer to ::sqlany_client_version() function.
+     */
+    function( sqlany_client_version );		
+
+    /** Pointer to ::sqlany_error() function.
+     */
+    function( sqlany_error );			
+
+    /** Pointer to ::sqlany_sqlstate() function.
+     */
+    function( sqlany_sqlstate );			
+
+    /** Pointer to ::sqlany_clear_error() function.
+     */
+    function( sqlany_clear_error );		
+
+#if _SACAPI_VERSION+0 >= 2
+    /** Pointer to ::sqlany_init_ex() function.
+     */
+    function( sqlany_init_ex );
+
+    /** Pointer to ::sqlany_fini_ex() function.
+     */
+    function( sqlany_fini_ex );
+
+    /** Pointer to ::sqlany_new_connection_ex() function.
+     */
+    function( sqlany_new_connection_ex );
+
+    /** Pointer to ::sqlany_make_connection_ex() function.
+     */
+    function( sqlany_make_connection_ex );
+
+    /** Pointer to ::sqlany_client_version_ex() function.
+     */
+    function( sqlany_client_version_ex );
+
+    /** Pointer to ::sqlany_cancel() function.
+     */
+    function( sqlany_cancel );		
+#endif
+
+} SQLAnywhereInterface;
+#undef function
+
+/** Initializes the SQLAnywhereInterface object and loads the DLL dynamically.
+ *
+ * Use the following statement to include the function prototype:
+ * 
+ * <pre>
+ * \#include "sacapidll.h"
+ * </pre>
+ *
+ * This function attempts to load the SQL Anywhere C API DLL dynamically and looks up all
+ * the entry points of the DLL. The fields in the SQLAnywhereInterface structure are
+ * populated to point to the corresponding functions in the DLL. If the optional path argument
+ * is NULL, the environment variable SQLANY_DLL_PATH is checked. If the variable is set, 
+ * the library attempts to load the DLL specified by the environment variable. If that fails,
+ * the interface attempts to load the DLL directly (this relies on the environment being
+ * setup correctly).
+ *
+ * To view examples of the sqlany_initialize_interface method in use, see the following topics:
+ *
+ * <ul>
+ * <li>\salink{connecting.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-connecting-cpp.html", "programming", "pg-c-api-connecting-cpp"} 
+ * <li>\salink{dbcapi_isql.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-dbcapi-isql-cpp.html", "programming", "pg-c-api-dbcapi-isql-cpp"}
+ * <li>\salink{fetching_a_result_set.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-fetching-a-result-set-cpp.html", "programming", "pg-c-api-fetching-a-result-set-cpp"}
+ * <li>\salink{fetching_multiple_from_sp.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-fetching-multiple-from-sp-cpp.html", "programming", "pg-c-api-fetching-multiple-from-sp-cpp"}
+ * <li>\salink{preparing_statements.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-preparing-statements-cpp.html", "programming", "pg-c-api-preparing-statements-cpp"}
+ * <li>\salink{send_retrieve_full_blob.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-send-retrieve-full-blob-cpp.html", "programming", "pg-c-api-send-retrieve-full-blob-cpp"}
+ * <li>\salink{send_retrieve_part_blob.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-send-retrieve-part-blob-cpp.html", "programming", "pg-c-api-send-retrieve-part-blob-cpp"}
+ * </ul>
+ *
+ * \param api An API structure to initialize.
+ * \param optional_path_to_dll An optional argument that specifies a path to the SQL Anywhere C API DLL.
+ * \return 1 on successful initialization, and 0 on failure.
+ */
+int sqlany_initialize_interface( SQLAnywhereInterface * api, const char * optional_path_to_dll );
+
+/** Unloads the C API DLL library and uninitializes the SQLAnywhereInterface structure.
+ *
+ * Use the following statement to include the function prototype:
+ * 
+ * <pre>
+ * \#include "sacapidll.h"
+ * </pre>
+ *
+ * Use this method to finalize and free resources associated with the SQL Anywhere C API DLL.
+ *
+ * To view examples of the sqlany_finalize_interface method in use, see the following topics:
+ *
+ * <ul>
+ * <li>\salink{connecting.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-connecting-cpp.html", "programming", "pg-c-api-connecting-cpp"} 
+ * <li>\salink{dbcapi_isql.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-dbcapi-isql-cpp.html", "programming", "pg-c-api-dbcapi-isql-cpp"}
+ * <li>\salink{fetching_a_result_set.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-fetching-a-result-set-cpp.html", "programming", "pg-c-api-fetching-a-result-set-cpp"}
+ * <li>\salink{fetching_multiple_from_sp.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-fetching-multiple-from-sp-cpp.html", "programming", "pg-c-api-fetching-multiple-from-sp-cpp"}
+ * <li>\salink{preparing_statements.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-preparing-statements-cpp.html", "programming", "pg-c-api-preparing-statements-cpp"}
+ * <li>\salink{send_retrieve_full_blob.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-send-retrieve-full-blob-cpp.html", "programming", "pg-c-api-send-retrieve-full-blob-cpp"}
+ * <li>\salink{send_retrieve_part_blob.cpp, "http://dcx.sybase.com/1200en/dbprogramming/pg-c-api-send-retrieve-part-blob-cpp.html", "programming", "pg-c-api-send-retrieve-part-blob-cpp"}
+ * </ul>
+ *
+ * \param api An initialized structure to finalize.
+ */
+
+void sqlany_finalize_interface( SQLAnywhereInterface * api );
+
+#endif