例 3.3. helloworld アプリケーションクラスの定義

////  helloworld.hpp//

#define __HELLOWORLD_HPP

#include <SophiaFramework.hpp>
#include "helloworld.bid"

//
//  helloworld アプリケーションクラスの定義
//

SFMTYPEDEFCLASS(helloworld)  //  便利な型を生成するマクロ
class helloworld : public SFYApplication //  helloworld アプリケーションクラスは SFYApplication クラスを継承する
{
    SFMSEALCOPY(helloworld)  // インスタンスのコピーを禁止するマクロ
public:
    static SFCInvokerPtr Factory(Void);
private:
    explicit helloworld(Void) static_throws;
    virtual ~helloworld(Void);
    XANDLER_DECLARE_VOIDRENDER(OnRenderRequest)  // 描画ハンドラ
    XANDLER_DECLARE_BOOLEVENT(OnKey)             // キーハンドラ
};

#endif // __HELLOWORLD_HPP //

	大文字アルファベットを含むアプリケーションクラス名（BREW 4.0 から）
	通常、helloworld などのアプリケーションクラスの名前はアプリ本体と同じ名前にします。 BREW 4.0 からアプリの名前に大文字アルファベットが使えなくなりました。 HelloWorld や USRApplication などアプリケーションクラスの名前に大文字アルファベットを使う場合、 大文字アルファベットを小文字アルファベットに変換する必要があります。

	SFMTYPEDEFCLASS マクロ
	SFMTYPEDEFCLASS は、 引数に指定したクラスに関する便利なユーザー定義型を自動生成するマクロです。

	SFMSEALCOPY マクロ
	SFMSEALCOPY は、 インスタンスのコピーを禁止するマクロです。 上の例の場合、helloworld インスタンスはコピーしてはいけません。

	XANDLER_DECLARE_VOIDRENDER マクロ
	XANDLER_DECLARE_VOIDRENDER は、 描画ハンドラを宣言するためのマクロです。

	XANDLER_DECLARE_BOOLEVENT マクロ
	XANDLER_DECLARE_BOOLEVENT は、 Bool 型を返すハンドラを宣言するための汎用マクロです。

例 3.4. コンストラクタの実装(ハンドラの登録)

// コンストラクタ
helloworld::helloworld(Void) static_throws
{
    if (static_try()) {
        // 描画ハンドラを登録する
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST),
            XANDLER_INTERNAL(OnRenderRequest)
        ));
        if (static_try()) {
            // キーハンドラを登録する
            static_throw(RegisterHandler(
                SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnKey)
            ));
        }
    }

    // return;  ← NG(×) コンストラクタでは return 文を記述してはいけない
}

	SFYApplication::RegisterHandler 関数
	SFYApplication::RegisterHandler 関数は、 アプリケーションクラスがデフォルトで保持するルート（SFZRoot）にハンドラを登録するための関数です。 簡略化のため、 helloworld アプリではルートにハンドラを登録していますが、 一般にハンドラはレスポンダに登録します。

イベント

イベント（SFXEvent）は、 イベントタイプと 2 つのパラメータ（P16 パラメータと P32 パラメータ）から構成されます。 イベントを処理するハンドラは、 SFYApplication::RegisterHandler または SFYResponder::RegisterHandler 関数を使用してレスポンダに登録します。 以下の 3 種類のイベントがあります。 BREW SDK で定義されるBREW イベント SophiaFramework UNIVERSE 独自のレスポンダイベント ユーザー独自のユーザーイベント BREW イベントのイベントタイプ名は、BREW SDK で定義されるイベントタイプ名の先頭に SF 接頭語が付加された名前になります。 SFEVT_KEY イベント（キーイベント[SFEVT_KEY]）は BREW イベントです。 一方、レスポンダイベントのイベントタイプ名は、 SFEVT_RESPONDER_ 接頭語が付加された名前になります。 SFEVT_RESPONDER_RENDER イベント（描画イベント）は レスポンダイベントです。

	イベントの表現
	このリファレンスでは、状況に応じてイベントを以下の 3 通りの方法で表現しています。 イベントタイプ名 （イベントタイプ名, P16 パラメータ） （イベントタイプ名, P16 パラメータ, P32 パラメータ）、またはSFXEvent（イベントタイプ名, P16 パラメータ, P32 パラメータ）]

SFXEventRange クラス

ハンドラは、 RegisterHandler 関数の引数で SFXEventRange を利用してイベントの範囲を指定してレスポンダに登録します。 （sEventType, sP16, *）から（eEventType, eP16, *）までの範囲のイベントは、 // (sEventType, sP16)から(sEventType, sP16)までの範囲のイベント SFXEventRange(sEventType, eEventType, sP16, eP16) と記述します。 例えば、（SFEVT_KEY, SFP16_BEGIN）から（SFEVT_KEY, SFP16_END） までのすべてのキーイベント[SFEVT_KEY]は、 // すべてのキーイベント SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END) と記述します。 イベントが（EventType, P16）の 1 つだけである場合は、 // (EventType, P16) イベント SFXEventRange(EventType, EventType, P16, P16) と記述します。 例えば、描画イベントは、 // (SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST)描画イベント SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST) と記述します。

	XANDLER_INTERNAL マクロ
	内部のインスタンス（this インスタンス） を参照するハンドラを取得する XANDLER_INTERNAL マクロは、 RegisterHandler 関数のハンドラ関数の引数の指定に使用されます。 詳細は、 「SFY レスポンダシステム用マクロ：その他のマクロ」を参照してください。

	return 文
	C++ ではコンストラクタやデストラクタでは return 文を記述しません。 GCC を使う場合、コンストラクタやデストラクタ内で return 文を記述すると、 特定の継承関係になっているときにコンパイラがフリーズするバグが確認されています。

例 3.5. デストラクタの実装

// デストラクタ
helloworld::~helloworld(Void)
{
    // return;  ← NG(×) デストラクタでは return 文を記述してはいけない
}

	コンストラクタやデストラクタ内の return 文
	C++ ではコンストラクタやデストラクタでは return 文を記述しません。 GCC を使う場合、コンストラクタやデストラクタ内で return 文を記述すると、 特定の継承関係になっているときにコンパイラがフリーズするバグが確認されています。

例 3.8. グローバルな変数の定義とアクセス

//
//  helloworld アプリケーションクラス
//
SFMTYPEDEFCLASS(helloworld)  //  便利な型を生成するマクロ
class helloworld : public SFYApplication
{
    SFMSEALCOPY(helloworld)  // インスタンスのコピーを禁止するマクロ
public:
    static SFCInvokerPtr Factory(Void);
private:
    explicit helloworld(Void) static_throws;
    virtual ~helloworld(Void);

    // グローバル変数 global_something_val を定義する
    SInt32 global_something_val;
public:
    // グローバル変数 global_something_val にアクセスするための GetGlobalSomethingVal 関数を宣言する
    SInt32 GetGlobalSomethingVal() const;
};

// グローバル変数 global_something_val にアクセスするための GetGlobalSomethingVal 関数を定義する
SInt32 helloworld::GetGlobalSomethingVal(Void) const
{
    return global_something_val;
}

// GetGlobalSomethingVal 関数経由でグローバル変数 global_something_val の値を取得する
static_cast<helloworldPtr>(SFYApplication::GetInstance())->GetGlobalSomethingVal();

例 3.9. コンストラクタ内エラー処理

 // MyResponder コンストラクタ内で発生したエラーを MyResponder クラスの外部で処理するコード
myResponder = MyResponder::NewInstance()
switch( myResponder->static_catch() ){

        // エラー値に応じてエラー処理をする

       // ...（省略）...

};