dbd-sqlanywhere 0.1.2 → 1.0.0

data/CHANGELOG

@@ -1,12 +1,21 @@
-=CHANGE LOG
-
-=====0.1.1 -- 2008/11/06
-- Changed file permissions on archives
-- Changed archives to be specific to platform (.zip on windows, .tar.gz
-otherwise)
-- Removed the default rake task
-
-=====0.1.0 -- 2008/10/29
-- Initial Release
-- Wraps DBCAPI functionality
-- Tested against DBI 0.4
+=CHANGE LOG
+
+=====1.0.0 -- 2012/08/29
+- Changed to have each row element to be stored as String object by "default" so that dbh.convert_types = false would return the String element properly.
+- Changed sth.column_info not to assign any value "precision" and "scale" for the datatype that does not specify the precision or length.
+- Changed sth.rows to return proper value for the number of the affected rows
+- Changed rakefile to use rdoc/task instead of rake/rdoctask(deprecated)
+
+=====0.1.2 -- 2009/03/27
+- Changed the order and type of parameter for connection
+
+=====0.1.1 -- 2008/11/06
+- Changed file permissions on archives
+- Changed archives to be specific to platform (.zip on windows, .tar.gz
+otherwise)
+- Removed the default rake task
+
+=====0.1.0 -- 2008/10/29
+- Initial Release
+- Wraps DBCAPI functionality
+- Tested against DBI 0.4

data/LICENSE

@@ -1,23 +1,23 @@
-/*====================================================
-*
-*   Copyright 2008-2009 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
-*
-*
-*====================================================*/
+/*====================================================
+*
+*   Copyright 2012 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
+*
+*
+*====================================================*/

data/README

@@ -1,150 +1,150 @@
-=SQL Anywhere DBD Driver for Ruby-DBI
-
-This is a SQL Anywhere driver for Ruby DBI (http://ruby-dbi.rubyforge.org/). This driver requires the
-native SQL Anywhere Ruby driver. To get the native driver, use:
-
-   gem install sqlanywhere
-
-This driver is designed for use with DBI 0.4 and greater.
-
-This driver is licensed under the Apache License, Version 2.
-
-The official code repository is located on GitHub. The repository can be cloned with:
-
-   git clone git://github.com/sqlanywhere/dbd-sqlanywhere.git
-
-==Making a Connection
-
-The following code is a sample database configuration object that connects
-to a database called 'Test'.
-   
-  require 'dbi'
-  
-  DBI.connect('DBI:SQLAnywhere:Test') do | dbh |
-    if dbh.ping
-      print "Successfully Connected"
-    end
-  end
-
-The connection function takes the general form:
-
-  dbh = DBI.connect(DBNAME, [USER_NAME], [PASSWORD])
-
-The DBNAME string can be specified in the following forms:
-
-  "DBI:SQLAnywhere:"
-  "DBI:SQLAnywhere:{ENG}"
-  "DBI:SQLAnywhere:{ENG}:{DBN}"
-  "DBI:SQLAnywhere:{CONNECTION_STRING}"  # where CONNECTION_STRING ~= "key1=val1;key2=val2;..."
-
-For the first form, nothing will be added to the connection string. With the second and third forms
-the driver will add ENG and DBN to the connection string accordingly. The fourth form will pass
-the supplied connection string through unmolested.
-
-The USER_NAME and PASSWORD can be passed into the function and they will be automatically appended to the
-connection string. Since Ruby DBI will automatically fill in the username and password with defaults if they are omitted, 
-you should NEVER include a "UID=" or "PWD=" in your connection string or an exception will be thrown.
-
-Examples:  
-
-   Function Call                                              ==> Generated Connection String
-   ==============================================================================================
-   DBI.connect("DBI:SQLAnywhere:")                            ==>  "uid=dba;pwd=sql"
-   DBI.connect("DBI:SQLAnywhere:Demo")                        ==>  "eng=Demo;uid=dba;pwd=sql"
-   DBI.connect("DBI:SQLAnywhere:Demo:Test")                   ==>  "eng=Demo;dbn=Test;uid=dba;pwd=sql"
-   DBI.connect("DBI:SQLAnywhere:Demo:Test", 'john', 'doe')    ==>  "eng=Demo;dbn=Test;uid=john;pwd=doe"
-   DBI.connect("DBI:SQLAnywhere:eng=Demo;dbn=Test")           ==>  "eng=Demo;dbn=Test;uid=dba;pwd=sql"
-   DBI.connect("DBI:SQLAnywhere:eng=Demo;dbn=Test;uid=john")  ==>  EXCEPTION! UID cannot be specified in the connection string
-   DBI.connect("DBI:SQLAnywhere:CommLinks=tcpip(port=2638)")  ==>  "CommLinks=tcpip(port=2638);uid=dba;pwd=sql"
-
-
-==Running Test Suite
-
-For information on running the Ruby/DBI DBD Tests, please see
-
-   test/DBD_TESTS
-
-==Driver-Specific Features
-
-At the time of this writing, there was no standard way to handle INOUT and OUT parameters
-from stored procedures in DBI. 
-
-When binding to an OUT parameter, you must bind a hash that contains a key called
-:name. This :name will be used to retrieve the OUT value after execution. If the
-OUT column is of string or binary type, you must also pass a key called :length 
-with the expected maximum length of the OUT parameter.
-
-In the case of an INOUT parameter, the :name and :length keys are the same as for
-OUT parameters, but an additional :value parameter holds the value to be passed
-into the stored procedure.
-
-After execution, you can use the statement-specific function :bound_param
-to retrieve the output value using the :name supplied at binding time.
-
-===Example of using OUT and INOUT parameters
-      
-   # The result that should be printed to console is:
-   #  Complete string is PREFIX-some_string-SUFFIX and is 25 chars long
-   #  Complete string is PREFIXPREFIX-some_string-SUFFIXSUFFIX and is 37 chars long
-
-   require 'dbi'
-
-   begin
-   DBI.connect("DBI:SQLAnywhere:test") do |dbh|
-
-   sql = <<SQL
-   IF EXISTS(SELECT * FROM SYS.SYSPROCEDURE where proc_name = 'foo') THEN
-       DROP PROCEDURE foo;
-   END IF
-   SQL
-
-      dbh.do(sql);
-
-   sql = <<SQL
-   create procedure foo 
-   ( IN prefix char(10),
-     INOUT buffer varchar(256),
-     OUT str_len int,
-     IN suffix char(10) 
-   )
-   begin                                       
-       set buffer = prefix || buffer || suffix;
-       select length( buffer ) into str_len;   
-   end                                         
-   SQL
-
-      dbh.do(sql);
-      
-      buffer = "-some_string-"
-      prefix = "PREFIX"
-      
-      # preparing the statement
-      sth = dbh.prepare("call foo( ?, ?, ?, ? )")
-
-      # Binding buffer column as :buf, and str_len column as :len
-      # Note that we must supply a :value for :buf since it is an INOUT
-      # And we must supply a :length for :buf since it is a string column
-      sth.execute( prefix, {:name => :buf, :value => buffer, :length => 255}, {:name => :len}, "SUFFIX")
-
-      # Retrieve the OUT value from buffer
-      new_buffer = sth.func(:bound_param, :buf)
-
-      # Retrieve the OUT value from str_len
-      length = sth.func(:bound_param, :len)
-      puts "Complete string is #{new_buffer} and is #{length} chars long"
-
-      # Add the results back into the string, and re-execute
-      sth.execute("PREFIX", {:name => :buf, :value => new_buffer, :length => 255}, {:name => :len}, "SUFFIX")
-      new_buffer = sth.func(:bound_param, :buf)
-      length = sth.func(:bound_param, :len)
-      puts "Complete string is #{new_buffer} and is #{length} chars long"
-   end
-
-   rescue DBI::DatabaseError => e
-    puts "An error occurred"
-    puts "Error code: #{e.err}"
-    puts "Error message: #{e.errstr}"
-    puts "Error SQLSTATE: #{e.state}"
-   ensure
-       DBI.disconnect_all
-   end
+=SQL Anywhere DBD Driver for Ruby-DBI
+
+This is a SQL Anywhere driver for Ruby DBI (http://ruby-dbi.rubyforge.org/). This driver requires the
+native SQL Anywhere Ruby driver. To get the native driver, use:
+
+   gem install sqlanywhere
+
+This driver is designed for use with DBI 0.4 and greater.
+
+This driver is licensed under the Apache License, Version 2.
+
+The official code repository is located on GitHub. The repository can be cloned with:
+
+   git clone git://github.com/sqlanywhere/dbd-sqlanywhere.git
+
+==Making a Connection
+
+The following code is a sample database configuration object that connects
+to a database called 'Test'.
+   
+  require 'dbi'
+  
+  DBI.connect('DBI:SQLAnywhere:Test') do | dbh |
+    if dbh.ping
+      print "Successfully Connected"
+    end
+  end
+
+The connection function takes the general form:
+
+  dbh = DBI.connect(DBNAME, [USER_NAME], [PASSWORD])
+
+The DBNAME string can be specified in the following forms:
+
+  "DBI:SQLAnywhere:"
+  "DBI:SQLAnywhere:{ENG}"
+  "DBI:SQLAnywhere:{ENG}:{DBN}"
+  "DBI:SQLAnywhere:{CONNECTION_STRING}"  # where CONNECTION_STRING ~= "key1=val1;key2=val2;..."
+
+For the first form, nothing will be added to the connection string. With the second and third forms
+the driver will add ENG and DBN to the connection string accordingly. The fourth form will pass
+the supplied connection string through unmolested.
+
+The USER_NAME and PASSWORD can be passed into the function and they will be automatically appended to the
+connection string. Since Ruby DBI will automatically fill in the username and password with defaults if they are omitted, 
+you should NEVER include a "UID=" or "PWD=" in your connection string or an exception will be thrown.
+
+Examples:  
+
+   Function Call                                              ==> Generated Connection String
+   ==============================================================================================
+   DBI.connect("DBI:SQLAnywhere:")                            ==>  "uid=dba;pwd=sql"
+   DBI.connect("DBI:SQLAnywhere:Demo")                        ==>  "eng=Demo;uid=dba;pwd=sql"
+   DBI.connect("DBI:SQLAnywhere:Demo:Test")                   ==>  "eng=Demo;dbn=Test;uid=dba;pwd=sql"
+   DBI.connect("DBI:SQLAnywhere:Demo:Test", 'john', 'doe')    ==>  "eng=Demo;dbn=Test;uid=john;pwd=doe"
+   DBI.connect("DBI:SQLAnywhere:eng=Demo;dbn=Test")           ==>  "eng=Demo;dbn=Test;uid=dba;pwd=sql"
+   DBI.connect("DBI:SQLAnywhere:eng=Demo;dbn=Test;uid=john")  ==>  EXCEPTION! UID cannot be specified in the connection string
+   DBI.connect("DBI:SQLAnywhere:CommLinks=tcpip(port=2638)")  ==>  "CommLinks=tcpip(port=2638);uid=dba;pwd=sql"
+
+
+==Running Test Suite
+
+For information on running the Ruby/DBI DBD Tests, please see
+
+   test/DBD_TESTS
+
+==Driver-Specific Features
+
+At the time of this writing, there was no standard way to handle INOUT and OUT parameters
+from stored procedures in DBI. 
+
+When binding to an OUT parameter, you must bind a hash that contains a key called
+:name. This :name will be used to retrieve the OUT value after execution. If the
+OUT column is of string or binary type, you must also pass a key called :length 
+with the expected maximum length of the OUT parameter.
+
+In the case of an INOUT parameter, the :name and :length keys are the same as for
+OUT parameters, but an additional :value parameter holds the value to be passed
+into the stored procedure.
+
+After execution, you can use the statement-specific function :bound_param
+to retrieve the output value using the :name supplied at binding time.
+
+===Example of using OUT and INOUT parameters
+      
+   # The result that should be printed to console is:
+   #  Complete string is PREFIX-some_string-SUFFIX and is 25 chars long
+   #  Complete string is PREFIXPREFIX-some_string-SUFFIXSUFFIX and is 37 chars long
+
+   require 'dbi'
+
+   begin
+   DBI.connect("DBI:SQLAnywhere:test") do |dbh|
+
+   sql = <<SQL
+   IF EXISTS(SELECT * FROM SYS.SYSPROCEDURE where proc_name = 'foo') THEN
+       DROP PROCEDURE foo;
+   END IF
+   SQL
+
+      dbh.do(sql);
+
+   sql = <<SQL
+   create procedure foo 
+   ( IN prefix char(10),
+     INOUT buffer varchar(256),
+     OUT str_len int,
+     IN suffix char(10) 
+   )
+   begin                                       
+       set buffer = prefix || buffer || suffix;
+       select length( buffer ) into str_len;   
+   end                                         
+   SQL
+
+      dbh.do(sql);
+      
+      buffer = "-some_string-"
+      prefix = "PREFIX"
+      
+      # preparing the statement
+      sth = dbh.prepare("call foo( ?, ?, ?, ? )")
+
+      # Binding buffer column as :buf, and str_len column as :len
+      # Note that we must supply a :value for :buf since it is an INOUT
+      # And we must supply a :length for :buf since it is a string column
+      sth.execute( prefix, {:name => :buf, :value => buffer, :length => 255}, {:name => :len}, "SUFFIX")
+
+      # Retrieve the OUT value from buffer
+      new_buffer = sth.func(:bound_param, :buf)
+
+      # Retrieve the OUT value from str_len
+      length = sth.func(:bound_param, :len)
+      puts "Complete string is #{new_buffer} and is #{length} chars long"
+
+      # Add the results back into the string, and re-execute
+      sth.execute("PREFIX", {:name => :buf, :value => new_buffer, :length => 255}, {:name => :len}, "SUFFIX")
+      new_buffer = sth.func(:bound_param, :buf)
+      length = sth.func(:bound_param, :len)
+      puts "Complete string is #{new_buffer} and is #{length} chars long"
+   end
+
+   rescue DBI::DatabaseError => e
+    puts "An error occurred"
+    puts "Error code: #{e.err}"
+    puts "Error message: #{e.errstr}"
+    puts "Error SQLSTATE: #{e.state}"
+   ensure
+       DBI.disconnect_all
+   end

data/lib/dbd/SQLAnywhere.rb

@@ -1,176 +1,176 @@
-#====================================================
-#
-#    Copyright 2008-2009 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
-#
-#
-#====================================================
-
-begin
-    require 'rubygems'
-    gem 'sqlanywhere'
-    gem 'dbi'
-rescue LoadError => e
-end
-
-require 'dbi'
-require 'dbi/typeutil'
-require 'sqlanywhere'
-require 'singleton'
-
-module DBI
-module DBD
-module SQLAnywhere
-
-   VERSION = "0.1.2"
-
-   def self.driver_name
-      "SQLAnywhere"
-   end
-
-   class SA
-      include Singleton
-      attr_accessor :api
-
-      def initialize
-	 unless defined? SQLAnywhere
-	   require 'sqlanywhere'
-	 end
-
-	 @api = ::SQLAnywhere::SQLAnywhereInterface.new()
-	 result = ::SQLAnywhere::API.sqlany_initialize_interface( @api )
-	 if result == 0 
-	     raise LoadError, "Could not load SQLAnywhere DLL"
-	 end
-	 result = @api.sqlany_init()
-	 if result == 0 
-	     raise LoadError, "Could not initialize SQLAnywhere DLL"
-	 end
-      end
-
-      def free_api
-	 ::SQLAnywhere::API.sqlany_finalize_interface( @api );
-	 @api = nil
-      end
-   end   
-
-
-   DBI::TypeUtil.register_conversion(driver_name) do |obj|
-       case obj
-       when DBI::Binary # these need to be handled specially by the driver
-	   obj.to_s
-       when ::NilClass
-	   nil
-       when ::TrueClass
-	   1
-       when ::FalseClass
-	   0
-       when ::Time
-	   obj.strftime("%H:%M:%S")
-       when ::Date
-	   obj.strftime("%Y/%m/%d")
-       when ::DateTime, DBI::Timestamp
-	   DateTime.parse(obj.to_s).strftime("%Y/%m/%d %H:%M:%S")	
-       when ::String
-	   obj
-       when ::BigDecimal
-	   obj.to_s("F")
-       when ::Numeric
-	   obj.to_s
-       else
-	   obj
-       end
-   end
-
-
-   # This module provides functionality that is used by all the DBD classes
-   module Utility
-
-      NO_DIRECTION = 0
-      INPUT_ONLY   = 1
-      OUTPUT_ONLY  = 2
-      INPUT_OUTPUT = 3
-
-      # do_bind takes the following arguments:
-      # * +prep_stmt+ : a handle the prepared Statement object
-      # * +param+     : the parameter to bound, obtained by sqlany_describe_bind_param
-      # * +bindvar+   : the actual value to bind the the parameter. Can be a +VALUE+, or a +HASH+.
-      # * +i+         : the parameter number to bind. Should be the same as used in sqlany_describe_bind_param
-      # * +bound+     : hash used to track INOUT, and OUT parameters
-      #
-      # +IN+ parameters will be bound once with +INPUT_ONLY+.
-      # +OUT+ parameters will be bound once with +OUTPUT_ONLY+.
-      # +INOUT+ parameters will be be bound twice, once as +INPUT_ONLY+, and once as +OUTPUT_ONLY+. +INOUT+ parameters 
-      # will use *different* buffers to pass the input and output values to the DLL.
-      #
-      # If the parameter to be bound is +INPUT_ONLY+, +bindvar+ *must* be a regular value type such as
-      # Bignum, Fixnum, String, etc. This value will be bound to the input parameter
-      #
-      # If the parameter to be bound is +OUTPUT_ONLY+, +bindvar+ *must* be a hash with keys:
-      # ::name => This is the name that you will be used later to retrieve the output value
-      # ::length => If the output will be a string or binary, the expected length must be stated. If this length is exceeded
-      #    a DatabaseError (truncation) will be raised.
-      #
-      # If the parameter to be bound is +INPUT_OUTPUT+, +bindvar+ *must* be a hash with keys:
-      # ::name => This is the name that you will be used later to retrieve the output value
-      # ::value => The value to bind to the input.
-      # ::length => If the output will be a string or binary, the expected length must be stated. If this length is exceeded
-      #    a DatabaseError (truncation) will be raised.
-      # 
-      def do_bind!(prep_stmt, param, bindvar, i, bound)
-	 # Get the direction
-	 orig_direction = param.get_direction;
-
-	 # Bind INPUT
-	 if orig_direction == INPUT_ONLY or orig_direction == INPUT_OUTPUT
-	    param.set_direction(INPUT_ONLY)
-	    # Obtain the value out of the hash if neccessary
-	    if bindvar.class == Hash
-	       raise DBI::ProgrammingError.new("Parameter hash must contain :value key") if !bindvar.has_key?(:value)
-	       param.set_value(bindvar[:value])
-	    else
-	       param.set_value(bindvar)
-	    end
-	    raise error() if SA.instance.api.sqlany_bind_param(prep_stmt, i, param) == 0
-	 end
-
-	 # Bind OUTPUT
-	 if orig_direction == OUTPUT_ONLY or orig_direction == INPUT_OUTPUT
-	    param.set_direction(OUTPUT_ONLY)
-	    # Add the +::name+ to the +bound+ hash so its output value can be retrieved later
-	    raise DBI::ProgrammingError.new("Parameter hash must contain :name key") if !bindvar.has_key?(:name)
-	    bound[bindvar[:name]] = i if !bound.nil?
-	    # set the buffer length if appropriate
-	    if bindvar.has_key?(:length)
-	       param.set_buffer_size(bindvar[:length])
-	    end
-	    # +set_value+ sets up the receiveing buffer
-	    param.set_value(nil)
-	    raise error() if SA.instance.api.sqlany_bind_param(prep_stmt, i, param) == 0
-	 end
-      end
-   end
-
-end # module SQLAnywhere
-end # module DBD
-end # module DBI
-
-require 'dbd/sqlanywhere/driver'
-require 'dbd/sqlanywhere/database'
-require 'dbd/sqlanywhere/statement'
+#====================================================
+#
+#    Copyright 2012 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
+#
+#
+#====================================================
+
+begin
+    require 'rubygems'
+    gem 'sqlanywhere'
+    gem 'dbi'
+rescue LoadError => e
+end
+
+require 'dbi'
+require 'dbi/typeutil'
+require 'sqlanywhere'
+require 'singleton'
+
+module DBI
+module DBD
+module SQLAnywhere
+
+   VERSION = "1.0.0"
+
+   def self.driver_name
+      "SQLAnywhere"
+   end
+
+   class SA
+      include Singleton
+      attr_accessor :api
+
+      def initialize
+	 unless defined? SQLAnywhere
+	   require 'sqlanywhere'
+	 end
+
+	 @api = ::SQLAnywhere::SQLAnywhereInterface.new()
+	 result = ::SQLAnywhere::API.sqlany_initialize_interface( @api )
+	 if result == 0 
+	     raise LoadError, "Could not load SQLAnywhere DLL"
+	 end
+	 result = @api.sqlany_init()
+	 if result == 0 
+	     raise LoadError, "Could not initialize SQLAnywhere DLL"
+	 end
+      end
+
+      def free_api
+	 ::SQLAnywhere::API.sqlany_finalize_interface( @api );
+	 @api = nil
+      end
+   end   
+
+
+   DBI::TypeUtil.register_conversion(driver_name) do |obj|
+       case obj
+       when DBI::Binary # these need to be handled specially by the driver
+	   obj.to_s
+       when ::NilClass
+	   nil
+       when ::TrueClass
+	   1
+       when ::FalseClass
+	   0
+       when ::Time
+	   obj.strftime("%H:%M:%S")
+       when ::Date
+	   obj.strftime("%Y/%m/%d")
+       when ::DateTime, DBI::Timestamp
+	   DateTime.parse(obj.to_s).strftime("%Y/%m/%d %H:%M:%S")	
+       when ::String
+	   obj
+       when ::BigDecimal
+	   obj.to_s("F")
+       when ::Numeric
+	   obj.to_s
+       else
+	   obj
+       end
+   end
+
+
+   # This module provides functionality that is used by all the DBD classes
+   module Utility
+
+      NO_DIRECTION = 0
+      INPUT_ONLY   = 1
+      OUTPUT_ONLY  = 2
+      INPUT_OUTPUT = 3
+
+      # do_bind takes the following arguments:
+      # * +prep_stmt+ : a handle the prepared Statement object
+      # * +param+     : the parameter to bound, obtained by sqlany_describe_bind_param
+      # * +bindvar+   : the actual value to bind the the parameter. Can be a +VALUE+, or a +HASH+.
+      # * +i+         : the parameter number to bind. Should be the same as used in sqlany_describe_bind_param
+      # * +bound+     : hash used to track INOUT, and OUT parameters
+      #
+      # +IN+ parameters will be bound once with +INPUT_ONLY+.
+      # +OUT+ parameters will be bound once with +OUTPUT_ONLY+.
+      # +INOUT+ parameters will be be bound twice, once as +INPUT_ONLY+, and once as +OUTPUT_ONLY+. +INOUT+ parameters 
+      # will use *different* buffers to pass the input and output values to the DLL.
+      #
+      # If the parameter to be bound is +INPUT_ONLY+, +bindvar+ *must* be a regular value type such as
+      # Bignum, Fixnum, String, etc. This value will be bound to the input parameter
+      #
+      # If the parameter to be bound is +OUTPUT_ONLY+, +bindvar+ *must* be a hash with keys:
+      # ::name => This is the name that you will be used later to retrieve the output value
+      # ::length => If the output will be a string or binary, the expected length must be stated. If this length is exceeded
+      #    a DatabaseError (truncation) will be raised.
+      #
+      # If the parameter to be bound is +INPUT_OUTPUT+, +bindvar+ *must* be a hash with keys:
+      # ::name => This is the name that you will be used later to retrieve the output value
+      # ::value => The value to bind to the input.
+      # ::length => If the output will be a string or binary, the expected length must be stated. If this length is exceeded
+      #    a DatabaseError (truncation) will be raised.
+      # 
+      def do_bind!(prep_stmt, param, bindvar, i, bound)
+	 # Get the direction
+	 orig_direction = param.get_direction;
+
+	 # Bind INPUT
+	 if orig_direction == INPUT_ONLY or orig_direction == INPUT_OUTPUT
+	    param.set_direction(INPUT_ONLY)
+	    # Obtain the value out of the hash if neccessary
+	    if bindvar.class == Hash
+	       raise DBI::ProgrammingError.new("Parameter hash must contain :value key") if !bindvar.has_key?(:value)
+	       param.set_value(bindvar[:value])
+	    else
+	       param.set_value(bindvar)
+	    end
+	    raise error() if SA.instance.api.sqlany_bind_param(prep_stmt, i, param) == 0
+	 end
+
+	 # Bind OUTPUT
+	 if orig_direction == OUTPUT_ONLY or orig_direction == INPUT_OUTPUT
+	    param.set_direction(OUTPUT_ONLY)
+	    # Add the +::name+ to the +bound+ hash so its output value can be retrieved later
+	    raise DBI::ProgrammingError.new("Parameter hash must contain :name key") if !bindvar.has_key?(:name)
+	    bound[bindvar[:name]] = i if !bound.nil?
+	    # set the buffer length if appropriate
+	    if bindvar.has_key?(:length)
+	       param.set_buffer_size(bindvar[:length])
+	    end
+	    # +set_value+ sets up the receiveing buffer
+	    param.set_value(nil)
+	    raise error() if SA.instance.api.sqlany_bind_param(prep_stmt, i, param) == 0
+	 end
+      end
+   end
+
+end # module SQLAnywhere
+end # module DBD
+end # module DBI
+
+require 'dbd/sqlanywhere/driver'
+require 'dbd/sqlanywhere/database'
+require 'dbd/sqlanywhere/statement'