From b2a1dc616c9af33fc81b02dca617c4ce7c48b923 Mon Sep 17 00:00:00 2001
From: akr <akr@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sat, 22 Dec 2007 08:38:53 +0000
Subject: [PATCH] add rdoc.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@14482 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 string.c | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/string.c b/string.c
index 03a45a58de..bd71bc282e 100644
--- a/string.c
+++ b/string.c
@@ -501,8 +501,7 @@ rb_str_length(VALUE str)
  */
 
 static VALUE
-rb_str_bytesize(str)
-    VALUE str;
+rb_str_bytesize(VALUE str)
 {
     return INT2NUM(RSTRING_LEN(str));
 }
@@ -5341,6 +5340,17 @@ rb_str_force_encoding(VALUE str, VALUE enc)
     return str;
 }
 
+/*
+ *  call-seq:
+ *     str.valid_encoding?  => true or false
+ *  
+ *  Returns true for a string which encoded correctly.
+ *
+ *    "\xc2\xa1".force_encoding("UTF-8").valid_encoding? => true
+ *    "\xc2".force_encoding("UTF-8").valid_encoding? => false
+ *    "\x80".force_encoding("UTF-8").valid_encoding? => false
+ */
+
 static VALUE
 rb_str_valid_encoding_p(VALUE str)
 {
@@ -5349,6 +5359,16 @@ rb_str_valid_encoding_p(VALUE str)
     return cr == ENC_CODERANGE_BROKEN ? Qfalse : Qtrue;
 }
 
+/*
+ *  call-seq:
+ *     str.ascii_only?  => true or false
+ *  
+ *  Returns true for a string which has only ASCII characters.
+ *
+ *    "abc".force_encoding("UTF-8").ascii_only? => true
+ *    "abc\u{6666}".force_encoding("UTF-8").ascii_only? => false
+ */
+
 static VALUE
 rb_str_is_ascii_only_p(VALUE str)
 {