rio 0.4.0 → 0.4.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (320) hide show
  1. data/COPYING +1 -0
  2. data/README +11 -9
  3. data/Rakefile +1 -1
  4. data/doc/#RIOIS# +216 -0
  5. data/doc/ANNOUNCE +22 -16
  6. data/doc/RELEASE_NOTES +14 -7
  7. data/lib/rio/doc/EXAMPLES.rb +2 -2
  8. data/lib/rio/doc/INTRO.rb +0 -2
  9. data/lib/rio/doc/OPTIONAL.rb +1 -1
  10. data/lib/rio/doc/SYNOPSIS.rb +1 -1
  11. data/lib/rio/factory.rb +1 -0
  12. data/lib/rio/ftp/fs.rb +2 -1
  13. data/lib/rio/ftp/ftpfile.rb +20 -20
  14. data/lib/rio/if/grande.rb +16 -10
  15. data/lib/rio/if/test.rb +1 -1
  16. data/lib/rio/ops/construct.rb +13 -12
  17. data/lib/rio/ops/dir.rb +2 -1
  18. data/lib/rio/rl/fs2url.rb +2 -2
  19. data/lib/rio/rl/path.rb +1 -0
  20. data/lib/rio/rl/uri.rb +4 -0
  21. data/lib/rio/rl/withpath.rb +1 -0
  22. data/lib/rio/scheme/ftp.rb +46 -3
  23. data/lib/rio/uri/file.rb +16 -6
  24. data/lib/rio/version.rb +1 -1
  25. data/test/ftp/anon_copy_data.rb +36 -0
  26. data/test/ftp/testdef.rb +5 -4
  27. data/test/http/all.rb +1 -0
  28. data/test/http/copy-from-http.rb +2 -1
  29. data/test/http/uri-meta.rb +72 -0
  30. data/test/lib/temp_server.rb +3 -1
  31. data/test/runalltests.rb +2 -2
  32. data/test/runftptests.rb +1 -1
  33. data/test/runhttp.rb +1 -2
  34. metadata +5 -312
  35. data/doc/rdoc/classes/Kernel.html +0 -133
  36. data/doc/rdoc/classes/Kernel.src/M000233.html +0 -18
  37. data/doc/rdoc/classes/RIO.html +0 -625
  38. data/doc/rdoc/classes/RIO.src/M000001.html +0 -18
  39. data/doc/rdoc/classes/RIO.src/M000002.html +0 -18
  40. data/doc/rdoc/classes/RIO.src/M000003.html +0 -18
  41. data/doc/rdoc/classes/RIO/Doc.html +0 -148
  42. data/doc/rdoc/classes/RIO/Doc/EXAMPLES.html +0 -432
  43. data/doc/rdoc/classes/RIO/Doc/HOWTO.html +0 -1075
  44. data/doc/rdoc/classes/RIO/Doc/INDEX.html +0 -368
  45. data/doc/rdoc/classes/RIO/Doc/INTRO.html +0 -1533
  46. data/doc/rdoc/classes/RIO/Doc/OPTIONAL.html +0 -221
  47. data/doc/rdoc/classes/RIO/Doc/SYNOPSIS.html +0 -337
  48. data/doc/rdoc/classes/RIO/IF.html +0 -165
  49. data/doc/rdoc/classes/RIO/IF/CSV.html +0 -203
  50. data/doc/rdoc/classes/RIO/IF/CSV.src/M000116.html +0 -19
  51. data/doc/rdoc/classes/RIO/IF/CSV.src/M000117.html +0 -16
  52. data/doc/rdoc/classes/RIO/IF/CSV.src/M000118.html +0 -16
  53. data/doc/rdoc/classes/RIO/IF/Dir.html +0 -343
  54. data/doc/rdoc/classes/RIO/IF/Dir.src/M000045.html +0 -16
  55. data/doc/rdoc/classes/RIO/IF/Dir.src/M000046.html +0 -16
  56. data/doc/rdoc/classes/RIO/IF/Dir.src/M000047.html +0 -16
  57. data/doc/rdoc/classes/RIO/IF/Dir.src/M000048.html +0 -16
  58. data/doc/rdoc/classes/RIO/IF/Dir.src/M000049.html +0 -16
  59. data/doc/rdoc/classes/RIO/IF/Dir.src/M000050.html +0 -16
  60. data/doc/rdoc/classes/RIO/IF/Dir.src/M000051.html +0 -16
  61. data/doc/rdoc/classes/RIO/IF/File.html +0 -223
  62. data/doc/rdoc/classes/RIO/IF/File.src/M000212.html +0 -16
  63. data/doc/rdoc/classes/RIO/IF/File.src/M000213.html +0 -16
  64. data/doc/rdoc/classes/RIO/IF/File.src/M000214.html +0 -16
  65. data/doc/rdoc/classes/RIO/IF/File.src/M000215.html +0 -16
  66. data/doc/rdoc/classes/RIO/IF/FileOrDir.html +0 -572
  67. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000155.html +0 -16
  68. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000156.html +0 -16
  69. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000157.html +0 -16
  70. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000158.html +0 -16
  71. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000159.html +0 -16
  72. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000160.html +0 -16
  73. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000161.html +0 -16
  74. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000162.html +0 -16
  75. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000163.html +0 -16
  76. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000164.html +0 -16
  77. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000165.html +0 -16
  78. data/doc/rdoc/classes/RIO/IF/FileOrDir.src/M000166.html +0 -16
  79. data/doc/rdoc/classes/RIO/IF/Grande.html +0 -1349
  80. data/doc/rdoc/classes/RIO/IF/Grande.src/M000088.html +0 -16
  81. data/doc/rdoc/classes/RIO/IF/Grande.src/M000089.html +0 -16
  82. data/doc/rdoc/classes/RIO/IF/Grande.src/M000090.html +0 -16
  83. data/doc/rdoc/classes/RIO/IF/Grande.src/M000091.html +0 -16
  84. data/doc/rdoc/classes/RIO/IF/Grande.src/M000092.html +0 -16
  85. data/doc/rdoc/classes/RIO/IF/Grande.src/M000093.html +0 -21
  86. data/doc/rdoc/classes/RIO/IF/Grande.src/M000094.html +0 -16
  87. data/doc/rdoc/classes/RIO/IF/Grande.src/M000095.html +0 -16
  88. data/doc/rdoc/classes/RIO/IF/Grande.src/M000096.html +0 -16
  89. data/doc/rdoc/classes/RIO/IF/Grande.src/M000097.html +0 -16
  90. data/doc/rdoc/classes/RIO/IF/Grande.src/M000098.html +0 -16
  91. data/doc/rdoc/classes/RIO/IF/Grande.src/M000099.html +0 -16
  92. data/doc/rdoc/classes/RIO/IF/Grande.src/M000100.html +0 -21
  93. data/doc/rdoc/classes/RIO/IF/Grande.src/M000101.html +0 -16
  94. data/doc/rdoc/classes/RIO/IF/Grande.src/M000102.html +0 -16
  95. data/doc/rdoc/classes/RIO/IF/Grande.src/M000103.html +0 -16
  96. data/doc/rdoc/classes/RIO/IF/Grande.src/M000104.html +0 -16
  97. data/doc/rdoc/classes/RIO/IF/Grande.src/M000105.html +0 -16
  98. data/doc/rdoc/classes/RIO/IF/GrandeEntry.html +0 -810
  99. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000106.html +0 -16
  100. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000107.html +0 -16
  101. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000108.html +0 -16
  102. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000109.html +0 -16
  103. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000110.html +0 -16
  104. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000111.html +0 -16
  105. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000112.html +0 -16
  106. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000113.html +0 -16
  107. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000114.html +0 -16
  108. data/doc/rdoc/classes/RIO/IF/GrandeEntry.src/M000115.html +0 -16
  109. data/doc/rdoc/classes/RIO/IF/GrandeStream.html +0 -1513
  110. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000052.html +0 -16
  111. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000053.html +0 -16
  112. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000054.html +0 -16
  113. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000055.html +0 -16
  114. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000056.html +0 -16
  115. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000057.html +0 -16
  116. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000058.html +0 -16
  117. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000059.html +0 -16
  118. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000060.html +0 -16
  119. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000061.html +0 -16
  120. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000062.html +0 -16
  121. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000063.html +0 -16
  122. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000064.html +0 -16
  123. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000065.html +0 -16
  124. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000066.html +0 -16
  125. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000067.html +0 -16
  126. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000068.html +0 -19
  127. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000069.html +0 -16
  128. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000070.html +0 -16
  129. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000071.html +0 -16
  130. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000072.html +0 -16
  131. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000073.html +0 -16
  132. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000074.html +0 -16
  133. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000075.html +0 -16
  134. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000076.html +0 -16
  135. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000077.html +0 -16
  136. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000078.html +0 -16
  137. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000079.html +0 -16
  138. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000080.html +0 -16
  139. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000081.html +0 -16
  140. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000082.html +0 -16
  141. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000083.html +0 -16
  142. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000084.html +0 -16
  143. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000085.html +0 -16
  144. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000086.html +0 -16
  145. data/doc/rdoc/classes/RIO/IF/GrandeStream.src/M000087.html +0 -16
  146. data/doc/rdoc/classes/RIO/IF/Path.html +0 -999
  147. data/doc/rdoc/classes/RIO/IF/Path.src/M000180.html +0 -16
  148. data/doc/rdoc/classes/RIO/IF/Path.src/M000181.html +0 -16
  149. data/doc/rdoc/classes/RIO/IF/Path.src/M000182.html +0 -16
  150. data/doc/rdoc/classes/RIO/IF/Path.src/M000183.html +0 -16
  151. data/doc/rdoc/classes/RIO/IF/Path.src/M000184.html +0 -16
  152. data/doc/rdoc/classes/RIO/IF/Path.src/M000185.html +0 -16
  153. data/doc/rdoc/classes/RIO/IF/Path.src/M000186.html +0 -16
  154. data/doc/rdoc/classes/RIO/IF/Path.src/M000187.html +0 -16
  155. data/doc/rdoc/classes/RIO/IF/Path.src/M000188.html +0 -16
  156. data/doc/rdoc/classes/RIO/IF/Path.src/M000189.html +0 -16
  157. data/doc/rdoc/classes/RIO/IF/Path.src/M000190.html +0 -16
  158. data/doc/rdoc/classes/RIO/IF/Path.src/M000191.html +0 -16
  159. data/doc/rdoc/classes/RIO/IF/Path.src/M000192.html +0 -16
  160. data/doc/rdoc/classes/RIO/IF/Path.src/M000193.html +0 -16
  161. data/doc/rdoc/classes/RIO/IF/Path.src/M000194.html +0 -16
  162. data/doc/rdoc/classes/RIO/IF/Path.src/M000195.html +0 -16
  163. data/doc/rdoc/classes/RIO/IF/Path.src/M000196.html +0 -16
  164. data/doc/rdoc/classes/RIO/IF/Path.src/M000197.html +0 -16
  165. data/doc/rdoc/classes/RIO/IF/Path.src/M000198.html +0 -16
  166. data/doc/rdoc/classes/RIO/IF/Path.src/M000199.html +0 -16
  167. data/doc/rdoc/classes/RIO/IF/Path.src/M000200.html +0 -16
  168. data/doc/rdoc/classes/RIO/IF/Path.src/M000201.html +0 -16
  169. data/doc/rdoc/classes/RIO/IF/Path.src/M000202.html +0 -18
  170. data/doc/rdoc/classes/RIO/IF/Path.src/M000203.html +0 -16
  171. data/doc/rdoc/classes/RIO/IF/Path.src/M000204.html +0 -16
  172. data/doc/rdoc/classes/RIO/IF/Path.src/M000205.html +0 -16
  173. data/doc/rdoc/classes/RIO/IF/Path.src/M000206.html +0 -16
  174. data/doc/rdoc/classes/RIO/IF/Path.src/M000207.html +0 -16
  175. data/doc/rdoc/classes/RIO/IF/Path.src/M000208.html +0 -16
  176. data/doc/rdoc/classes/RIO/IF/Path.src/M000209.html +0 -16
  177. data/doc/rdoc/classes/RIO/IF/Path.src/M000210.html +0 -16
  178. data/doc/rdoc/classes/RIO/IF/Path.src/M000211.html +0 -16
  179. data/doc/rdoc/classes/RIO/IF/RubyIO.html +0 -1414
  180. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000004.html +0 -16
  181. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000005.html +0 -16
  182. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000006.html +0 -16
  183. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000007.html +0 -16
  184. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000008.html +0 -16
  185. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000009.html +0 -16
  186. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000010.html +0 -16
  187. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000011.html +0 -16
  188. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000012.html +0 -16
  189. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000013.html +0 -16
  190. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000014.html +0 -16
  191. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000015.html +0 -16
  192. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000016.html +0 -16
  193. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000017.html +0 -16
  194. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000018.html +0 -16
  195. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000019.html +0 -16
  196. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000020.html +0 -16
  197. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000021.html +0 -16
  198. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000022.html +0 -16
  199. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000023.html +0 -16
  200. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000024.html +0 -16
  201. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000025.html +0 -16
  202. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000026.html +0 -16
  203. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000027.html +0 -16
  204. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000028.html +0 -16
  205. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000029.html +0 -16
  206. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000030.html +0 -16
  207. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000031.html +0 -16
  208. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000032.html +0 -16
  209. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000033.html +0 -16
  210. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000034.html +0 -16
  211. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000035.html +0 -16
  212. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000036.html +0 -16
  213. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000037.html +0 -16
  214. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000038.html +0 -16
  215. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000039.html +0 -16
  216. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000040.html +0 -16
  217. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000041.html +0 -16
  218. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000042.html +0 -16
  219. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000043.html +0 -16
  220. data/doc/rdoc/classes/RIO/IF/RubyIO.src/M000044.html +0 -16
  221. data/doc/rdoc/classes/RIO/IF/String.html +0 -203
  222. data/doc/rdoc/classes/RIO/IF/String.src/M000216.html +0 -16
  223. data/doc/rdoc/classes/RIO/IF/String.src/M000217.html +0 -16
  224. data/doc/rdoc/classes/RIO/IF/String.src/M000218.html +0 -16
  225. data/doc/rdoc/classes/RIO/IF/Test.html +0 -990
  226. data/doc/rdoc/classes/RIO/IF/Test.src/M000119.html +0 -16
  227. data/doc/rdoc/classes/RIO/IF/Test.src/M000120.html +0 -16
  228. data/doc/rdoc/classes/RIO/IF/Test.src/M000121.html +0 -16
  229. data/doc/rdoc/classes/RIO/IF/Test.src/M000122.html +0 -16
  230. data/doc/rdoc/classes/RIO/IF/Test.src/M000123.html +0 -16
  231. data/doc/rdoc/classes/RIO/IF/Test.src/M000124.html +0 -16
  232. data/doc/rdoc/classes/RIO/IF/Test.src/M000125.html +0 -16
  233. data/doc/rdoc/classes/RIO/IF/Test.src/M000126.html +0 -16
  234. data/doc/rdoc/classes/RIO/IF/Test.src/M000127.html +0 -16
  235. data/doc/rdoc/classes/RIO/IF/Test.src/M000128.html +0 -16
  236. data/doc/rdoc/classes/RIO/IF/Test.src/M000129.html +0 -16
  237. data/doc/rdoc/classes/RIO/IF/Test.src/M000130.html +0 -16
  238. data/doc/rdoc/classes/RIO/IF/Test.src/M000131.html +0 -16
  239. data/doc/rdoc/classes/RIO/IF/Test.src/M000132.html +0 -16
  240. data/doc/rdoc/classes/RIO/IF/Test.src/M000133.html +0 -16
  241. data/doc/rdoc/classes/RIO/IF/Test.src/M000134.html +0 -16
  242. data/doc/rdoc/classes/RIO/IF/Test.src/M000135.html +0 -16
  243. data/doc/rdoc/classes/RIO/IF/Test.src/M000136.html +0 -16
  244. data/doc/rdoc/classes/RIO/IF/Test.src/M000137.html +0 -16
  245. data/doc/rdoc/classes/RIO/IF/Test.src/M000138.html +0 -16
  246. data/doc/rdoc/classes/RIO/IF/Test.src/M000139.html +0 -16
  247. data/doc/rdoc/classes/RIO/IF/Test.src/M000140.html +0 -16
  248. data/doc/rdoc/classes/RIO/IF/Test.src/M000141.html +0 -16
  249. data/doc/rdoc/classes/RIO/IF/Test.src/M000142.html +0 -16
  250. data/doc/rdoc/classes/RIO/IF/Test.src/M000143.html +0 -16
  251. data/doc/rdoc/classes/RIO/IF/Test.src/M000144.html +0 -16
  252. data/doc/rdoc/classes/RIO/IF/Test.src/M000145.html +0 -16
  253. data/doc/rdoc/classes/RIO/IF/Test.src/M000146.html +0 -16
  254. data/doc/rdoc/classes/RIO/IF/Test.src/M000147.html +0 -16
  255. data/doc/rdoc/classes/RIO/IF/Test.src/M000148.html +0 -16
  256. data/doc/rdoc/classes/RIO/IF/Test.src/M000149.html +0 -16
  257. data/doc/rdoc/classes/RIO/IF/Test.src/M000150.html +0 -16
  258. data/doc/rdoc/classes/RIO/IF/Test.src/M000151.html +0 -16
  259. data/doc/rdoc/classes/RIO/IF/Test.src/M000152.html +0 -16
  260. data/doc/rdoc/classes/RIO/IF/Test.src/M000153.html +0 -16
  261. data/doc/rdoc/classes/RIO/IF/Test.src/M000154.html +0 -16
  262. data/doc/rdoc/classes/RIO/IF/YAML.html +0 -517
  263. data/doc/rdoc/classes/RIO/IF/YAML.src/M000167.html +0 -19
  264. data/doc/rdoc/classes/RIO/IF/YAML.src/M000168.html +0 -16
  265. data/doc/rdoc/classes/RIO/IF/YAML.src/M000169.html +0 -16
  266. data/doc/rdoc/classes/RIO/IF/YAML.src/M000170.html +0 -16
  267. data/doc/rdoc/classes/RIO/IF/YAML.src/M000171.html +0 -16
  268. data/doc/rdoc/classes/RIO/IF/YAML.src/M000172.html +0 -16
  269. data/doc/rdoc/classes/RIO/IF/YAML.src/M000173.html +0 -16
  270. data/doc/rdoc/classes/RIO/IF/YAML.src/M000174.html +0 -16
  271. data/doc/rdoc/classes/RIO/IF/YAML.src/M000175.html +0 -16
  272. data/doc/rdoc/classes/RIO/IF/YAML.src/M000176.html +0 -16
  273. data/doc/rdoc/classes/RIO/IF/YAML.src/M000177.html +0 -16
  274. data/doc/rdoc/classes/RIO/IF/YAML.src/M000178.html +0 -16
  275. data/doc/rdoc/classes/RIO/IF/YAML.src/M000179.html +0 -16
  276. data/doc/rdoc/classes/RIO/Rio.html +0 -508
  277. data/doc/rdoc/classes/RIO/Rio.src/M000219.html +0 -18
  278. data/doc/rdoc/classes/RIO/Rio.src/M000220.html +0 -20
  279. data/doc/rdoc/classes/RIO/Rio.src/M000221.html +0 -27
  280. data/doc/rdoc/classes/RIO/Rio.src/M000222.html +0 -16
  281. data/doc/rdoc/classes/RIO/Rio.src/M000224.html +0 -19
  282. data/doc/rdoc/classes/RIO/Rio.src/M000225.html +0 -20
  283. data/doc/rdoc/classes/RIO/Rio.src/M000226.html +0 -16
  284. data/doc/rdoc/classes/RIO/Rio.src/M000227.html +0 -16
  285. data/doc/rdoc/classes/RIO/Rio.src/M000228.html +0 -16
  286. data/doc/rdoc/classes/RIO/Rio.src/M000229.html +0 -16
  287. data/doc/rdoc/classes/RIO/Rio.src/M000230.html +0 -16
  288. data/doc/rdoc/classes/RIO/Rio.src/M000231.html +0 -16
  289. data/doc/rdoc/classes/RIO/Rio.src/M000232.html +0 -16
  290. data/doc/rdoc/created.rid +0 -1
  291. data/doc/rdoc/files/README.html +0 -229
  292. data/doc/rdoc/files/lib/rio/constructor_rb.html +0 -141
  293. data/doc/rdoc/files/lib/rio/doc/EXAMPLES_rb.html +0 -134
  294. data/doc/rdoc/files/lib/rio/doc/HOWTO_rb.html +0 -134
  295. data/doc/rdoc/files/lib/rio/doc/INDEX_rb.html +0 -134
  296. data/doc/rdoc/files/lib/rio/doc/INTRO_rb.html +0 -134
  297. data/doc/rdoc/files/lib/rio/doc/OPTIONAL_rb.html +0 -134
  298. data/doc/rdoc/files/lib/rio/doc/SYNOPSIS_rb.html +0 -134
  299. data/doc/rdoc/files/lib/rio/if/basic_rb.html +0 -134
  300. data/doc/rdoc/files/lib/rio/if/csv_rb.html +0 -134
  301. data/doc/rdoc/files/lib/rio/if/dir_rb.html +0 -134
  302. data/doc/rdoc/files/lib/rio/if/file_rb.html +0 -134
  303. data/doc/rdoc/files/lib/rio/if/fileordir_rb.html +0 -134
  304. data/doc/rdoc/files/lib/rio/if/grande_entry_rb.html +0 -134
  305. data/doc/rdoc/files/lib/rio/if/grande_rb.html +0 -141
  306. data/doc/rdoc/files/lib/rio/if/grande_stream_rb.html +0 -134
  307. data/doc/rdoc/files/lib/rio/if/internal_rb.html +0 -134
  308. data/doc/rdoc/files/lib/rio/if/path_rb.html +0 -134
  309. data/doc/rdoc/files/lib/rio/if/rubyio_rb.html +0 -134
  310. data/doc/rdoc/files/lib/rio/if/string_rb.html +0 -134
  311. data/doc/rdoc/files/lib/rio/if/temp_rb.html +0 -134
  312. data/doc/rdoc/files/lib/rio/if/test_rb.html +0 -134
  313. data/doc/rdoc/files/lib/rio/if/yaml_rb.html +0 -134
  314. data/doc/rdoc/files/lib/rio/kernel_rb.html +0 -142
  315. data/doc/rdoc/files/lib/rio_rb.html +0 -153
  316. data/doc/rdoc/fr_class_index.html +0 -49
  317. data/doc/rdoc/fr_file_index.html +0 -51
  318. data/doc/rdoc/fr_method_index.html +0 -259
  319. data/doc/rdoc/index.html +0 -30
  320. data/doc/rdoc/rdoc-style.css +0 -428
data/doc/rdoc/classes/RIO/IF/Path.src/M000206.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>opaque (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 407</span>
14
- 407: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">opaque</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-identifier">target</span>.<span class="ruby-identifier">opaque</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/Path.src/M000207.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>merge (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 417</span>
14
- 417: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge</span>(<span class="ruby-identifier">other</span>) <span class="ruby-identifier">target</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">other</span>) <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/Path.src/M000208.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>route_from (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 425</span>
14
- 425: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">route_from</span>(<span class="ruby-identifier">other</span>) <span class="ruby-identifier">target</span>.<span class="ruby-identifier">route_from</span>(<span class="ruby-identifier">other</span>) <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/Path.src/M000209.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>route_to (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 432</span>
14
- 432: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">route_to</span>(<span class="ruby-identifier">other</span>) <span class="ruby-identifier">target</span>.<span class="ruby-identifier">route_to</span>(<span class="ruby-identifier">other</span>) <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/Path.src/M000210.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>cleanpath (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 445</span>
14
- 445: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanpath</span>(<span class="ruby-identifier">consider_symlink</span>=<span class="ruby-keyword kw">false</span>) <span class="ruby-identifier">target</span>.<span class="ruby-identifier">cleanpath</span>(<span class="ruby-identifier">consider_symlink</span>) <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/Path.src/M000211.html DELETED
@@ -1,16 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>realpath (RIO::IF::Path)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre> <span class="ruby-comment cmt"># File lib/rio/if/path.rb, line 453</span>
14
- 453: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">realpath</span>() <span class="ruby-identifier">target</span>.<span class="ruby-identifier">realpath</span>() <span class="ruby-keyword kw">end</span></pre>
15
- </body>
16
- </html>
data/doc/rdoc/classes/RIO/IF/RubyIO.html DELETED
@@ -1,1414 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
- <head>
8
- <title>Module: RIO::IF::RubyIO</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
- <meta name="revisit-after" content="5 days">
12
- <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
13
- <script type="text/javascript">
14
- // <![CDATA[
15
-
16
- function popupCode( url ) {
17
- window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
18
- }
19
-
20
- function toggleCode( id ) {
21
- if ( document.getElementById )
22
- elem = document.getElementById( id );
23
- else if ( document.all )
24
- elem = eval( "document.all." + id );
25
- else
26
- return false;
27
-
28
- elemStyle = elem.style;
29
-
30
- if ( elemStyle.display != "block" ) {
31
- elemStyle.display = "block"
32
- } else {
33
- elemStyle.display = "none"
34
- }
35
-
36
- return true;
37
- }
38
-
39
- // Make codeblocks hidden by default
40
- document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
41
-
42
- // ]]>
43
- </script>
44
-
45
- </head>
46
- <body>
47
-
48
-
49
-
50
- <div id="classHeader">
51
- <table class="header-table">
52
- <tr class="top-aligned-row">
53
- <td class="class-mod"><strong>Module</strong></td>
54
- <td class="class-name-in-header">RIO::IF::RubyIO</td>
55
- <td rowspan="2" class="class-header-space-col"></td>
56
- <td rowspan="2">
57
- <a class="in-url" href="../../../files/lib/rio/if/rubyio_rb.html">
58
- lib/rio/if/rubyio.rb
59
- </a>
60
- &nbsp;&nbsp;
61
- </td>
62
- </tr>
63
-
64
- </table>
65
- </div>
66
- <!-- banner header -->
67
-
68
- <div id="bodyContent">
69
-
70
-
71
-
72
- <div id="contextContent">
73
-
74
-
75
-
76
- </div>
77
-
78
- <div id="method-list">
79
- <h3 class="section-bar">Methods</h3>
80
-
81
- <div class="name-list">
82
- <a href="#M000008">binmode</a>&nbsp;&nbsp;
83
- <a href="#M000030">close</a>&nbsp;&nbsp;
84
- <a href="#M000031">close_write</a>&nbsp;&nbsp;
85
- <a href="#M000010">each_byte</a>&nbsp;&nbsp;
86
- <a href="#M000011">each_line</a>&nbsp;&nbsp;
87
- <a href="#M000025">eof?</a>&nbsp;&nbsp;
88
- <a href="#M000032">fcntl</a>&nbsp;&nbsp;
89
- <a href="#M000034">fileno</a>&nbsp;&nbsp;
90
- <a href="#M000009">flush</a>&nbsp;&nbsp;
91
- <a href="#M000035">fsync</a>&nbsp;&nbsp;
92
- <a href="#M000037">getc</a>&nbsp;&nbsp;
93
- <a href="#M000004">gets</a>&nbsp;&nbsp;
94
- <a href="#M000033">ioctl</a>&nbsp;&nbsp;
95
- <a href="#M000026">ioh</a>&nbsp;&nbsp;
96
- <a href="#M000027">ios</a>&nbsp;&nbsp;
97
- <a href="#M000005">lineno</a>&nbsp;&nbsp;
98
- <a href="#M000006">lineno=</a>&nbsp;&nbsp;
99
- <a href="#M000028">mode</a>&nbsp;&nbsp;
100
- <a href="#M000029">mode?</a>&nbsp;&nbsp;
101
- <a href="#M000043">nosync</a>&nbsp;&nbsp;
102
- <a href="#M000036">pid</a>&nbsp;&nbsp;
103
- <a href="#M000015">print</a>&nbsp;&nbsp;
104
- <a href="#M000016">print!</a>&nbsp;&nbsp;
105
- <a href="#M000018">printf</a>&nbsp;&nbsp;
106
- <a href="#M000017">printf!</a>&nbsp;&nbsp;
107
- <a href="#M000020">putc</a>&nbsp;&nbsp;
108
- <a href="#M000019">putc!</a>&nbsp;&nbsp;
109
- <a href="#M000021">puts</a>&nbsp;&nbsp;
110
- <a href="#M000022">puts!</a>&nbsp;&nbsp;
111
- <a href="#M000013">readline</a>&nbsp;&nbsp;
112
- <a href="#M000012">readlines</a>&nbsp;&nbsp;
113
- <a href="#M000014">readpartial</a>&nbsp;&nbsp;
114
- <a href="#M000007">recno</a>&nbsp;&nbsp;
115
- <a href="#M000042">sync</a>&nbsp;&nbsp;
116
- <a href="#M000044">sync?</a>&nbsp;&nbsp;
117
- <a href="#M000038">to_i</a>&nbsp;&nbsp;
118
- <a href="#M000039">to_io</a>&nbsp;&nbsp;
119
- <a href="#M000040">tty?</a>&nbsp;&nbsp;
120
- <a href="#M000041">ungetc</a>&nbsp;&nbsp;
121
- <a href="#M000024">write</a>&nbsp;&nbsp;
122
- <a href="#M000023">write!</a>&nbsp;&nbsp;
123
- </div>
124
- </div>
125
-
126
-
127
-
128
- <!-- if includes -->
129
-
130
- <div id="section">
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
- <!-- if method_list -->
140
- <div id="methods">
141
- <h3 class="section-bar">Public Instance methods</h3>
142
-
143
- <div id="method-M000008" class="method-detail">
144
- <a name="M000008"></a>
145
-
146
- <div class="method-heading">
147
- <a href="RubyIO.src/M000008.html" target="Code" class="method-signature"
148
- onclick="popupCode('RubyIO.src/M000008.html');return false;">
149
- <span class="method-name">binmode</span><span class="method-args">()</span>
150
- </a>
151
- </div>
152
-
153
- <div class="method-description">
154
- <p>
155
- Calls IO#binmode
156
- </p>
157
- <p>
158
- Puts rio into binary mode. This is useful only in MS-DOS/Windows
159
- environments. Once a stream is in binary mode, it cannot be reset to
160
- nonbinary mode.
161
- </p>
162
- <p>
163
- Returns the Rio.
164
- </p>
165
- <pre>
166
- rio('afile.exe').binmode.bytes(512).to_a # read a file in 512 byte blocks
167
- </pre>
168
- </div>
169
- </div>
170
-
171
- <div id="method-M000030" class="method-detail">
172
- <a name="M000030"></a>
173
-
174
- <div class="method-heading">
175
- <a href="RubyIO.src/M000030.html" target="Code" class="method-signature"
176
- onclick="popupCode('RubyIO.src/M000030.html');return false;">
177
- <span class="method-name">close</span><span class="method-args">()</span>
178
- </a>
179
- </div>
180
-
181
- <div class="method-description">
182
- <p>
183
- Calls IO#close
184
- </p>
185
- <pre>
186
- ario.close =&gt; nil
187
- </pre>
188
- <p>
189
- Closes <em>ario</em> and flushes any pending writes to the operating
190
- system. The stream is unavailable for any further data operations; an
191
- <tt>IOError</tt> is raised if such an attempt is made. I/O streams are
192
- automatically closed when they are claimed by the garbage collector.
193
- </p>
194
- </div>
195
- </div>
196
-
197
- <div id="method-M000031" class="method-detail">
198
- <a name="M000031"></a>
199
-
200
- <div class="method-heading">
201
- <a href="RubyIO.src/M000031.html" target="Code" class="method-signature"
202
- onclick="popupCode('RubyIO.src/M000031.html');return false;">
203
- <span class="method-name">close_write</span><span class="method-args">()</span>
204
- </a>
205
- </div>
206
-
207
- <div class="method-description">
208
- </div>
209
- </div>
210
-
211
- <div id="method-M000010" class="method-detail">
212
- <a name="M000010"></a>
213
-
214
- <div class="method-heading">
215
- <a href="RubyIO.src/M000010.html" target="Code" class="method-signature"
216
- onclick="popupCode('RubyIO.src/M000010.html');return false;">
217
- <span class="method-name">each_byte</span><span class="method-args">(*args,&amp;block)</span>
218
- </a>
219
- </div>
220
-
221
- <div class="method-description">
222
- <p>
223
- Calls IO#each_byte
224
- </p>
225
- <pre>
226
- ario.each_byte {|byte| block } =&gt; ario
227
- </pre>
228
- <p>
229
- Calls the given block once for each byte (0..255) in <em>ario</em>, passing
230
- the byte as an argument.
231
- </p>
232
- </div>
233
- </div>
234
-
235
- <div id="method-M000011" class="method-detail">
236
- <a name="M000011"></a>
237
-
238
- <div class="method-heading">
239
- <a href="RubyIO.src/M000011.html" target="Code" class="method-signature"
240
- onclick="popupCode('RubyIO.src/M000011.html');return false;">
241
- <span class="method-name">each_line</span><span class="method-args">(*args,&amp;block)</span>
242
- </a>
243
- </div>
244
-
245
- <div class="method-description">
246
- <p>
247
- Calls IO#each_line
248
- </p>
249
- <pre>
250
- ario.each_line(sep_string=$/) {|line| block } =&gt; ario
251
- </pre>
252
- <p>
253
- Executes the block for every line in <em>ario</em>, where lines are
254
- separated by <em>sep_string</em>.
255
- </p>
256
- </div>
257
- </div>
258
-
259
- <div id="method-M000025" class="method-detail">
260
- <a name="M000025"></a>
261
-
262
- <div class="method-heading">
263
- <a href="RubyIO.src/M000025.html" target="Code" class="method-signature"
264
- onclick="popupCode('RubyIO.src/M000025.html');return false;">
265
- <span class="method-name">eof?</span><span class="method-args">()</span>
266
- </a>
267
- </div>
268
-
269
- <div class="method-description">
270
- <p>
271
- Calls IO#eof?
272
- </p>
273
- <pre>
274
- ario.eof =&gt; true or false
275
- </pre>
276
- <p>
277
- Returns true if <em>ario</em> is at end of file. The stream must be opened
278
- for reading or an <tt>IOError</tt> will be raised.
279
- </p>
280
- </div>
281
- </div>
282
-
283
- <div id="method-M000032" class="method-detail">
284
- <a name="M000032"></a>
285
-
286
- <div class="method-heading">
287
- <a href="RubyIO.src/M000032.html" target="Code" class="method-signature"
288
- onclick="popupCode('RubyIO.src/M000032.html');return false;">
289
- <span class="method-name">fcntl</span><span class="method-args">(integer_cmd,arg)</span>
290
- </a>
291
- </div>
292
-
293
- <div class="method-description">
294
- <p>
295
- Calls IO#fcntl
296
- </p>
297
- <pre>
298
- ario.fcntl(integer_cmd, arg) =&gt; integer
299
- </pre>
300
- <p>
301
- Provides a mechanism for issuing low-level commands to control or query
302
- file-oriented I/O streams. Arguments and results are platform dependent. If
303
- <em>arg</em> is a number, its value is passed directly. If it is a string,
304
- it is interpreted as a binary sequence of bytes (<tt>Array#pack</tt> might
305
- be a useful way to build this string). On Unix platforms, see
306
- <tt>fcntl(2)</tt> for details. Not implemented on all platforms.
307
- </p>
308
- </div>
309
- </div>
310
-
311
- <div id="method-M000034" class="method-detail">
312
- <a name="M000034"></a>
313
-
314
- <div class="method-heading">
315
- <a href="RubyIO.src/M000034.html" target="Code" class="method-signature"
316
- onclick="popupCode('RubyIO.src/M000034.html');return false;">
317
- <span class="method-name">fileno</span><span class="method-args">()</span>
318
- </a>
319
- </div>
320
-
321
- <div class="method-description">
322
- <p>
323
- Calls IO#fileno
324
- </p>
325
- <pre>
326
- ario.fileno =&gt; fixnum
327
- ario.to_i =&gt; fixnum
328
- </pre>
329
- <p>
330
- Returns an integer representing the numeric file descriptor for
331
- <em>ario</em>.
332
- </p>
333
- </div>
334
- </div>
335
-
336
- <div id="method-M000009" class="method-detail">
337
- <a name="M000009"></a>
338
-
339
- <div class="method-heading">
340
- <a href="RubyIO.src/M000009.html" target="Code" class="method-signature"
341
- onclick="popupCode('RubyIO.src/M000009.html');return false;">
342
- <span class="method-name">flush</span><span class="method-args">()</span>
343
- </a>
344
- </div>
345
-
346
- <div class="method-description">
347
- <p>
348
- Calls IO#flush
349
- </p>
350
- <pre>
351
- ario.flush =&gt; ario
352
- </pre>
353
- <p>
354
- Flushes any buffered data within <em>ario</em> to the underlying operating
355
- system (note that this is Ruby internal buffering only; the OS may buffer
356
- the data as well).
357
- </p>
358
- </div>
359
- </div>
360
-
361
- <div id="method-M000035" class="method-detail">
362
- <a name="M000035"></a>
363
-
364
- <div class="method-heading">
365
- <a href="RubyIO.src/M000035.html" target="Code" class="method-signature"
366
- onclick="popupCode('RubyIO.src/M000035.html');return false;">
367
- <span class="method-name">fsync</span><span class="method-args">()</span>
368
- </a>
369
- </div>
370
-
371
- <div class="method-description">
372
- <p>
373
- Calls IO#fsync
374
- </p>
375
- <pre>
376
- ario.fsync =&gt; ario
377
- </pre>
378
- <p>
379
- Immediately writes all buffered data in <em>ario</em> to disk and return
380
- <em>ario</em>. Does nothing if the underlying operating system does not
381
- support _fsync(2)_. Note that <tt>fsync</tt> differs from using <a
382
- href="RubyIO.html#M000042">sync</a>. The latter ensures that data is
383
- flushed from Ruby&#8217;s buffers, but doesn&#8217;t not guarantee that the
384
- underlying operating system actually writes it to disk.
385
- </p>
386
- </div>
387
- </div>
388
-
389
- <div id="method-M000037" class="method-detail">
390
- <a name="M000037"></a>
391
-
392
- <div class="method-heading">
393
- <a href="RubyIO.src/M000037.html" target="Code" class="method-signature"
394
- onclick="popupCode('RubyIO.src/M000037.html');return false;">
395
- <span class="method-name">getc</span><span class="method-args">()</span>
396
- </a>
397
- </div>
398
-
399
- <div class="method-description">
400
- <p>
401
- Calls IO#getc
402
- </p>
403
- <pre>
404
- ario.getc =&gt; fixnum or nil
405
- </pre>
406
- <p>
407
- Gets the next 8-bit byte (0..255) from <em>ario</em>. Returns <tt>nil</tt>
408
- if called at end of file.
409
- </p>
410
- <p>
411
- f = File.new(&quot;testfile&quot;) f.getc #=&gt; 84 f.getc #=&gt; 104
412
- </p>
413
- </div>
414
- </div>
415
-
416
- <div id="method-M000004" class="method-detail">
417
- <a name="M000004"></a>
418
-
419
- <div class="method-heading">
420
- <a href="RubyIO.src/M000004.html" target="Code" class="method-signature"
421
- onclick="popupCode('RubyIO.src/M000004.html');return false;">
422
- <span class="method-name">gets</span><span class="method-args">(sep_string=$/)</span>
423
- </a>
424
- </div>
425
-
426
- <div class="method-description">
427
- <p>
428
- Calls IO#gets
429
- </p>
430
- <p>
431
- Reads the next line from the Rio; lines are separated by sep_string. A
432
- separator of nil reads the entire contents, and a zero-length separator
433
- reads the input a paragraph at a time (two successive newlines in the input
434
- separate paragraphs).
435
- </p>
436
- <p>
437
- Returns nil if called at end of file.
438
- </p>
439
- <pre>
440
- astring = rio('afile.txt').gets # read the first line of afile.txt into astring
441
- </pre>
442
- </div>
443
- </div>
444
-
445
- <div id="method-M000033" class="method-detail">
446
- <a name="M000033"></a>
447
-
448
- <div class="method-heading">
449
- <a href="RubyIO.src/M000033.html" target="Code" class="method-signature"
450
- onclick="popupCode('RubyIO.src/M000033.html');return false;">
451
- <span class="method-name">ioctl</span><span class="method-args">(integer_cmd,arg)</span>
452
- </a>
453
- </div>
454
-
455
- <div class="method-description">
456
- <p>
457
- Calls IO#ioctl
458
- </p>
459
- <pre>
460
- ario.ioctl(integer_cmd, arg) =&gt; integer
461
- </pre>
462
- <p>
463
- Provides a mechanism for issuing low-level commands to control or query I/O
464
- devices. Arguments and results are platform dependent. If <em>arg</em> is a
465
- number, its value is passed directly. If it is a string, it is interpreted
466
- as a binary sequence of bytes. On Unix platforms, see +ioctl(2)+ for
467
- details. Not implemented on all platforms.
468
- </p>
469
- </div>
470
- </div>
471
-
472
- <div id="method-M000026" class="method-detail">
473
- <a name="M000026"></a>
474
-
475
- <div class="method-heading">
476
- <a href="RubyIO.src/M000026.html" target="Code" class="method-signature"
477
- onclick="popupCode('RubyIO.src/M000026.html');return false;">
478
- <span class="method-name">ioh</span><span class="method-args">(*args)</span>
479
- </a>
480
- </div>
481
-
482
- <div class="method-description">
483
- <p>
484
- Provides direct access to the IO handle (as would be returned by ::IO#new)
485
- <b>with</b> filtering. Reading from and writing to this handle will be
486
- affected by such things as <a href="GrandeStream.html#M000085">gzip</a> and
487
- <a href="GrandeStream.html#M000082">chomp</a> if they were specified for
488
- the Rio.
489
- </p>
490
- <p>
491
- Compare this with <a href="RubyIO.html#M000027">ios</a>
492
- </p>
493
- </div>
494
- </div>
495
-
496
- <div id="method-M000027" class="method-detail">
497
- <a name="M000027"></a>
498
-
499
- <div class="method-heading">
500
- <a href="RubyIO.src/M000027.html" target="Code" class="method-signature"
501
- onclick="popupCode('RubyIO.src/M000027.html');return false;">
502
- <span class="method-name">ios</span><span class="method-args">(*args)</span>
503
- </a>
504
- </div>
505
-
506
- <div class="method-description">
507
- <p>
508
- Provides direct access to the IO handle (as would be returned by ::IO#new)
509
- Reading from and writing to this handle is <b>not</b> affected by such
510
- things as <a href="GrandeStream.html#M000085">gzip</a> and <a
511
- href="GrandeStream.html#M000082">chomp</a>.
512
- </p>
513
- <p>
514
- Compare this with <a href="RubyIO.html#M000026">ioh</a>
515
- </p>
516
- </div>
517
- </div>
518
-
519
- <div id="method-M000005" class="method-detail">
520
- <a name="M000005"></a>
521
-
522
- <div class="method-heading">
523
- <a href="RubyIO.src/M000005.html" target="Code" class="method-signature"
524
- onclick="popupCode('RubyIO.src/M000005.html');return false;">
525
- <span class="method-name">lineno</span><span class="method-args">()</span>
526
- </a>
527
- </div>
528
-
529
- <div class="method-description">
530
- <p>
531
- Calls IO#lineno
532
- </p>
533
- <p>
534
- Returns the current line number of a Rio.
535
- </p>
536
- <p>
537
- The Rio will be opened for reading if not already. lineno counts the number
538
- of times gets is called, rather than the number of newlines encountered
539
- &#8212; so lineno will only be accurate if the file is read exclusively
540
- with line-oriented methods (<a href="RubyIO.html#M000013">readline</a>,
541
- IF::GrandeStream#each_line, <a href="RubyIO.html#M000004">gets</a> etc.)
542
- </p>
543
- <p>
544
- See also the $. variable and <a href="RubyIO.html#M000007">recno</a>
545
- </p>
546
- <pre>
547
- f = rio(&quot;testfile&quot;)
548
- f.lineno #=&gt; 0
549
- f.gets #=&gt; &quot;This is line one\n&quot;
550
- f.lineno #=&gt; 1
551
- f.gets #=&gt; &quot;This is line two\n&quot;
552
- f.lineno #=&gt; 2
553
- </pre>
554
- </div>
555
- </div>
556
-
557
- <div id="method-M000006" class="method-detail">
558
- <a name="M000006"></a>
559
-
560
- <div class="method-heading">
561
- <a href="RubyIO.src/M000006.html" target="Code" class="method-signature"
562
- onclick="popupCode('RubyIO.src/M000006.html');return false;">
563
- <span class="method-name">lineno=</span><span class="method-args">(integer)</span>
564
- </a>
565
- </div>
566
-
567
- <div class="method-description">
568
- <p>
569
- Calls IO#lineno=
570
- </p>
571
- <pre>
572
- ario.lineno = integer =&gt; integer
573
- </pre>
574
- <p>
575
- Manually sets the current line number to the given value. <tt>$.</tt> is
576
- updated only on the next read.
577
- </p>
578
- <p>
579
- f = rio(&quot;testfile&quot;) f.gets #=&gt; &quot;This is line one\n&quot;
580
- $. #=&gt; 1 f.lineno = 1000 f.lineno #=&gt; 1000 $. # lineno of last read
581
- #=&gt; 1 f.gets #=&gt; &quot;This is line two\n&quot; $. # lineno of last
582
- read #=&gt; 1001
583
- </p>
584
- </div>
585
- </div>
586
-
587
- <div id="method-M000028" class="method-detail">
588
- <a name="M000028"></a>
589
-
590
- <div class="method-heading">
591
- <a href="RubyIO.src/M000028.html" target="Code" class="method-signature"
592
- onclick="popupCode('RubyIO.src/M000028.html');return false;">
593
- <span class="method-name">mode</span><span class="method-args">(m,*args)</span>
594
- </a>
595
- </div>
596
-
597
- <div class="method-description">
598
- <p>
599
- Explicitly set the mode with which a Rio will be opened.
600
- </p>
601
- <pre>
602
- ario.mode('r+') =&gt; ario
603
- </pre>
604
- <p>
605
- Normally one needs never open a Rio or specify its mode &#8212; the mode is
606
- determined by the operation the Rio is asked to perform. (i.e. <a
607
- href="RubyIO.html#M000015">print</a> requires write access, <a
608
- href="RubyIO.html#M000012">readlines</a> requires read access). However
609
- there are times when one wishes to be specific about the mode with which a
610
- Rio will be opened. Note that explicitly setting the mode overrides all of
611
- Rio&#8217;s internal mode logic. If a mode is specified via <a
612
- href="RubyIO.html#M000028">mode</a> or <a
613
- href="FileOrDir.html#M000155">open</a> that mode will be used. Period.
614
- </p>
615
- <p>
616
- Returns the Rio.
617
- </p>
618
- <p>
619
- See also <a href="RubyIO.html#M000029">mode?</a>
620
- </p>
621
- <p>
622
- If the mode is given as a String, it must be one of the values listed in
623
- the following table.
624
- </p>
625
- <pre>
626
- Mode | Meaning
627
- -----+--------------------------------------------------------
628
- &quot;r&quot; | Read-only, starts at beginning of file (default mode).
629
- -----+--------------------------------------------------------
630
- &quot;r+&quot; | Read-write, starts at beginning of file.
631
- -----+--------------------------------------------------------
632
- &quot;w&quot; | Write-only, truncates existing file
633
- | to zero length or creates a new file for writing.
634
- -----+--------------------------------------------------------
635
- &quot;w+&quot; | Read-write, truncates existing file to zero length
636
- | or creates a new file for reading and writing.
637
- -----+--------------------------------------------------------
638
- &quot;a&quot; | Write-only, starts at end of file if file exists,
639
- | otherwise creates a new file for writing.
640
- -----+--------------------------------------------------------
641
- &quot;a+&quot; | Read-write, starts at end of file if file exists,
642
- | otherwise creates a new file for reading and
643
- | writing.
644
- -----+--------------------------------------------------------
645
- &quot;b&quot; | (DOS/Windows only) Binary file mode (may appear with
646
- | any of the key letters listed above).
647
-
648
- ario = rio('afile').mode('r+').nocloseoneof # file will be opened in r+ mode
649
- # don't want the file closed at eof
650
- ario.seek(apos).gets # read the string at apos in afile
651
- ario.rewind.gets # read the string at the beginning of the file
652
- ario.close
653
- </pre>
654
- <p>
655
- TODO:
656
- </p>
657
- <ul>
658
- <li>Add support for integer modes
659
-
660
- </li>
661
- </ul>
662
- </div>
663
- </div>
664
-
665
- <div id="method-M000029" class="method-detail">
666
- <a name="M000029"></a>
667
-
668
- <div class="method-heading">
669
- <a href="RubyIO.src/M000029.html" target="Code" class="method-signature"
670
- onclick="popupCode('RubyIO.src/M000029.html');return false;">
671
- <span class="method-name">mode?</span><span class="method-args">()</span>
672
- </a>
673
- </div>
674
-
675
- <div class="method-description">
676
- <p>
677
- Query a Rio&#8217;s mode
678
- </p>
679
- <pre>
680
- ario.mode? #=&gt; a mode string
681
- </pre>
682
- <p>
683
- See <a href="RubyIO.html#M000028">mode</a>
684
- </p>
685
- <pre>
686
- ario = rio('afile')
687
- ario.puts(&quot;Hello World&quot;)
688
- ario.mode? #=&gt; 'w' IF::RubyIO#puts requires write access
689
-
690
- ario = rio('afile')
691
- ario.gets
692
- ario.mode? #=&gt; 'r' IF::RubyIO#gets requires read access
693
-
694
- ario = rio('afile').mode('w+').nocloseoneof
695
- ario.gets
696
- ario.mode? #=&gt; 'w+' Set explictly
697
- </pre>
698
- </div>
699
- </div>
700
-
701
- <div id="method-M000043" class="method-detail">
702
- <a name="M000043"></a>
703
-
704
- <div class="method-heading">
705
- <a href="RubyIO.src/M000043.html" target="Code" class="method-signature"
706
- onclick="popupCode('RubyIO.src/M000043.html');return false;">
707
- <span class="method-name">nosync</span><span class="method-args">(arg=false,&amp;block)</span>
708
- </a>
709
- </div>
710
-
711
- <div class="method-description">
712
- <p>
713
- Similar to IO#sync= false
714
- </p>
715
- <pre>
716
- ario.nosync(&amp;block) =&gt; ario
717
- </pre>
718
- <p>
719
- Sets the Rio so that its &#8216;sync mode&#8217; will be set to
720
- <tt>false</tt> when opened, or set it immediately if already open. When
721
- sync mode is true, all output is immediately flushed to the underlying
722
- operating system and is not buffered internally. Returns the rio. See also
723
- <a href="RubyIO.html#M000035">fsync</a>, <a
724
- href="RubyIO.html#M000042">sync</a>, <a
725
- href="RubyIO.html#M000044">sync?</a>.
726
- </p>
727
- <p>
728
- If a block is given behaves like <tt>ario.nosync.each(&amp;block)</tt>
729
- </p>
730
- <pre>
731
- f = rio(&quot;testfile&quot;).sync.puts(&quot;Hello World&quot;)
732
- f.sync? # =&gt; true
733
- f.nosync
734
- f.sync? # =&gt; false
735
- </pre>
736
- </div>
737
- </div>
738
-
739
- <div id="method-M000036" class="method-detail">
740
- <a name="M000036"></a>
741
-
742
- <div class="method-heading">
743
- <a href="RubyIO.src/M000036.html" target="Code" class="method-signature"
744
- onclick="popupCode('RubyIO.src/M000036.html');return false;">
745
- <span class="method-name">pid</span><span class="method-args">()</span>
746
- </a>
747
- </div>
748
-
749
- <div class="method-description">
750
- <p>
751
- Calls IO#pid
752
- </p>
753
- <pre>
754
- ario.pid =&gt; fixnum
755
- </pre>
756
- <p>
757
- Returns the process ID of a child process associated with <em>ario</em>.
758
- This will be set by <tt>IO::popen</tt>.
759
- </p>
760
- <pre>
761
- pipe = IO.popen(&quot;-&quot;)
762
- if pipe
763
- $stderr.puts &quot;In parent, child pid is #{pipe.pid}&quot;
764
- else
765
- $stderr.puts &quot;In child, pid is #{$$}&quot;
766
- end
767
- </pre>
768
- <p>
769
- produces:
770
- </p>
771
- <pre>
772
- In child, pid is 26209
773
- In parent, child pid is 26209
774
- </pre>
775
- </div>
776
- </div>
777
-
778
- <div id="method-M000015" class="method-detail">
779
- <a name="M000015"></a>
780
-
781
- <div class="method-heading">
782
- <a href="RubyIO.src/M000015.html" target="Code" class="method-signature"
783
- onclick="popupCode('RubyIO.src/M000015.html');return false;">
784
- <span class="method-name">print</span><span class="method-args">(*args,&amp;block)</span>
785
- </a>
786
- </div>
787
-
788
- <div class="method-description">
789
- <p>
790
- Calls IO::print
791
- </p>
792
- <p>
793
- Writes the given object(s) to the Rio. If the output record separator ($\)
794
- is not nil, it will be appended to the output. If no arguments are given,
795
- prints $_. Objects that aren&#8217;t strings will be converted by calling
796
- their to_s method. Returns the Rio.
797
- </p>
798
- <pre>
799
- rio('f.txt').print(&quot;Hello Rio\n&quot;) # print the string to f.txt
800
- rio(?-).print(&quot;Hello Rio\n&quot;) # print the string to stdout
801
- </pre>
802
- </div>
803
- </div>
804
-
805
- <div id="method-M000016" class="method-detail">
806
- <a name="M000016"></a>
807
-
808
- <div class="method-heading">
809
- <a href="RubyIO.src/M000016.html" target="Code" class="method-signature"
810
- onclick="popupCode('RubyIO.src/M000016.html');return false;">
811
- <span class="method-name">print!</span><span class="method-args">(*args,&amp;block)</span>
812
- </a>
813
- </div>
814
-
815
- <div class="method-description">
816
- <p>
817
- Writes the given objects to the rio as with <a
818
- href="RubyIO.html#M000015">print</a> and then closes the Rio. Returns the
819
- Rio.
820
- </p>
821
- <p>
822
- Equivalent to rio.print(*args).close
823
- </p>
824
- <pre>
825
- rio('f.txt').print!(&quot;Hello Rio\n&quot;) # print the string to f.txt then close it
826
- </pre>
827
- </div>
828
- </div>
829
-
830
- <div id="method-M000018" class="method-detail">
831
- <a name="M000018"></a>
832
-
833
- <div class="method-heading">
834
- <a href="RubyIO.src/M000018.html" target="Code" class="method-signature"
835
- onclick="popupCode('RubyIO.src/M000018.html');return false;">
836
- <span class="method-name">printf</span><span class="method-args">(*argv)</span>
837
- </a>
838
- </div>
839
-
840
- <div class="method-description">
841
- <p>
842
- Calls IO#printf
843
- </p>
844
- <pre>
845
- ario.printf(format_string [, obj, ...] ) =&gt; ario
846
- </pre>
847
- <p>
848
- Formats and writes to <em>ario</em>, converting parameters under control of
849
- the format string. See +Kernel#sprintf+ for details.
850
- </p>
851
- </div>
852
- </div>
853
-
854
- <div id="method-M000017" class="method-detail">
855
- <a name="M000017"></a>
856
-
857
- <div class="method-heading">
858
- <a href="RubyIO.src/M000017.html" target="Code" class="method-signature"
859
- onclick="popupCode('RubyIO.src/M000017.html');return false;">
860
- <span class="method-name">printf!</span><span class="method-args">(*argv)</span>
861
- </a>
862
- </div>
863
-
864
- <div class="method-description">
865
- <p>
866
- Writes the given objects to the rio as with <a
867
- href="RubyIO.html#M000018">printf</a> and then closes the rio. Returns the
868
- rio.
869
- </p>
870
- <p>
871
- Equivalent to rio.printf(*args).close
872
- </p>
873
- </div>
874
- </div>
875
-
876
- <div id="method-M000020" class="method-detail">
877
- <a name="M000020"></a>
878
-
879
- <div class="method-heading">
880
- <a href="RubyIO.src/M000020.html" target="Code" class="method-signature"
881
- onclick="popupCode('RubyIO.src/M000020.html');return false;">
882
- <span class="method-name">putc</span><span class="method-args">(*argv)</span>
883
- </a>
884
- </div>
885
-
886
- <div class="method-description">
887
- <p>
888
- Calls IO#putc
889
- </p>
890
- <pre>
891
- ario.putc(obj) =&gt; ario
892
- </pre>
893
- <p>
894
- If <em>obj</em> is <tt>Numeric</tt>, write the character whose code is
895
- <em>obj</em>, otherwise write the first character of the string
896
- representation of <em>obj</em> to <em>ario</em>.
897
- </p>
898
- <pre>
899
- stdout = rio(?-)
900
- stdout.putc &quot;A&quot;
901
- stdout.putc 65
902
- </pre>
903
- <p>
904
- _produces:_
905
- </p>
906
- <pre>
907
- AA
908
- </pre>
909
- </div>
910
- </div>
911
-
912
- <div id="method-M000019" class="method-detail">
913
- <a name="M000019"></a>
914
-
915
- <div class="method-heading">
916
- <a href="RubyIO.src/M000019.html" target="Code" class="method-signature"
917
- onclick="popupCode('RubyIO.src/M000019.html');return false;">
918
- <span class="method-name">putc!</span><span class="method-args">(*argv)</span>
919
- </a>
920
- </div>
921
-
922
- <div class="method-description">
923
- <p>
924
- Writes the given objects to the rio as with <a
925
- href="RubyIO.html#M000020">putc</a> and then closes the rio. Returns the
926
- rio.
927
- </p>
928
- <p>
929
- Equivalent to rio.putc(*args).close
930
- </p>
931
- </div>
932
- </div>
933
-
934
- <div id="method-M000021" class="method-detail">
935
- <a name="M000021"></a>
936
-
937
- <div class="method-heading">
938
- <a href="RubyIO.src/M000021.html" target="Code" class="method-signature"
939
- onclick="popupCode('RubyIO.src/M000021.html');return false;">
940
- <span class="method-name">puts</span><span class="method-args">(*args)</span>
941
- </a>
942
- </div>
943
-
944
- <div class="method-description">
945
- <p>
946
- Calls IO#puts
947
- </p>
948
- <p>
949
- Writes the given objects to the rio as with <a
950
- href="RubyIO.html#M000015">print</a>. Writes a record separator (typically
951
- a newline) after any that do not already end with a newline sequence. If
952
- called with an array argument, writes each element on a new line. If called
953
- without arguments, outputs a single record separator. Returns the rio.
954
- </p>
955
- </div>
956
- </div>
957
-
958
- <div id="method-M000022" class="method-detail">
959
- <a name="M000022"></a>
960
-
961
- <div class="method-heading">
962
- <a href="RubyIO.src/M000022.html" target="Code" class="method-signature"
963
- onclick="popupCode('RubyIO.src/M000022.html');return false;">
964
- <span class="method-name">puts!</span><span class="method-args">(*args)</span>
965
- </a>
966
- </div>
967
-
968
- <div class="method-description">
969
- <p>
970
- Writes the given objects to the rio as with <a
971
- href="RubyIO.html#M000021">puts</a> and then closes the rio. Returns the
972
- rio.
973
- </p>
974
- <p>
975
- Equivalent to rio.puts(*args).close
976
- </p>
977
- <pre>
978
- rio('f.txt').puts!('Hello Rio') # print the string to f.txt then close it
979
- </pre>
980
- </div>
981
- </div>
982
-
983
- <div id="method-M000013" class="method-detail">
984
- <a name="M000013"></a>
985
-
986
- <div class="method-heading">
987
- <a href="RubyIO.src/M000013.html" target="Code" class="method-signature"
988
- onclick="popupCode('RubyIO.src/M000013.html');return false;">
989
- <span class="method-name">readline</span><span class="method-args">(*args)</span>
990
- </a>
991
- </div>
992
-
993
- <div class="method-description">
994
- <p>
995
- Calls IO#readline
996
- </p>
997
- <pre>
998
- ario.readline(sep_string=$/) =&gt; string
999
- </pre>
1000
- <p>
1001
- Reads a line as with +IO#gets+, but raises an <tt>EOFError</tt> on end of
1002
- file.
1003
- </p>
1004
- </div>
1005
- </div>
1006
-
1007
- <div id="method-M000012" class="method-detail">
1008
- <a name="M000012"></a>
1009
-
1010
- <div class="method-heading">
1011
- <a href="RubyIO.src/M000012.html" target="Code" class="method-signature"
1012
- onclick="popupCode('RubyIO.src/M000012.html');return false;">
1013
- <span class="method-name">readlines</span><span class="method-args">(*args,&amp;block)</span>
1014
- </a>
1015
- </div>
1016
-
1017
- <div class="method-description">
1018
- <p>
1019
- Calls IO#readlines
1020
- </p>
1021
- <p>
1022
- Reads all of the lines in a Rio, and returns them in anArray. Lines are
1023
- separated by the optional aSepString. The stream must be opened for reading
1024
- or an IOerror will be raised.
1025
- </p>
1026
- <pre>
1027
- an_array = rio('afile.txt').readlines # read afile.txt into an array
1028
- an_array = rio('afile.txt').chomp.readlines # read afile.txt into an array with each line chomped
1029
- </pre>
1030
- </div>
1031
- </div>
1032
-
1033
- <div id="method-M000014" class="method-detail">
1034
- <a name="M000014"></a>
1035
-
1036
- <div class="method-heading">
1037
- <a href="RubyIO.src/M000014.html" target="Code" class="method-signature"
1038
- onclick="popupCode('RubyIO.src/M000014.html');return false;">
1039
- <span class="method-name">readpartial</span><span class="method-args">(*args)</span>
1040
- </a>
1041
- </div>
1042
-
1043
- <div class="method-description">
1044
- <p>
1045
- Calls IO#readpartial
1046
- </p>
1047
- <p>
1048
- Reads at most maxlen bytes from the I/O stream but it blocks only if ios
1049
- has no data immediately available. If the optional outbuf argument is
1050
- present, it must reference a String, which will receive the data. It raises
1051
- EOFError on end of file.
1052
- </p>
1053
- <p>
1054
- readpartial is designed for streams such as pipe, socket, tty, etc. It
1055
- blocks only when no data immediately available. This means that it blocks
1056
- only when following all conditions hold.
1057
- </p>
1058
- <ul>
1059
- <li>the buffer in the IO object is empty.
1060
-
1061
- </li>
1062
- <li>the content of the stream is empty.
1063
-
1064
- </li>
1065
- <li>the stream is not reached to EOF.
1066
-
1067
- </li>
1068
- </ul>
1069
- <p>
1070
- When readpartial blocks, it waits data or EOF on the stream. If some data
1071
- is reached, readpartial returns with the data. If EOF is reached,
1072
- readpartial raises EOFError.
1073
- </p>
1074
- <p>
1075
- When readpartial doesn�t blocks, it returns or raises immediately. If the
1076
- buffer is not empty, it returns the data in the buffer. Otherwise if the
1077
- stream has some content, it returns the data in the stream. Otherwise if
1078
- the stream is reached to EOF, it raises EOFError.
1079
- </p>
1080
- <pre>
1081
- r, w = IO.pipe # buffer pipe content
1082
- w &lt;&lt; &quot;abc&quot; # &quot;&quot; &quot;abc&quot;.
1083
- r.readpartial(4096) #=&gt; &quot;abc&quot; &quot;&quot; &quot;&quot;
1084
- r.readpartial(4096) # blocks because buffer and pipe is empty.
1085
-
1086
- r, w = IO.pipe # buffer pipe content
1087
- w &lt;&lt; &quot;abc&quot; # &quot;&quot; &quot;abc&quot;
1088
- w.close # &quot;&quot; &quot;abc&quot; EOF
1089
- r.readpartial(4096) #=&gt; &quot;abc&quot; &quot;&quot; EOF
1090
- r.readpartial(4096) # raises EOFError
1091
-
1092
- r, w = IO.pipe # buffer pipe content
1093
- w &lt;&lt; &quot;abc\ndef\n&quot; # &quot;&quot; &quot;abc\ndef\n&quot;
1094
- r.gets #=&gt; &quot;abc\n&quot; &quot;def\n&quot; &quot;&quot;
1095
- w &lt;&lt; &quot;ghi\n&quot; # &quot;def\n&quot; &quot;ghi\n&quot;
1096
- r.readpartial(4096) #=&gt; &quot;def\n&quot; &quot;&quot; &quot;ghi\n&quot;
1097
- r.readpartial(4096) #=&gt; &quot;ghi\n&quot; &quot;&quot; &quot;&quot;
1098
- </pre>
1099
- <p>
1100
- Note that readpartial is nonblocking-flag insensitive. It blocks even if
1101
- the nonblocking-flag is set.
1102
- </p>
1103
- <p>
1104
- Also note that readpartial behaves similar to sysread in blocking mode. The
1105
- behavior is identical when the buffer is empty. ios.reopen(other_IO) =&gt;
1106
- ios ios.reopen(path, mode_str) =&gt; ios
1107
- </p>
1108
- <p>
1109
- Reassociates ios with the I/O stream given in other_IO or to a new stream
1110
- opened on path. This may dynamically change the actual class of this
1111
- stream.
1112
- </p>
1113
- <pre>
1114
- f1 = File.new(&quot;testfile&quot;)
1115
- f2 = File.new(&quot;testfile&quot;)
1116
- f2.readlines[0] #=&gt; &quot;This is line one\n&quot;
1117
- f2.reopen(f1) #=&gt; #&lt;File:testfile&gt;
1118
- f2.readlines[0] #=&gt; &quot;This is line one\n&quot;
1119
- </pre>
1120
- </div>
1121
- </div>
1122
-
1123
- <div id="method-M000007" class="method-detail">
1124
- <a name="M000007"></a>
1125
-
1126
- <div class="method-heading">
1127
- <a href="RubyIO.src/M000007.html" target="Code" class="method-signature"
1128
- onclick="popupCode('RubyIO.src/M000007.html');return false;">
1129
- <span class="method-name">recno</span><span class="method-args">()</span>
1130
- </a>
1131
- </div>
1132
-
1133
- <div class="method-description">
1134
- <p>
1135
- Returns the current record number of a Rio. The <tt>recno</tt> is the index
1136
- used by the grande selection methods. It represents the zero-based index of
1137
- the last record read. Returns nil until a record has been read.
1138
- </p>
1139
- <p>
1140
- see <a href="GrandeStream.html#M000055">lines</a> <a
1141
- href="GrandeStream.html#M000056">bytes</a> and <a
1142
- href="GrandeStream.html#M000057">records</a>
1143
- </p>
1144
- <p>
1145
- To illustrate: Given a file containing three lines
1146
- &quot;L0\n&quot;,&quot;L1\n&quot;,&quot;L2\n&quot; and a Range (0..1) Each
1147
- of the following would fill anarray with [&quot;L0\n&quot;,
1148
- &quot;L1\n&quot;]
1149
- </p>
1150
- <p>
1151
- Given:
1152
- </p>
1153
- <pre>
1154
- anarray = []
1155
- range = (0..1)
1156
-
1157
- all_lines = rio('afile').readlines
1158
- all_lines.each_with_index do |line,i|
1159
- anarray &lt;&lt; line if range === i
1160
- end
1161
- # anarray == [&quot;L0\n&quot;, &quot;L1\n&quot;]
1162
-
1163
- anarray = rio('afile').lines[0..1] # anarray == [&quot;L0\n&quot;, &quot;L1\n&quot;]
1164
- </pre>
1165
- <p>
1166
- <tt>recno</tt> counts the number of times IF::Grande#getrec or <a
1167
- href="Grande.html#M000090">each</a> is used to get a record. so
1168
- <tt>recno</tt> will only concern parts of the file read with grande methods
1169
- <a href="Grande.html#M000090">each</a>, <a
1170
- href="Grande.html#M000089">[]</a>, IF::Grande#getrec
1171
- </p>
1172
- <p>
1173
- See also <a href="RubyIO.html#M000005">lineno</a>
1174
- </p>
1175
- </div>
1176
- </div>
1177
-
1178
- <div id="method-M000042" class="method-detail">
1179
- <a name="M000042"></a>
1180
-
1181
- <div class="method-heading">
1182
- <a href="RubyIO.src/M000042.html" target="Code" class="method-signature"
1183
- onclick="popupCode('RubyIO.src/M000042.html');return false;">
1184
- <span class="method-name">sync</span><span class="method-args">(arg=true,&amp;block)</span>
1185
- </a>
1186
- </div>
1187
-
1188
- <div class="method-description">
1189
- <p>
1190
- Sets the &#8216;sync-mode&#8217; of the underlying IO using IO#sync=
1191
- </p>
1192
- <pre>
1193
- ario.sync(boolean=true,&amp;block) =&gt; ario
1194
- </pre>
1195
- <p>
1196
- Sets the Rio so that its &#8216;sync mode&#8217; will be set to
1197
- <tt>true</tt> or <tt>false</tt> when opened, or set it immediately if
1198
- already open. When sync mode is true, all output is immediately flushed to
1199
- the underlying operating system and is not buffered internally. Returns the
1200
- rio. See also <a href="RubyIO.html#M000035">fsync</a>, <a
1201
- href="RubyIO.html#M000043">nosync</a>, <a
1202
- href="RubyIO.html#M000044">sync?</a>.
1203
- </p>
1204
- <p>
1205
- If a block is given behaves like <tt>ario.sync(arg).each(&amp;block)</tt>
1206
- </p>
1207
- <pre>
1208
- f = rio(&quot;testfile&quot;).sync.puts(&quot;Hello World&quot;)
1209
- f.sync? # =&gt; true
1210
- </pre>
1211
- </div>
1212
- </div>
1213
-
1214
- <div id="method-M000044" class="method-detail">
1215
- <a name="M000044"></a>
1216
-
1217
- <div class="method-heading">
1218
- <a href="RubyIO.src/M000044.html" target="Code" class="method-signature"
1219
- onclick="popupCode('RubyIO.src/M000044.html');return false;">
1220
- <span class="method-name">sync?</span><span class="method-args">()</span>
1221
- </a>
1222
- </div>
1223
-
1224
- <div class="method-description">
1225
- <p>
1226
- Query the current &quot;sync mode&quot; with IO#sync
1227
- </p>
1228
- <pre>
1229
- ario.sync? =&gt; true or false
1230
- </pre>
1231
- <p>
1232
- Returns the current &quot;sync mode&quot; of <em>ario</em>. When sync mode
1233
- is true, all output is immediately flushed to the underlying operating
1234
- system and is not buffered by Ruby internally. See also <a
1235
- href="RubyIO.html#M000035">fsync</a>, <a
1236
- href="RubyIO.html#M000042">sync</a>, <a
1237
- href="RubyIO.html#M000043">nosync</a>
1238
- </p>
1239
- <pre>
1240
- f = rio(&quot;testfile&quot;)
1241
- f.sync? #=&gt; false
1242
- </pre>
1243
- </div>
1244
- </div>
1245
-
1246
- <div id="method-M000038" class="method-detail">
1247
- <a name="M000038"></a>
1248
-
1249
- <div class="method-heading">
1250
- <a href="RubyIO.src/M000038.html" target="Code" class="method-signature"
1251
- onclick="popupCode('RubyIO.src/M000038.html');return false;">
1252
- <span class="method-name">to_i</span><span class="method-args">()</span>
1253
- </a>
1254
- </div>
1255
-
1256
- <div class="method-description">
1257
- <p>
1258
- Calls IO#to_i
1259
- </p>
1260
- <pre>
1261
- to_i()
1262
- </pre>
1263
- <p>
1264
- Alias for <a href="RubyIO.html#M000034">fileno</a>
1265
- </p>
1266
- </div>
1267
- </div>
1268
-
1269
- <div id="method-M000039" class="method-detail">
1270
- <a name="M000039"></a>
1271
-
1272
- <div class="method-heading">
1273
- <a href="RubyIO.src/M000039.html" target="Code" class="method-signature"
1274
- onclick="popupCode('RubyIO.src/M000039.html');return false;">
1275
- <span class="method-name">to_io</span><span class="method-args">()</span>
1276
- </a>
1277
- </div>
1278
-
1279
- <div class="method-description">
1280
- <p>
1281
- Calls IO#to_io
1282
- </p>
1283
- <pre>
1284
- ario.to_io -&gt; ios
1285
- </pre>
1286
- <p>
1287
- Returns <em>ario</em>.
1288
- </p>
1289
- </div>
1290
- </div>
1291
-
1292
- <div id="method-M000040" class="method-detail">
1293
- <a name="M000040"></a>
1294
-
1295
- <div class="method-heading">
1296
- <a href="RubyIO.src/M000040.html" target="Code" class="method-signature"
1297
- onclick="popupCode('RubyIO.src/M000040.html');return false;">
1298
- <span class="method-name">tty?</span><span class="method-args">()</span>
1299
- </a>
1300
- </div>
1301
-
1302
- <div class="method-description">
1303
- <p>
1304
- Calls IO#tty?
1305
- </p>
1306
- <pre>
1307
- ario.tty? =&gt; true or false
1308
- </pre>
1309
- <p>
1310
- Returns <tt>true</tt> if <em>ario</em> is associated with a terminal device
1311
- (tty), <tt>false</tt> otherwise.
1312
- </p>
1313
- <pre>
1314
- rio(&quot;testfile&quot;).tty? #=&gt; false
1315
- rio(&quot;/dev/tty&quot;).tty? #=&gt; true
1316
- </pre>
1317
- </div>
1318
- </div>
1319
-
1320
- <div id="method-M000041" class="method-detail">
1321
- <a name="M000041"></a>
1322
-
1323
- <div class="method-heading">
1324
- <a href="RubyIO.src/M000041.html" target="Code" class="method-signature"
1325
- onclick="popupCode('RubyIO.src/M000041.html');return false;">
1326
- <span class="method-name">ungetc</span><span class="method-args">(*args)</span>
1327
- </a>
1328
- </div>
1329
-
1330
- <div class="method-description">
1331
- <p>
1332
- Calls IO#ungetc
1333
- </p>
1334
- <pre>
1335
- ario.ungetc(integer) =&gt; ario
1336
- </pre>
1337
- <p>
1338
- Pushes back one character (passed as a parameter) onto <em>ario</em>, such
1339
- that a subsequent buffered read will return it. Only one character may be
1340
- pushed back before a subsequent read operation (that is, you will be able
1341
- to read only the last of several characters that have been pushed back).
1342
- </p>
1343
- <pre>
1344
- f = rio(&quot;testfile&quot;) #=&gt; #&lt;Rio:testfile&gt;
1345
- c = f.getc #=&gt; 84
1346
- f.ungetc(c).getc #=&gt; 84
1347
- </pre>
1348
- </div>
1349
- </div>
1350
-
1351
- <div id="method-M000024" class="method-detail">
1352
- <a name="M000024"></a>
1353
-
1354
- <div class="method-heading">
1355
- <a href="RubyIO.src/M000024.html" target="Code" class="method-signature"
1356
- onclick="popupCode('RubyIO.src/M000024.html');return false;">
1357
- <span class="method-name">write</span><span class="method-args">(*argv)</span>
1358
- </a>
1359
- </div>
1360
-
1361
- <div class="method-description">
1362
- <p>
1363
- Calls IO#write
1364
- </p>
1365
- <pre>
1366
- ario.write(string) =&gt; integer
1367
- </pre>
1368
- <p>
1369
- Writes the given string to <em>ario</em>. If the argument is not a string,
1370
- it will be converted to a string using <tt>to_s</tt>. Returns the number of
1371
- bytes written.
1372
- </p>
1373
- </div>
1374
- </div>
1375
-
1376
- <div id="method-M000023" class="method-detail">
1377
- <a name="M000023"></a>
1378
-
1379
- <div class="method-heading">
1380
- <a href="RubyIO.src/M000023.html" target="Code" class="method-signature"
1381
- onclick="popupCode('RubyIO.src/M000023.html');return false;">
1382
- <span class="method-name">write!</span><span class="method-args">(*argv)</span>
1383
- </a>
1384
- </div>
1385
-
1386
- <div class="method-description">
1387
- <p>
1388
- Writes the given objects to the rio as with <a
1389
- href="RubyIO.html#M000024">write</a> and then closes the rio.
1390
- </p>
1391
- <p>
1392
- Equivalent to
1393
- </p>
1394
- <pre>
1395
- ario.write(*args)
1396
- ario.close
1397
- </pre>
1398
- </div>
1399
- </div>
1400
-
1401
-
1402
- </div>
1403
- </div>
1404
-
1405
-
1406
- </div>
1407
-
1408
-
1409
- <div id="validator-badges">
1410
- <p><small>Copyright &copy; 2005,2006,2007 Christopher Kleckner. <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
1411
- </div>
1412
-
1413
- </body>
1414
- </html>