* include/ruby/intern.h, sprintf.c (rb_str_catf, rb_str_vcatf): new

  functions.  [ruby-dev:35597]

* string.c (rb_str_capacity): new function to return the capacity.


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@18156 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 12 insertions, 4 deletions

diff --git a/README.EXT b/README.EXT
index c4dba7f1f6..4f636d929b 100644
--- a/README.EXT
+++ b/README.EXT
@@ -185,20 +185,28 @@ listed below:
 
     Creates a new tainted Ruby string from a C string.
 
-  rb_str_cat(VALUE str, const char *ptr, long len)
-
-    Appends len bytes of data from ptr to the Ruby string.
-
   rb_sprintf(const char *format, ...)
   rb_vsprintf(const char *format, va_list ap)
 
     Creates a new Ruby string with printf(3) format.
 
+  rb_str_cat(VALUE str, const char *ptr, long len)
+
+    Appends len bytes of data from ptr to the Ruby string.
+
   rb_str_cat2(VALUE str, const char* ptr)
 
     Appends C string ptr to Ruby string str.  This function is
     equivalent to rb_str_cat(str, ptr, strlen(ptr)).
 
+  rb_str_catf(VALUE str, const char* format, ...)
+  rb_str_vcatf(VALUE str, const char* format, va_list ap)
+
+    Appends C string format and successive arguments to Ruby string
+    str according to a printf-like format.  These functions are
+    equivalent to rb_str_cat2(str, rb_sprintf(format, ...)) and
+    rb_str_cat2(str, rb_vsprintf(format, ap)), respectively.
+
  Array functions
 
   rb_ary_new()