●ファイルの入出力 その0

サンプルプログラムは,サンプルファイル bat.mid をバイナリデータ
のファイルとして読み込んで表示している例です。

 ●バイナリファイルとは?

  ファイルの中身にはどんな種類のデータも記録できますが,
  その内容(用途)によって2種類に分かれます。

   1.テキストファイル
      人間が読める文字データが詰まったファイル。
      改行を表す特殊な文字(改行文字)によって
      行単位に分かれている。1行当たりの文字数
      は行によって違って良い。

   2.バイナリファイル
      人間の読めないデータばかり入ったファイル。
      画像や音声データ,圧縮されたデータ,MIDI
      ファイルなどがこれにあたる。

添付したファイルは,C言語の機能だけを使ってファイルをバイ
ナリデータとして1バイトずつ読み込んで表示するものです。

使用しているファイル関連の関数は以下の5つ。

 ・fopne()
 ・fclose()
 ・frintf()
 ・fread()
 ・feof()

その他,ポインタについて概要を知っておく必要があります。

また

 ・size_t 型
   0以上を表す大きい整数型。たいてい unsigned long と同じ型。

 ・exit()関数
   プログラムを自発的に終了する関数。返値は
    整数値0  :正常終了
    0以外の整数:異常終了
   としてオペレーティングシステムに通知されます。
   (exit()が返す値の意味は,main()関数のreturnで返す値と同じ。)

・perror()関数
   エラーメッセージを表示する専用関数。この関数に文字列
   を渡すと,エラーメッセージ専用の出力先(標準エラー出力)に
   内容が表示される。何もしなければ,標準エラー出力は
   通常の出力先と同じコマンドプロンプト・ウィンドウになる。

・errno
   C言語の標準ライブラリで用意されているint型のグロー
   バル変数。C言語標準ライブラリ関数のいくつかは,
   エラーが起こるとそのエラーの種類を表す値をこの
   変数にセットする。
   
を知っておくと良いでしょう。

※サンプルとして使用しているMIDIファイル "bat.mid"は, vgmusic.com から拝借した FF7の
 戦闘シーンのBGMです。リンク先のファイル "bat.mid" をダウンロードして,ソースファイルを同じ場所において下さい。
 なお,ダウンロードしたファイルはWindowsではダブルクリックで再生できるはずです。

※バイナリエディタ(例えば http://www.vector.co.jp/soft/win95/util/se161737.html )
 で中身をみて,このプログラムで表示される内容と
 比較してみて下さい。同じ内容が表示されているはずです。
※「バイナリエディタ」とは,ファイルの中身のデータをバイナリデータとして読み書きするソフトで,
 たいてい16進数で中身を表示します。



main00.cpp

01/* ファイルをバイナリデータとして読み込むサンプル */
02/* ファイル "bat.mid" を読み込み、1バイトずつ16進数で表示する(1行で16バイトずつ表示)。 */
03  
04// Microsoftは、C言語標準の関数のいくつかを安全でないと考えており、警告を出す。次行の指定をするとその警告を出さなくなる。
05#define _CRT_SECURE_NO_WARNINGS
06  
07// これ以降は、C言語の標準ライブラリだけを使用し、Windows API や DXライブラリ は使用していない。
08#include <stdlib.h> // exit()関数を利用するため
09#include <stdio.h>  // ファイル入出力を含め、入出力一般の機能を利用するときには stdio.h をインクルードする
10  
11// ポイント:stdio.h の中で、FILEという構造体型が宣言されている。ファイル1個につき、FILE型構造体1個を使ってファイルの入出力を管理する。
12  
13int main( void ) {
14     
15    FILE * fp1 = NULL;      // FILE型構造体へのポインタ値を格納するポインタ型変数fp1を宣言する。
16    unsigned char buff[16]; // ファイルから読み込む16バイト分を格納する配列
17    size_t readn = 0;       // size_t型整数(たいていは unsigned long と同じ型)の変数readn
18    size_t i;               // 繰り返し用の変数
19     
20    // fopen()関数を使って、ファイル"bat.mid"を、読み込みオンリーモード("r")で開く。
21    // オープンが成功するとfopen()関数はそのファイルを管理するFILE構造体へのポインタ値を返す。
22    // オープンに失敗すると、fopen()関数は空ポインタ(NULL)を返し、C言語の標準ライブラリに用意されている変数errnoにエラーコードを返す。
23    fp1 = fopen( "bat.mid", "r" );
24    if( NULL == fp1 ) {
25        perror( "ファイルオープンに失敗しました。" );
26        exit( errno );
27    }
28  
29    // fread()関数を使ってファイルを16バイトずつ読み込んで表示する。
30    // fread()関数でfp1で管理しているファイルから、配列buffに、1バイト分を16個だけ読み込む。(つまり第3引数が「個数」)
31    // fread()関数は、読み込んだ個数を返す。下の使用例では1バイトを16個読めたら、16を返す。
32    // もしエラーが起こったり、ちょうどファイルの終端まで達して1個も読み込めなかった場合は0を返す。
33    // fread()の実行中に本当にエラーが起こっているかどうかは、下例のように feof() 関数で判別できる。
34  
35    while( readn = fread( buff, 1, 16, fp1 ) ) { // readnに代入された読み込み「個数」が0でない間繰り返す。
36        for( i = 0; i < readn; i++ ) printf( "%02X ", buff[i] );
37        printf( "\n" );
38    }
39  
40    if( feof( fp1 ) ) { // 本当にファイルの終端に達した状態には、feof()関数(end of file関数)は真の値を返す。
41        printf( "-ファイルの終端(EOF: End Of File)-\n" );
42    }
43    else { // feof()関数が真でない場合、なんらかの読み込みエラーが起こったことになる。
44        perror( "ファイルの読み込み中にエラーが起きました。" );
45    }
46  
47    // もう使用しないファイルについては必ず fclose()関数で閉じる(クローズ)する事!
48    // オペレーティングシステムによっては同時に開けるファイル数に制限があるため。
49    // また、ファイルをクローズすることによって、ファイルの読み書きに利用される補助的な
50    // メモリ領域などが解放されるので、プログラムの動作環境が健全に保たれる。
51    fclose( fp1 );
52  
53    // コマンドプロンプトウインドウがいきなり終了しないための getchar() 呼び出し。
54    getchar();
55    getchar();
56  
57    return 0;
58}