Qtのようにヘッダーとソースファイルを別々のファイルに保存するべき？

Question

プロジェクトにおいて、私は今までヘッダーファイルとソースファイルを全て同じsrcフォルダに保存しておりました。
しかしQtでは、HeaderとSourceフォルダにそれぞれ分けて保存することが推奨されているようです。
そこで質問なのですが、Qtのようにそれぞれ分けて保存するほうが一般的なのでしょうか。
このようにすると、includeが毎回相対パスになってしまい少し面倒に感じました。

//a.hpp
class a {};

// a.cpp
#include "../header/a.hpp"

Answer 1

自分は分ける必要を感じません。

ヘッダーオンリーライブラリではないのならば、かならずビルドが必要で、つまりCMakeなりなんなりを書くわけです。
ヘッダーが別れてると嬉しいのはライブラリを使う側ですが、ビルドするときのinstall設定でヘッダーファイルだけ抜き出せますし、そのほうがきれいじゃないかと思ってます。

Comments

[asobinin]

確かに、boostのビルド作業は時間も掛かるし面倒でした。
ヘッダーオンリーのライブラリが喜ばれるのにも理由があったのですね。

[yumetodo]

念ののための補足ですが、boostは全部
ビルドいるわけではないですよ

[asobinin]

ありがとうございます。
boost/versionなどはビルドなしで使用できる、boost/asioなどはビルドが必要というのは、かつてビルドに失敗したので存じております。

Answer 2

ある程度の規模のソースコードであれば、CMake などのビルドシステムを使うのが普通ですから、その場合、インクルードパスにヘッダーファイルが置いてあるディレクトリを追加するようにします。

例えば、以下の例では include ディレクトリをインクルードパスに追加します。

├─include
|   └─ hoge.h
└─src
    └─ hoge.cpp

すると、hoge.cpp から hoge.h をインクルードするのに hoge.cpp からの相対パス #include "../include/hoge.h" ではなく、include を基点としたパス #include "hoge.h" とすればよくなります。

Comments

[asobinin]

なるほど、boostなどはこのような仕組みになっていたのですね！
大変勉強になりました。