OSDN Git Service

(root) / ring-lang-081 / ring.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
タグを打ち忘れていたついでに、html版ドキュメントを追加しました。
[ring-lang-081/ring.git] / docs / build / html / files.html
diff --git a/docs/build/html/files.html b/docs/build/html/files.html
new file mode 100644 (file)
index 0000000..236a924
--- /dev/null
+++ b/docs/build/html/files.html
@@ -0,0 +1,696 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    
+    <title>ファイル &mdash; プログラミング言語 Ring 1.12 取扱説明書</title>
+    
+    <link rel="stylesheet" href="_static/bootstrap-astropy.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    './',
+        VERSION:     '1.12',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <script type="text/javascript" src="_static/translations.js"></script>
+    <link rel="top" title="プログラミング言語 Ring 1.12 取扱説明書" href="index.html" />
+    <link rel="next" title="システム関数" href="systemfunc.html" />
+    <link rel="prev" title="算術関数" href="mathfunc.html" />
+    <link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:200,600' rel='stylesheet' type='text/css'/>
+
+  </head>
+  <body role="document">
+<div class="topbar">
+  <a class="brand" title="Documentation Home" href="index.html"><span id="logotext1">&#x1f369;Ring</span><span id="logotext2"> 1.12</span><span id="logotext3">:docs</span></a>
+  <ul>
+    
+    <li><a href="http://ring-lang.sourceforge.net/news.html">News</a></li>
+    <li><a href="http://ring-lang.sourceforge.net/download.html">Download</a></li>
+    <li><a href="https://groups.google.com/forum/#!forum/ring-lang">Get Help</a></li>
+    <li><a href="https://github.com/ring-lang/ring">Contribute</a></li>
+    <li><a href="http://ring-lang.sourceforge.net/resources.html">Resources</a></li>
+    <li><a href="http://ring-lang.sourceforge.net/team.html">Team</a></li>
+    
+    <li><a title="Ring Homepage" href="http://ring-lang.net/">Website</a></li>
+    <li><a title="総合索引" href="genindex.html">Index</a></li>
+    <li>
+      
+      
+<form action="search.html" method="get">
+  <input type="text" name="q" placeholder="Search" />
+  <input type="hidden" name="check_keywords" value="yes" />
+  <input type="hidden" name="area" value="default" />
+</form>
+      
+    </li>
+  </ul>
+</div>
+
+<div class="related">
+    <h3>ナビゲーション</h3>
+    <ul>
+      <li class="right">
+       <a href="systemfunc.html" title="システム関数">
+         next &raquo;
+       </a>
+      </li>
+      <li class="right">
+       <a href="mathfunc.html" title="算術関数">
+         &laquo; previous
+       </a>
+        |
+      </li>
+      <li>
+       <a href="index.html">プログラミング言語 Ring 1.12 取扱説明書</a>
+        &raquo;
+      </li>
+      
+      <li>ファイル</li> 
+    </ul>
+</div>
+  
+
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body" role="main">
+            
+  <div class="section" id="index-0">
+<span id="id1"></span><h1>ファイル<a class="headerlink" href="#index-0" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<p>ファイル関数の用法を学びます。</p>
+<ul class="simple">
+<li>Read()</li>
+<li>Write()</li>
+<li>Dir()</li>
+<li>Rename()</li>
+<li>Remove()</li>
+<li>fopen()</li>
+<li>fclose()</li>
+<li>fflush()</li>
+<li>freopen()</li>
+<li>tempfile()</li>
+<li>tempname()</li>
+<li>fseek()</li>
+<li>ftell()</li>
+<li>rewind()</li>
+<li>fgetpos()</li>
+<li>fsetpos()</li>
+<li>clearerr()</li>
+<li>feof()</li>
+<li>ferror()</li>
+<li>perror()</li>
+<li>fgetc()</li>
+<li>fgets()</li>
+<li>fputc()</li>
+<li>fputs()</li>
+<li>ungetc()</li>
+<li>fread()</li>
+<li>fwrite()</li>
+<li>fexists()</li>
+<li>数値とバイト</li>
+</ul>
+<div class="section" id="read">
+<span id="index-1"></span><h2>Read() 関数<a class="headerlink" href="#read" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Read() 関数はファイルの内容を読み取ります。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Read(cFileName) ---&gt; 文字列はファイルの内容を有しています。
+</pre></div>
+</div>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="n">read</span><span class="p">(</span><span class="s">&quot;myfile.txt&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Read() 関数はバイナリファイルの読み取りもできます。</p>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="n">read</span><span class="p">(</span><span class="s">&quot;myapp.exe&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="write">
+<span id="index-2"></span><h2>Write() 関数<a class="headerlink" href="#write" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Write() 関数は文字列をファイルへ書き込みます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Write</span><span class="p">(</span><span class="n">cFileName</span><span class="p">,</span><span class="n">cString</span><span class="p">)</span>        <span class="c"># 文字列 cString をファイル cFileName へ書き込みます。</span>
+</pre></div>
+</div>
+<p>Write() 関数はバイナリファイルの書き込みもできます。</p>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="c"># ファイルのコピー</span>
+<span class="n">cFile</span> <span class="o">=</span> <span class="n">read</span><span class="p">(</span><span class="s">&quot;ring.exe&quot;</span><span class="p">)</span>
+<span class="n">write</span><span class="p">(</span><span class="s">&quot;ring2.exe&quot;</span><span class="p">,</span><span class="n">cFile</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="dir">
+<span id="index-3"></span><h2>Dir() 関数<a class="headerlink" href="#dir" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Dir() 関数はフォルダの内容 (ファイルとサブフォルダ) を取得します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Dir(cFolderPath) ---&gt; リストはファイルとサブフォルダを有しています。
+</pre></div>
+</div>
+<p>この関数はリストを返します。リストごとの項目は二つの項目を有するリストになります。</p>
+<ul class="simple">
+<li>ファイル / サブフォルダの名前</li>
+<li>種類 (0 = ファイル , 1 = フォルダ、ディレクトリ)</li>
+</ul>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="s">&quot;Testing DIR() &quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">mylist</span> <span class="o">=</span> <span class="n">dir</span><span class="p">(</span><span class="s">&quot;C:\myfolder&quot;</span><span class="p">)</span>
+<span class="k">for</span> <span class="n">x</span> <span class="k">in</span> <span class="n">mylist</span>
+        <span class="k">if</span> <span class="n">x</span><span class="o">[</span><span class="mi">2</span><span class="o">]</span>
+                <span class="k">see</span> <span class="s">&quot;Directory : &quot;</span> <span class="o">+</span> <span class="n">x</span><span class="o">[</span><span class="mi">1</span><span class="o">]</span> <span class="o">+</span> <span class="n">nl</span>
+        <span class="k">else</span>
+                <span class="k">see</span> <span class="s">&quot;File : &quot;</span> <span class="o">+</span> <span class="n">x</span><span class="o">[</span><span class="mi">1</span><span class="o">]</span> <span class="o">+</span> <span class="n">nl</span>
+        <span class="k">ok</span>
+<span class="k">next</span>
+<span class="k">see</span> <span class="s">&quot;Files count : &quot;</span> <span class="o">+</span> <span class="n">len</span><span class="p">(</span><span class="n">mylist</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="rename">
+<span id="index-4"></span><h2>Rename() 関数<a class="headerlink" href="#rename" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Rename() 関数はファイルを名称変更します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Rename</span><span class="p">(</span><span class="n">cOldFileName</span><span class="p">,</span><span class="n">cNewFileName</span><span class="p">)</span> <span class="o">---&gt;</span> <span class="n">数値</span> <span class="p">(</span> <span class="n">状態</span><span class="p">:</span> <span class="n">成功</span> <span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="p">,</span> <span class="n">エラー</span> <span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span> <span class="p">)</span>
+</pre></div>
+</div>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">rename</span><span class="p">(</span><span class="s">&quot;file.txt&quot;</span><span class="p">,</span><span class="s">&quot;help.txt&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="remove">
+<span id="index-5"></span><h2>Remove() 関数<a class="headerlink" href="#remove" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Remove() 関数はファイルを削除します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Remove</span><span class="p">(</span><span class="n">cFileName</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">remove</span><span class="p">(</span><span class="s">&quot;test.txt&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fopen">
+<span id="index-6"></span><h2>Fopen() 関数<a class="headerlink" href="#fopen" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fopen() 関数はファイルを開きます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fopen</span><span class="p">(</span><span class="n">cFileName</span><span class="p">,</span><span class="n">cMode</span><span class="p">)</span> <span class="o">---&gt;</span> <span class="n">ファイルハンドル</span>
+</pre></div>
+</div>
+<table border="1" class="docutils">
+<colgroup>
+<col width="20%" />
+<col width="80%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">モード</th>
+<th class="head">説明</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td>“r”</td>
+<td>読み取り (ファイルが存在している必要があります)</td>
+</tr>
+<tr class="row-odd"><td>“w”</td>
+<td>書き込み (空のファイルを作成、上書き)</td>
+</tr>
+<tr class="row-even"><td>“a”</td>
+<td>追記 (ファイルが存在しない場合は作成)</td>
+</tr>
+<tr class="row-odd"><td>“r+”</td>
+<td>更新 (読み取り、書き込み)</td>
+</tr>
+<tr class="row-even"><td>“w+”</td>
+<td>空のファイルを作成 (読み取り、書き込み)</td>
+</tr>
+<tr class="row-odd"><td>“a+”</td>
+<td>読み取りと追記</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="section" id="fclose">
+<span id="index-7"></span><h2>Fclose() 関数<a class="headerlink" href="#fclose" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>fopen() 関数でファイルを開いて処理を終えた後は、
+Fclose() 関数でファイルを閉じます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fclose</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fflush">
+<span id="index-8"></span><h2>Fflush() 関数<a class="headerlink" href="#fflush" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fflush() 関数はストリームの出力バッファを追い出します (flush)。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fflush</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="freopen">
+<span id="index-9"></span><h2>Freopen() 関数<a class="headerlink" href="#freopen" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>同じファイルハンドルで別のファイルを開きますが、
+以前に開いていたファイルを併せて閉じます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Freopen</span><span class="p">(</span><span class="n">cFileName</span><span class="p">,</span><span class="n">cMode</span><span class="p">,</span><span class="n">file</span> <span class="n">handle</span><span class="p">)</span> <span class="o">---&gt;</span> <span class="n">ファイルハンドル</span>
+</pre></div>
+</div>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">freopen</span><span class="p">(</span><span class="s">&quot;myprogoutput.txt&quot;</span><span class="p">,</span><span class="s">&quot;w+&quot;</span><span class="p">,</span><span class="n">stdout</span><span class="p">)</span>
+<span class="k">see</span> <span class="s">&quot;welcome&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">10</span>
+        <span class="k">see</span> <span class="n">x</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">next</span>
+
+<span class="sd">##</span>
+<span class="sd">## 必読 : https://ja.wikipedia.org/wiki/デバイスファイル#MS-DOS・Windows</span>
+<span class="sd">## このコードには移植性がありません。使用前に iswindows() で動作環境を</span>
+<span class="sd">## 判定してから各オペレーティングシステム専用のコードを書いてください。</span>
+<span class="sd">##</span>
+
+<span class="n">freopen</span><span class="p">(</span><span class="s">&quot;CON&quot;</span><span class="p">,</span><span class="s">&quot;w&quot;</span><span class="p">,</span><span class="n">stdout</span><span class="p">)</span>   <span class="c"># Microsoft Windows では</span>
+<span class="k">see</span> <span class="s">&quot;Done&quot;</span> <span class="o">+</span> <span class="n">nl</span>             <span class="c"># もう一度、標準出力へ表示</span>
+</pre></div>
+</div>
+<p>実行結果:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="c"># 標準出力へ出力</span>
+<span class="k">Done</span>
+
+<span class="c"># ファイルへの出力 : myprogoutput.txt</span>
+<span class="n">welcome</span>
+<span class="mi">1</span>
+<span class="mi">2</span>
+<span class="mi">3</span>
+<span class="mi">4</span>
+<span class="mi">5</span>
+<span class="mi">6</span>
+<span class="mi">7</span>
+<span class="mi">8</span>
+<span class="mi">9</span>
+<span class="mi">10</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="tempfile">
+<span id="index-10"></span><h2>Tempfile() 関数<a class="headerlink" href="#tempfile" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Tempfile() 関数は一時ファイルを作成します (バイナリ形式)。</p>
+<p>ファイルはストリームが閉じられたときに自動で削除されます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">TempFile</span><span class="p">()</span> <span class="o">---&gt;</span> <span class="n">ファイルハンドル</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="tempname">
+<span id="index-11"></span><h2>Tempname() 関数<a class="headerlink" href="#tempname" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Tempname() 関数は一時ファイル名を生成します。</p>
+<p>生成された名前は唯一無二であり、既存ファイル名とは一切異なります。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Tempname</span><span class="p">()</span> <span class="o">---&gt;</span> <span class="n">ファイル名として生成された文字列</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fseek">
+<span id="index-12"></span><h2>Fseek() 関数<a class="headerlink" href="#fseek" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fseek() 関数はストリームにおけるファイル位置を設定します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Fseek(ファイルハンドル, nOffset, nWhence) ---&gt; 0 ならば成功です。
+</pre></div>
+</div>
+<p>この表は nWhence の値を表したものです。</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="6%" />
+<col width="94%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">値</th>
+<th class="head">説明</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td>0</td>
+<td>ファイルの先頭</td>
+</tr>
+<tr class="row-odd"><td>1</td>
+<td>現在の位置</td>
+</tr>
+<tr class="row-even"><td>2</td>
+<td>ファイルの末尾</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="section" id="ftell">
+<span id="index-13"></span><h2>Ftell() 関数<a class="headerlink" href="#ftell" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Ftell() 関数 はストリームにおける現在のファイル位置を検出します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Ftell(ファイルハンドル) ---&gt; 数値によるファイルの位置です。
+</pre></div>
+</div>
+</div>
+<div class="section" id="rewind">
+<span id="index-14"></span><h2>Rewind() 関数<a class="headerlink" href="#rewind" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Rewind() 関数はファイルの位置を先頭へ設定します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Rewind</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fgetpos">
+<span id="index-15"></span><h2>Fgetpos() 関数<a class="headerlink" href="#fgetpos" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fgetpos() 関数はハンドルにおける現在のファイル位置を取得します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fgetpos</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">)</span> <span class="o">---&gt;</span> <span class="n">位置ハンドル</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fsetpos">
+<span id="index-16"></span><h2>Fsetpos() 関数<a class="headerlink" href="#fsetpos" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fsetpos() 関数は現在のファイルの位置を設定します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fsetpos</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">位置ハンドル</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="clearerr">
+<span id="index-17"></span><h2>Clearerr() 関数<a class="headerlink" href="#clearerr" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>clearerr () 関数は EOF エラーとエラーインジケーターをストリームから消去します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Clearerr</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="feof">
+<span id="index-18"></span><h2>Feof() 関数<a class="headerlink" href="#feof" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Feof() 関数は EOF インジケーターをテストします。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Feof(ファイルハンドル) ---&gt; EOF ならば 1 を、そうでなければ 0 を返します。
+</pre></div>
+</div>
+</div>
+<div class="section" id="ferror">
+<span id="index-19"></span><h2>Ferror() 関数<a class="headerlink" href="#ferror" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Ferror() 関数 はエラーインジケーターをテストします。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Ferror(ファイルハンドル) ---&gt; エラーならば 1 を、そうでなければ 0 を返します。
+</pre></div>
+</div>
+</div>
+<div class="section" id="perror">
+<span id="index-20"></span><h2>Perror() 関数<a class="headerlink" href="#perror" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Perror() 関数は標準出力エラーへエラーメッセージを表示します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Perror</span><span class="p">(</span><span class="n">cErrorMessage</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fgetc">
+<span id="index-21"></span><h2>Fgetc() 関数<a class="headerlink" href="#fgetc" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fgetc() 関数はストリームから次の文字を取得します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Fgetc(ファイルハンドル) ---&gt; 文字または EOF を返します。
+</pre></div>
+</div>
+</div>
+<div class="section" id="fgets">
+<span id="index-22"></span><h2>Fgets() 関数<a class="headerlink" href="#fgets" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fgets() 関数はストリームから新しい行を読み取ります。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fgets</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">nSize</span><span class="p">)</span> <span class="o">---&gt;</span> <span class="n">文字列</span>
+</pre></div>
+</div>
+<p>この関数は nSize 文字まで読み取る、または新しい行を読み取るか EOF になると停止します。</p>
+</div>
+<div class="section" id="fputc">
+<span id="index-23"></span><h2>Fputc() 関数<a class="headerlink" href="#fputc" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fputc() 関数は文字をストリームへ書き込みます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fputc</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">cChar</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fputs">
+<span id="index-24"></span><h2>Fputs() 関数<a class="headerlink" href="#fputs" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fputs() 関数は文字列をストリームへ書き込みます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fputs</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">cString</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="ungetc">
+<span id="index-25"></span><h2>Ungetc() 関数<a class="headerlink" href="#ungetc" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Ungetc() 関数は文字をストリームへプッシュします。</p>
+<p>文字は次回の読み取りから利用できます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Ungetc</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">文字</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fread">
+<span id="index-26"></span><h2>Fread() 関数<a class="headerlink" href="#fread" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fread() 関数はデータをストリームへ読み込みます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fread</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">nSize</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fwrite">
+<span id="index-27"></span><h2>Fwrite() 関数<a class="headerlink" href="#fwrite" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fwrite() 関数はデータをストリームへ書き込みます。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="n">Fwrite</span><span class="p">(</span><span class="n">ファイルハンドル</span><span class="p">,</span><span class="n">cString</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="fexists">
+<span id="index-28"></span><h2>Fexists() 関数<a class="headerlink" href="#fexists" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Fexists() 関数はファイルの存在を確認します。</p>
+<p>文法:</p>
+<div class="highlight-ring"><div class="highlight"><pre>Fexists(cFileName) ---&gt; ファイルが存在する場合は 1 を返します。
+</pre></div>
+</div>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="n">fexists</span><span class="p">(</span><span class="s">&quot;b:\mahmoud</span><span class="se">\a</span><span class="s">pps</span><span class="se">\r</span><span class="s">ing</span><span class="se">\r</span><span class="s">ing.exe&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>
+    <span class="n">fexists</span><span class="p">(</span><span class="s">&quot;b:\mahmoud</span><span class="se">\a</span><span class="s">pps</span><span class="se">\r</span><span class="s">ing</span><span class="se">\r</span><span class="s">ing2.exe&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+</pre></div>
+</div>
+<p>実行結果:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="mi">1</span>
+<span class="mi">0</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="index-29">
+<span id="id2"></span><h2>用例<a class="headerlink" href="#index-29" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このプログラムはファイル関数をテストします。</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">See</span> <span class="s">&quot;testing file functions&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+
+<span class="k">See</span> <span class="s">&quot;open file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/s65.ring&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">)</span>
+
+<span class="k">See</span> <span class="s">&quot;reopen&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">freopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/s78.ring&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">,</span><span class="n">fp</span><span class="p">)</span>
+<span class="k">See</span> <span class="s">&quot;close file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;temp file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">tempfile</span><span class="p">()</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;temp name&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">tempname</span><span class="p">()</span> <span class="o">+</span> <span class="n">nl</span>
+
+<span class="n">remove</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/mytest2.txt&quot;</span><span class="p">)</span>
+<span class="n">write</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/tests1.txt&quot;</span><span class="p">,</span><span class="s">&quot;hello&quot;</span><span class="p">)</span>
+<span class="n">rename</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/test1.txt&quot;</span><span class="p">,</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span>
+                                        <span class="s">&quot;../tests/scripts/mytests2.txt&quot;</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;print file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../samples/fromdoc/filefuncs.ring&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">fgetc</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+<span class="k">while</span> <span class="n">isstring</span><span class="p">(</span><span class="n">r</span><span class="p">)</span>
+                <span class="k">see</span> <span class="n">r</span>
+                <span class="n">r</span> <span class="o">=</span> <span class="n">fgetc</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+<span class="k">end</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="n">nl</span><span class="o">+</span><span class="s">&quot;print line from the file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../samples/fromdoc/filefuncs.ring&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">fgets</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">33</span><span class="p">)</span>
+<span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/test78.txt&quot;</span><span class="p">,</span><span class="s">&quot;w+&quot;</span><span class="p">)</span>
+<span class="n">fseek</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">2</span><span class="p">)</span> <span class="c"># ファイルの末尾へ移動</span>
+<span class="n">fputc</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="s">&quot;t&quot;</span><span class="p">)</span>
+<span class="n">fputc</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="s">&quot;e&quot;</span><span class="p">)</span>
+<span class="n">fputc</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="s">&quot;s&quot;</span><span class="p">)</span>
+<span class="n">fputc</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="s">&quot;t&quot;</span><span class="p">)</span>
+<span class="n">fputs</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="s">&quot;tests2&quot;</span><span class="p">)</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;print file&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">read</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/test78.txt&quot;</span><span class="p">)</span>
+
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/test78.txt&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">)</span>
+<span class="k">see</span> <span class="s">&quot;testing ungetc() &quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">3</span>
+                <span class="n">r</span> <span class="o">=</span> <span class="n">fgetc</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+                <span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+                <span class="n">ungetc</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="n">r</span><span class="p">)</span>
+<span class="k">next</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;testing fread() &quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefilename</span><span class="p">(),</span><span class="s">&quot;rb&quot;</span><span class="p">)</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">fread</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">100</span><span class="p">)</span>
+<span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+
+<span class="k">see</span> <span class="s">&quot;testing fwrite() &quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefolder</span><span class="p">()</span> <span class="o">+</span> <span class="s">&quot;../tests/scripts/test1.txt&quot;</span><span class="p">,</span><span class="s">&quot;wb&quot;</span><span class="p">)</span>
+<span class="n">fwrite</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="n">r</span><span class="p">)</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>この用例はバイナリファイルの内容を表示します。</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="s">&quot;Testing: fread()&quot;</span> <span class="o">+</span><span class="s">&quot; FileName: &quot;</span><span class="o">+</span> <span class="n">exefilename</span><span class="p">()</span> <span class="o">+</span><span class="n">nl</span> <span class="o">+</span><span class="n">nl</span>
+<span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="n">exefilename</span><span class="p">(),</span><span class="s">&quot;rb&quot;</span><span class="p">)</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">fread</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">800</span><span class="p">)</span>
+<span class="k">for</span> <span class="n">n</span> <span class="o">=</span><span class="mi">1</span> <span class="k">to</span> <span class="n">len</span><span class="p">(</span><span class="n">r</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">isprint</span><span class="p">(</span><span class="n">substr</span><span class="p">(</span><span class="n">r</span><span class="p">,</span> <span class="n">n</span><span class="p">,</span> <span class="mi">1</span><span class="p">))</span>
+                <span class="k">see</span> <span class="n">substr</span><span class="p">(</span><span class="n">r</span><span class="p">,</span> <span class="n">n</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+        <span class="k">else</span>
+                <span class="k">see</span> <span class="s">&quot;.&quot;</span>
+        <span class="k">ok</span>
+        <span class="sd">### １行あたり 80 文字</span>
+        <span class="k">if</span> <span class="n">n</span> <span class="o">%</span> <span class="mi">80</span> <span class="o">=</span> <span class="mi">0</span>
+                <span class="k">see</span> <span class="n">nl</span>
+        <span class="k">ok</span>
+<span class="k">next</span>
+<span class="n">fclose</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="index-30">
+<span id="id3"></span><h2>数値とバイト<a class="headerlink" href="#index-30" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>この関数は数値とバイトとの間で変換を行います。</p>
+<ul class="simple">
+<li>Int2Bytes()</li>
+<li>Float2Bytes()</li>
+<li>Double2Bytes()</li>
+<li>Bytes2Int()</li>
+<li>Bytes2Float()</li>
+<li>Bytes2Double()</li>
+</ul>
+<p>用例:</p>
+<div class="highlight-ring"><div class="highlight"><pre><span class="k">see</span> <span class="s">&quot;Test Int2Bytes() and Bytes2Int() - Value : 77&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">Int2Bytes</span><span class="p">(</span><span class="mi">77</span><span class="p">)</span>
+<span class="k">see</span> <span class="s">&quot;Int Size : &quot;</span> <span class="o">+</span> <span class="n">len</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">Bytes2Int</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="s">&quot;Test Float2Bytes() and Bytes2Float() - Value 77.12&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">Float2Bytes</span><span class="p">(</span><span class="mf">77.12</span><span class="p">)</span>
+<span class="k">see</span> <span class="s">&quot;Float Size : &quot;</span> <span class="o">+</span> <span class="n">len</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">Bytes2Float</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="s">&quot;Test Double2Bytes() and Bytes2Double() - Value 9999977.12345&quot;</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">r</span> <span class="o">=</span> <span class="n">Double2Bytes</span><span class="p">(</span><span class="mf">9999977.12345</span><span class="p">)</span>
+<span class="k">see</span> <span class="s">&quot;Double Size : &quot;</span> <span class="o">+</span> <span class="n">len</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="k">see</span> <span class="n">r</span> <span class="o">+</span> <span class="n">nl</span>
+<span class="n">decimals</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span>
+<span class="k">see</span> <span class="n">Bytes2Double</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
+</pre></div>
+</div>
+</div>
+</div>
+
+
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
+        <div class="sphinxsidebarwrapper"><h3>ページの内容</h3>
+<ul>
+<li><a class="reference internal" href="#">ファイル</a><ul>
+<li><a class="reference internal" href="#read">Read() 関数</a></li>
+<li><a class="reference internal" href="#write">Write() 関数</a></li>
+<li><a class="reference internal" href="#dir">Dir() 関数</a></li>
+<li><a class="reference internal" href="#rename">Rename() 関数</a></li>
+<li><a class="reference internal" href="#remove">Remove() 関数</a></li>
+<li><a class="reference internal" href="#fopen">Fopen() 関数</a></li>
+<li><a class="reference internal" href="#fclose">Fclose() 関数</a></li>
+<li><a class="reference internal" href="#fflush">Fflush() 関数</a></li>
+<li><a class="reference internal" href="#freopen">Freopen() 関数</a></li>
+<li><a class="reference internal" href="#tempfile">Tempfile() 関数</a></li>
+<li><a class="reference internal" href="#tempname">Tempname() 関数</a></li>
+<li><a class="reference internal" href="#fseek">Fseek() 関数</a></li>
+<li><a class="reference internal" href="#ftell">Ftell() 関数</a></li>
+<li><a class="reference internal" href="#rewind">Rewind() 関数</a></li>
+<li><a class="reference internal" href="#fgetpos">Fgetpos() 関数</a></li>
+<li><a class="reference internal" href="#fsetpos">Fsetpos() 関数</a></li>
+<li><a class="reference internal" href="#clearerr">Clearerr() 関数</a></li>
+<li><a class="reference internal" href="#feof">Feof() 関数</a></li>
+<li><a class="reference internal" href="#ferror">Ferror() 関数</a></li>
+<li><a class="reference internal" href="#perror">Perror() 関数</a></li>
+<li><a class="reference internal" href="#fgetc">Fgetc() 関数</a></li>
+<li><a class="reference internal" href="#fgets">Fgets() 関数</a></li>
+<li><a class="reference internal" href="#fputc">Fputc() 関数</a></li>
+<li><a class="reference internal" href="#fputs">Fputs() 関数</a></li>
+<li><a class="reference internal" href="#ungetc">Ungetc() 関数</a></li>
+<li><a class="reference internal" href="#fread">Fread() 関数</a></li>
+<li><a class="reference internal" href="#fwrite">Fwrite() 関数</a></li>
+<li><a class="reference internal" href="#fexists">Fexists() 関数</a></li>
+<li><a class="reference internal" href="#index-29">用例</a></li>
+<li><a class="reference internal" href="#index-30">数値とバイト</a></li>
+</ul>
+</li>
+</ul>
+
+
+  <h4>前のトピックへ</h4>
+  <p class="topless"><a href="mathfunc.html"
+                        title="前の章へ">算術関数</a></p>
+  <h4>次のトピックへ</h4>
+  <p class="topless"><a href="systemfunc.html"
+                        title="次の章へ">システム関数</a></p>
+  <div role="note" aria-label="source link">
+    <h3>このページ</h3>
+    <ul class="this-page-menu">
+      <li><a href="_sources/files.txt"
+            rel="nofollow">ソースコードを表示</a></li>
+    </ul>
+   </div>
+      
+<form action="search.html" method="get">
+  <input type="text" name="q" placeholder="Search" />
+  <input type="hidden" name="check_keywords" value="yes" />
+  <input type="hidden" name="area" value="default" />
+</form>
+      
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+<footer class="footer">
+  <p class="pull-right">
+    <a href="_sources/files.txt"
+       rel="nofollow">Page Source</a> &nbsp;
+    <a href="#">Back to Top</a></p>
+  <p>
+    &copy; Copyright 2016-2020, Ring Team.<br/>
+    Created using <a href="http://www.sphinx-doc.org/en/stable/">Sphinx</a> 1.3.6. / astropy-sphinx-theme 1.1 (isVowel)
+  </p>
+</footer>
+  </body>
+</html>
\ No newline at end of file
プログラミング言語 Ring 付属説明書の日本語訳＋日本語化キット(インストーラ)の開発
About OSDN
Find Software
Develop Software
Help