pg 0.14.1.pre.363 → 0.14.1

data/History.rdoc

@@ -1,4 +1,4 @@
-== v0.14.1 [2012-08-12] Michael Granger <ged@FaerieMUD.org>
+== v0.14.1 [2012-09-02] Michael Granger <ged@FaerieMUD.org>
 
 Important bugfix:
 
@@ -15,6 +15,7 @@ Documentation fixes:
 - Add note about the usage scope of the result object received by the
   #set_notice_receiver block. (Lars Kanis)
 - Add PGRES_COPY_BOTH to documentation of PG::Result#result_status. (Lars Kanis)
+- Add some documentation to PG::Result#fnumber (fix for #139)
 
 
 == v0.14.0 [2012-06-17] Michael Granger <ged@FaerieMUD.org>

data/ext/pg_result.c

@@ -1,6 +1,6 @@
 /*
  * pg_result.c - PG::Result class extension
- * $Id: pg_result.c,v f92b6456c566 2012/08/08 23:22:21 code $
+ * $Id: pg_result.c,v b03c4641e58f 2012/08/14 15:08:34 ged $
  *
  */
 
@@ -331,10 +331,24 @@ pgresult_fname(VALUE self, VALUE index)
  * call-seq:
  *    res.fnumber( name ) -> Fixnum
  *
- * Returns the index of the field specified by the string _name_.
+ * Returns the index of the field specified by the string +name+.
+ * The given +name+ is treated like an identifier in an SQL command, that is,
+ * it is downcased unless double-quoted. For example, given a query result
+ * generated from the SQL command:
  *
- * Raises an ArgumentError if the specified _name_ isn't one of the field names;
- * raises a TypeError if _name_ is not a String.
+ *   result = conn.exec( %{SELECT 1 AS FOO, 2 AS "BAR"} )
+ *
+ * we would have the results:
+ *
+ *   result.fname( 0 )            # => "foo"
+ *   result.fname( 1 )            # => "BAR"
+ *   result.fnumber( "FOO" )      # => 0
+ *   result.fnumber( "foo" )      # => 0
+ *   result.fnumber( "BAR" )      # => ArgumentError
+ *   result.fnumber( %{"BAR"} )   # => 1
+ *
+ * Raises an ArgumentError if the specified +name+ isn't one of the field names;
+ * raises a TypeError if +name+ is not a String.
  */
 static VALUE
 pgresult_fnumber(VALUE self, VALUE name)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pg
 version: !ruby/object:Gem::Version
-  version: 0.14.1.pre.363
+  version: 0.14.1
   prerelease: 
 platform: ruby
 authors:
@@ -36,7 +36,7 @@ cert_chain:
   YUhDS0xaZFNLai9SSHVUT3QrZ2JsUmV4OEZBaDhOZUEKY21saFhlNDZwWk5K
   Z1dLYnhaYWg4NWpJang5NWhSOHZPSStOQU01aUg5a09xSzEzRHJ4YWNUS1Bo
   cWo1UGp3RgotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
-date: 2012-08-13 00:00:00.000000000 Z
+date: 2012-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hoe-mercurial