typedef struct SomeStruct {
  int hoge;
} SomeStruct, *pSomeStruct;

こんな構造体を作っても問題なく使えます。今まで名前がかぶらないように苦労していたのが馬鹿みたいですよね。本来ならばタグ名の前に struct が付くので識別するのに問題はないということでしょうか。

Byerkut さんもブログを始めてからいろいろと学ぶことがあります。

ヘッダファイルは *.cpp ファイルに対してひとつ *.h という形で作りますが、その内容として次のような情報を記述します。

• その *.cpp が外部に対してどんな型を提供しているか？
• その *.cpp が外部に対してどんな関数を提供しているか？
• #include ガード

その *.cpp が外部に対してどんな型を提供しているか？

*.cpp が外部に公開している型を他のファイルに教えるための記述です。 class や typedef や enum などを書くことができます。

// 構造体の定義
typedef struct {
  // …
} SampleStructure;

// クラスの定義
class SampleClass
{
  // …
}

// 列挙型の定義
typedef enum {
  // …
} SampleEnum;

その *.cpp が外部に対してどんな関数を提供しているか？

*.cpp が外部に公開している関数を他のファイルに教えるための記述です。他のファイルからはこの *.h ファイルを #include することで *.cpp が提供している関数を使うことができるようになります。関数を外部に公開するためには、関数の名前・引数・戻り値を次のように記述します。

void InitializePlayer(HWND hWindow, HDC hBackBuffer);
void FinalizePlayer(HWND hWindow, HDC hBackBuffer);
void UpdatePlayer(HWND hWindow, HDC hBackBuffer);
void DrawPlayer(HWND hWindow, HDC hBackBuffer);

#include ガード

同じ *.h ファイルを２回以上 #include してしまうと「同じ関数名が使われています」というようなエラーになってしまいます。これを回避するために #include ガードを記述します。

#ifndef SAMPLE_HEADER_INCLUDED__

#define SAMPLE_HEADER_INCLUDED__


// ここにヘッダファイルの中身を書きます

#endif

#include ガードは任意の文字列（前述の例では SAMPLE_HEADER_INCLUDED__ ）を用いて、「その文字列が初めて使われるか？」「すでに使われていないか？」を検証し、初めて使われている場合は *.h ファイルをインクルードし、すでに使われている場合は #include をスキップするようにします。これによって同じ *.h ファイルが２回以上 #include されないようになります。任意の文字列（前述の例では SAMPLE_HEADER_INCLUDED__ ）は好きな文字列を指定することができますが、ファイルごとに違う文字列を指定する必要があります。また、アンダーバーで始まる名前は使用できません。

完全なヘッダファイルの例

#ifndef SAMPLE_HEADER_INCLUDED__

#define SAMPLE_HEADER_INCLUDED__


// 型を定義する例
typedef struct {
  int x;
  int y;
  int width;
  int height;
  int life;
} Player, *pPlayer;

// 関数を定義する例
void InitializePlayer(HWND hWindow, HDC hBackBuffer);
void FinalizePlayer(HWND hWindow, HDC hBackBuffer);
void UpdatePlayer(HWND hWindow, HDC hBackBuffer);
void DrawPlayer(HWND hWindow, HDC hBackBuffer);

#endif

まず、敵キャラクターの総数を定数で定義します。定数で定義する理由は「あとで変更するのが楽」だからです。

#define MAX_ENEMY 100

こうすることで、プログラムから MAX_ENEMY という定数を使うことができるようになります。意味は 100 と数字で書いたときと同じになります。

次に敵キャラクターの情報を保存する配列を作ります。今回の場合は 100 体分の敵キャラクターが必要ですので 100 …と、数字で指定したいところですが、ここで先ほど定義した定数を使います。

Enemy enemies[MAX_ENEMY];

100 という数字を MAX_ENEMY という定数で置き換えることで、敵キャラクターの増減が簡単になります。たとえば、敵キャラクターを 200 体に増やしたい場合は、 #define MAX_ENEMY 200 と書き直すだけで 200 体分の配列を作れるようになります。

100 体分の配列が作れたら準備が完了です。次はゲームの中から 100 体分の敵キャラクターを動かします。しかし、プログラムは一度にひとつのことしかできませんので 100 体の敵キャラクターを同時に動かすことはできません。 100 体分の敵キャラクターを動かすためには、きわめて短い間隔で１体ずつ動かして、見かけ上同時に動いているように見せるのです（アニメーションの原理と同じ）。これを実現するためには for 文を使います。

for (int i = 0; i <MAX_ENEMY; i++) {
  doEnemy(enemies[i]);
}

１体の敵キャラクターを動かすための関数が doEnemy() で、どの敵キャラクターを動かすのかを引数で受け取るような仕様の場合、先ほど作った enemies 配列に、現在のループは何回目かを数えている i という変数を組み合わせて enemies[i] とする点がポイントです。このように書くと、１回目のループでは i の値が０ですので enemies[0] を参照することができ、２回目のループでは i の値が１ですので enemies[1] を参照することができるようになります。この調子で 100 回繰り返すわけですから、結果的に 100 体分の敵キャラクターを順番に参照していることになります。

これは基本的にして重要なイディオムですので覚えてしまいましょう。

構造体はひとつの名前で複数のデータを管理するところが配列と似ています。

しかし、配列はひとつの名前と番号で複数のデータを管理していたのに対して、構造体はひとつの名前とその名前に関連付いている別の名前で複数のデータを管理する部分が異なります。

// 配列で３つのデータを管理する
printf("First is %d\n", numbers[0]);
printf("Second is %d\n", numbers[1]);
printf("Third is %d\n", numbers[2]);

// 構造体で３つのデータを管理する
printf("First is %d\n", numbers.first);
printf("Second is %d\n", numbers.second);
printf("Third is %d\n", numbers.third);

構造体を使うためには、まず構造体を定義する必要があります。

構造体は、はじめてその構造体の変数を宣言するより前（ソースコードから見ると上）に定義する必要があります。

構造体は次のように定義します。このとき、カッコの中の変数をメンバ変数と呼びます。

struct Player
{
  char name[50];
  int HP;
  int MP;
  int STR;
  int DEF;
  int AGI;
};

これは RPG の１キャラ分のデータをイメージしたものです。

実際にこの変数を使うためには、通常の変数と同様に宣言が必要になります。

struct Player player;

構造体へアクセスするためには通常の変数と同様に、宣言した時につけた名前を指定するだけですが、構造体の中の変数（メンバ変数）へアクセスするためには、構造体の変数名の後ろにドットをひとつおいて、中の変数名を指定する必要があります。

// プレイヤーの名前へアクセス
player.name;
// プレイヤーの体力へアクセス
player.HP;
// プレイヤーの攻撃力へアクセス
player.STR;

構造体の中の変数は通常の変数と同じようにデータを計算や記憶することができます。

// 宣言
struct Player player;

// キャラクターの初期情報をセット
player.name = "Byerkut";
player.HP = 100;
player.MP = 50;
player.STR = 10;
player.DEF = 5;
player.AGI = 1;

// ダメージを食らった
player.HP = player.HP - 10;

// MP を消費して魔法を使い、攻撃力を上昇させた
player.MP = player.MP - 8;
player.STR = player.STR * 1.1;

構造体は変数ですので他の変数へコピーすることが可能です。ただし、数値型ではないため計算はできません。

struct Player player;
struct Player beforeBattle;

// 戦闘前のデータを保存しておく
beforeBattle = player;

構造体の中の変数（メンバ変数）は C++ の基本型だけではなく、別の構造体を指定することもできます。

// プレイヤー
struct Player
{
  char name[50];
  int HP;
  int MP;
  int STR;
  int DEF;
  int AGI;
};

// パーティー
struct Party
{
  // リーダー
  struct Player leader;
  // サブリーダー
  struct Player subLeader;
  // メンバー１
  struct Player member1;
  // メンバー２
  struct Player member2;
  // メンバー３
  struct Player member3;
}

Party 構造体の中の変数（メンバ変数）として Player 構造体を使っていますので、 Player 構造体は Party 構造体より前に定義する必要があります。