ArduinoIDEでのコンパイルエラー expected ')' before '&' token

Question

前提・実現したいこと

初めての質問なので読みにくい箇所も多々あるかと思いますが、お許しください。
LILYGOというメーカーのT-Wristbandというスマートバンドが「プログラムできるスマートバンド」という題名でウェブサイト上で記事にされており、気になって購入しました。ESP32というマイコンを搭載しており、Arduino IDEを用いて開発を行う物です。includeしたファイルが見当たらない系のエラーgほとんどなので、その入手先をGoogle検索しつつ適宜Githubからクローンを行ったりブラウザでダウンロードしたりして、とりあえずサンプルみたいなスケッチをビルドしようとしています。しかし、以下のようなエラーが直せず困っています。自分はC++は少ししかできないのでこの様な文法はなんとなくしかわからないのですが、なぜここに')'がexpectedなのでしょうか？また、どうすればコンパイルが可能でしょうか？ライブラリのファイルなので、自分は一切触っていません。
該当するファイルはESP8266用のようですが、ESP32用のヘッダーファイルから参照されているため、ESP32でも動くものだと思います。

発生している問題・エラーメッセージ

エラーメッセージ(関係ない警告なども含まれるため一部抜粋)

In file included from /home/sugi/arduino/libraries/ESP8266WebServer/src/ESP8266WebServer-impl.h:30:0,
                 from /home/sugi/arduino/libraries/ESP8266WebServer/src/ESP8266WebServer.h:235,
                 from /home/sugi/arduino/libraries/WiFiManager/WiFiManager.h:17,
                 from /home/sugi/Wrist/git/LilyGO-T-Wristband/LilyGO-T-Wristband.ino:14:
/home/sugi/arduino/libraries/ESP8266WebServer/src/detail/RequestHandlersImpl.h:70:28: error: expected ')' before '&' token
     StaticRequestHandler(FS& fs, const char* path, const char* uri, const char* cache_header)
                            ^

該当のソースコード(該当部分のみ抜粋)

template<typename ServerType>
class StaticRequestHandler : public RequestHandler<ServerType> {
    using WebServerType = ESP8266WebServerTemplate<ServerType>;
public:
    StaticRequestHandler(FS& fs, const char* path, const char* uri, const char* cache_header)
    : _fs(fs)
    , _uri(uri)
    , _path(path)
    , _cache_header(cache_header)
    {
        if (fs.exists(path)) {
            File file = fs.open(path, "r");
            _isFile = file && file.isFile();
            file.close();
        }
        else {
            _isFile = false;
        }
        
        DEBUGV("StaticRequestHandler: path=%s uri=%s isFile=%d, cache_header=%s\r\n", path, uri, _isFile, cache_header);
        _baseUriLength = _uri.length();
    }
    //以下クラスの定義省略
}

試したこと

ファイル名を含めてエラーメッセージでGoogle検索をしてみたのですが、FS_NO_GLOBALSをdefineすると〜みたいなissueばっかり出てきて、関係なさそうだな…と思って諦めてしまった状態です…苦手な英語だということもあり読めていないのですが…

補足情報（FW/ツールのバージョンなど）

PCのOSはDebian 10
Arduino IDEのバージョンは1.8.10
該当するファイルは ここ からクローンしたもので、該当するファイルは ここ にあります。

Comments

[cateye]

各.hファイルから参照されているFS.hは、有りますか？

Answer 1

StaticRequestHandler中のFSをfs::FSに変更するか、RequestHandlersImpl.hの呼び出しの前でusing namespace fs;を行うことでエラーが解消しませんか。

このソースで試したわけではありませんが、簡単なソースでクラスの名前空間指定を外した場合に、
error: expected ')' before '&' token
のエラーは発生していました。

クラスFSを探すとFS.h(たぶんArduino/cores/esp8266/FS.h?)で定義されていました。
この中ではfsという名前空間内で定義されているため、本来はfs::FSで使う必要があります。

このGithubのソースを見ると、ヘッダーファイル内でusing namespace(usingディレクティブ)を使っているものがいくつかありました。そのため呼び出しの順番によりFS単体の記述でOKな場合があったのかもしれません。

なお、ヘッダーファイル内のusingディレクティブの使用はあまり褒められたものではないと思います。
違う名前空間に同じ名前のクラス・関数などがあった場合、それを特定して使用するのが困難になる場合があります。

Answer 2

なぜエラーになっているかは追求していませんが、githubのリポジトリの情報に沿って

• LilyGO-T-Wristbandをまるまるzipでダウンロードして解凍し
• *.inoファイルの含まれる直上のLilyGO-T-Wristband-masterフォルダをLilyGO-T-Wristbandにリネームし(.inoファイルとフォルダ名が一致しなければいけないため)
• LilyGO-T-Wristband/libdepsにある2つのフォルダ(PCF8563_LibraryとWiFiManager)を/Users/User/Documents/Arduino/libraries以下にコピー
• githubにあるリンクからTFT_eSPIライブラリをzipでダウンロードし
• Arduino IDEを開いて、メニュー[スケッチ]-[ライブラリをインクルード >]-[.ZIP形式のライブラリをインストール...]でダウンロードしたTFT_eSPIライブラリのzipファイルを指定、インストール
• /Users/User/Documents/Arduino/libraries/TFT_eSPI-master/User_Setup_Select.h を編集し
• IDEメニュー[ファイル]-[開く...]で先のLilyGO-T-Wristedband/LilyGO-T-Wristedband.inoを開く
• [ツール]-[ボード: >]で[ESP32 Dev Module]を選択
• コンパイル

でエラーが出ずにコンパイル終了しました。なお、実機がないので動作確認は出来ません。

エラーは、ちゃんとドキュメントを読んで手順通りにやれば出来るところを我流でやった結果ではないかと想像します。

---

includeしたファイルが見当たらない系のエラーgほとんどなので、その入手先をGoogle検索しつつ適宜Githubからクローンを行ったりブラウザでダウンロードしたりして、とりあえずサンプルみたいなスケッチをビルドしようとしています。

これだけの長さの文章に、実は具体的な(回答者が追試・確認できる)情報がひとつも含まれていません...次回質問する際には、是非「読んだ人が再現実験を出来る」ような情報を盛り込んでいただければと思います。自分の作業の確認にもなって、整理することで、質問するまでもなく自力で解決してしまうこともあるでしょう。

Comments

[sgtm0113]

回答ありがとうございます。ご指摘の通りに操作を行っても #include "config.h"で見つからずエラー、仕方なくそれっぽいものをgithubから見つけてきて補填してもエラー…一向に解決しないので作業環境をLinuxからWindowsに変更してみたところ、解決しました。ありがとうございました。

Answer 3

StaticRequestHandler(FS& fs, const char* path, const char* uri, const char* cache_header)

は、

StaticRequestHandler(FS &fs, const char* path, const char* uri, const char* cache_header)

のタイプミスだと思われます。

FS &fs
なら、変数fsで参照しているものの型がFSであるというように解釈できますが、
FS& fs
というように型が&で終わっているのは文法的におかしいです。

Comments

[thkana]

C++の文法をちゃんと読んでないのでわかりませんが、宣言における&の立場を考えると、Cでint*_a;もint_*a;どちらもOK(int_*_a;もOK)というのと同様な扱いを期待できないですか。

とりあえず、Arduino IDEでESP32ターゲットにして
void setup() {
}

void func(int &a){
a=0;
}
void func2(int& a){
a=1;
}
void func3(int & a){
a=2;
}

void loop() {
int a=0;
func(a);
func2(a);
func3(a);
}

はエラーになりません。

[SaitoAtsushi]

トークンの分割に必要な場合を除いて空白は無視されます。
https://timsong-cpp.github.io/cppwp/n3337/lex.token

FS& fs と書いてあっても FS &fs と書いてあっても FS と & と fs とのみっつのトークンに分割した上で文法的解釈が入るので、この場合には空白によって意味が変わることはありません。
thkana さんの解釈で正しいです。