kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

* encoding.c (Init_Encoding): Add IO example of internal and external

Browse source 
encoding.  Fixed a typo in the force_encoding example.  [#5949]


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@34609 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
drbrain 2012-02-14 23:29:14 +00:00
parent 6d76f39fc8
commit b14b83ae92
2 changed files with 39 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
Wed Feb 15 07:28:54 2012 Eric Hodel <drbrain@segment7.net>
* encoding.c (Init_Encoding): Add IO example of internal and external
encoding. Fixed a typo in the force_encoding example. [#5949]
Wed Feb 15 06:58:21 2012 Eric Hodel <drbrain@segment7.net>
* encoding.c (Init_Encoding): Add Encoding documentation.

37
encoding.c
View file

@ -1621,12 +1621,12 @@ rb_enc_aliases(VALUE klass)
* "some string".encoding
* #=> #<Encoding:UTF-8>
*
* string = "some string".encode(Encoding::ISO_8859_1)
* string = "some string".encode Encoding::ISO_8859_1
* #=> "some string"
* string.encoding
* #=> #<Encoding:ISO-8859-1>
*
* "some string".encode("ISO-8859-1")
* "some string".encode "ISO-8859-1"
* #=> "some string"
*
* <code>Encoding::ASCII_8BIT</code> is a special encoding that does not
@ -1647,7 +1647,7 @@ rb_enc_aliases(VALUE klass)
* #=> "R\xC3\xA9sum\xC3\xA9"
* string.encoding
* #=> #<Encoding:ISO-8859-1>
* string.force_encoding(Encoding:UTF-8)
* string.force_encoding Encoding::UTF-8
* #=> "Résumé"
*
* Second, it is possible to transcode a string, i.e. translate its internal
@ -1755,6 +1755,37 @@ rb_enc_aliases(VALUE klass)
* before and after the change will have inconsistent encodings. Instead use
* <code>ruby -E</code> to invoke ruby with the correct internal encoding.
*
* == IO encoding example
*
* In the following example a UTF-8 encoded string "Résumé" is transcoded for
* output to ISO-8859-1 encoding, then read back in and transcoded to UTF-8:
*
* string = "R\u00E9sum\u00E9"
*
* open "transcoded.txt", "w:ISO-8859-1" do |io|
* io.write string
* end
*
* puts "raw text:"
* p File.binread "transcoded.txt"
* puts
*
* open "transcoded.txt", "r:ISO-8859-1:UTF-8" do |io|
* puts "transcoded text:"
* p io.read
* end
*
* While writing the file, the internal encoding is not specified as it is
* only necessary for reading. While reading the file both the internal and
* external encoding must be specified to obtain the correct result.
*
* $ ruby t.rb
* raw text:
* "R\xE9sum\xE9"
*
* transcoded text:
* "Résumé"
*
*/
void