[前][次][番号順一覧][スレッド一覧]

ruby-changes:30453

From: zzak <ko1@a...>
Date: Mon, 12 Aug 2013 13:29:56 +0900 (JST)
Subject: [ruby-changes:30453] zzak:r42532 (trunk): * lib/yaml/dbm.rb: [DOC] Document call-seq for YAML::DBM

zzak	2013-08-12 13:29:49 +0900 (Mon, 12 Aug 2013)

  New Revision: 42532

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=42532

  Log:
    * lib/yaml/dbm.rb: [DOC] Document call-seq for YAML::DBM

  Modified files:
    trunk/ChangeLog
    trunk/lib/yaml/dbm.rb
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 42531)
+++ ChangeLog	(revision 42532)
@@ -1,3 +1,7 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1
+Mon Aug 12 13:29:09 2013  Zachary Scott  <e@z...>
+
+	* lib/yaml/dbm.rb: [DOC] Document call-seq for YAML::DBM
+
 Mon Aug 12 12:57:26 2013  Zachary Scott  <e@z...>
 
 	* ext/dbm/extconf.rb: [DOC] Hide from RDoc
Index: lib/yaml/dbm.rb
===================================================================
--- lib/yaml/dbm.rb	(revision 42531)
+++ lib/yaml/dbm.rb	(revision 42532)
@@ -17,6 +17,9 @@ module YAML https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L17
 class DBM < ::DBM
     VERSION = "0.1" # :nodoc:
 
+    # :call-seq:
+    #   ydbm[key] -> value
+    #
     # Return value associated with +key+ from database.
     #
     # Returns +nil+ if there is no such +key+.
@@ -27,7 +30,7 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L30
     end
 
     # :call-seq:
-    #   []=( key, value )
+    #   ydbm[key] = value
     #
     # Set +key+ to +value+ in database.
     #
@@ -39,8 +42,8 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L42
     end
 
     # :call-seq:
-    #   fetch( key, ifnone = nil )
-    #   fetch( key, &block )
+    #   ydbm.fetch( key, ifnone = nil )
+    #   ydbm.fetch( key ) { |key| ... }
     #
     # Return value associated with +key+.
     #
@@ -74,18 +77,24 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L77
     end
 
     # :call-seq:
-    #   db.key(value) -> string
+    #   ydbm.key(value) -> string
     #
     # Returns the key for the specified value.
     def key( keystr )
         invert[keystr]
     end
 
+    # :call-seq:
+    #   ydbm.values_at(*keys)
+    #
     # Returns an array containing the values associated with the given keys.
     def values_at( *keys )
         keys.collect { |k| fetch( k ) }
     end
 
+    # :call-seq:
+    #   ydbm.delete(key)
+    #
     # Deletes value from database associated with +key+.
     #
     # Returns value or +nil+.
@@ -97,6 +106,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L106
         v
     end
 
+    # :call-seq:
+    #   ydbm.delete_if { |key, value| ... }
+    #
     # Calls the given block once for each +key+, +value+ pair in the database.
     # Deletes all entries for which the block returns true.
     #
@@ -108,6 +120,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L120
         self
     end
 
+    # :call-seq:
+    #   ydbm.reject { |key, value| ... }
+    #
     # Converts the contents of the database to an in-memory Hash, then calls
     # Hash#reject with the specified code block, returning a new Hash.
     def reject
@@ -115,6 +130,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L130
         hsh.reject { |k,v| yield k, v }
     end
 
+    # :call-seq:
+    #   ydbm.each_pair { |key, value| ... }
+    #
     # Calls the given block once for each +key+, +value+ pair in the database.
     #
     # Returns +self+.
@@ -123,6 +141,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L141
         self
     end
 
+    # :call-seq:
+    #   ydbm.each_value { |value| ... }
+    #
     # Calls the given block for each value in database.
     #
     # Returns +self+.
@@ -131,17 +152,26 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L152
         self
     end
 
+    # :call-seq:
+    #   ydbm.values
+    #
     # Returns an array of values from the database.
     def values
         super.collect { |v| YAML.load( v ) }
     end
 
-    # Returns true if specified value is found in the database.
+    # :call-seq:
+    #   ydbm.has_value?(value)
+    #
+    # Returns true if specified +value+ is found in the database.
     def has_value?( val )
         each_value { |v| return true if v == val }
         return false
     end
 
+    # :call-seq:
+    #   ydbm.invert -> hash
+    #
     # Returns a Hash (not a DBM database) created by using each value in the
     # database as a key, with the corresponding key as its value.
     #
@@ -153,6 +183,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L183
         h
     end
 
+    # :call-seq:
+    #   ydbm.replace(hash) -> ydbm
+    #
     # Replaces the contents of the database with the contents of the specified
     # object. Takes any object which implements the each_pair method, including
     # Hash and DBM objects.
@@ -161,6 +194,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L194
         update( hsh )
     end
 
+    # :call-seq:
+    #   ydbm.shift -> [key, value]
+    #
     # Removes a [key, value] pair from the database, and returns it.
     # If the database is empty, returns +nil+.
     #
@@ -172,8 +208,8 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L208
     end
 
     # :call-seq:
-    #   select( &block )
-    #   select( *keys )
+    #   ydbm.select { |key, value| ... }
+    #   ydbm.select(*keys)
     #
     # If a block is provided, returns a new array containing [key, value] pairs
     # for which the block returns true.
@@ -188,17 +224,20 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L224
     end
 
     # :call-seq:
-    #   store( key, value )
+    #   ydbm.store(key, value) -> value
     #
-    #Stores +value+ in database with +key+ as the index. +value+ is converted
-    #to YAML before being stored.
+    # Stores +value+ in database with +key+ as the index. +value+ is converted
+    # to YAML before being stored.
     #
-    #Returns +value+
+    # Returns +value+
     def store( key, val )
         super( key, val.to_yaml )
         val
     end
 
+    # :call-seq:
+    #   ydbm.update(hash) -> ydbm
+    #
     # Updates the database with multiple values from the specified object.
     # Takes any object which implements the each_pair method, including
     # Hash and DBM objects.
@@ -211,6 +250,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L250
         self
     end
 
+    # :call-seq:
+    #   ydbm.to_a -> array
+    #
     # Converts the contents of the database to an array of [key, value] arrays,
     # and returns it.
     def to_a
@@ -220,6 +262,9 @@ class DBM < ::DBM https://github.com/ruby/ruby/blob/trunk/lib/yaml/dbm.rb#L262
     end
 
 
+    # :call-seq:
+    #   ydbm.to_hash -> hash
+    #
     # Converts the contents of the database to an in-memory Hash object, and
     # returns it.
     def to_hash

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/

[前][次][番号順一覧][スレッド一覧]