解説

擬似例外処理機構は、static_exception クラスとして提供されています。

template <typename T>
class static_exception {
  public:
    T const& static_catch(Void) const;
  protected:
    Bool static_try(Void) const;
    Void static_throw(static_exception<T> const& param);
    Void static_throw(T const& param);
};

擬似例外処理機構は SFCApplication や SFRApplication クラスなど static_exception<T> から派生したクラスで使えます。

使用例

class MyApp : public SFCApplication {
  SFMSEALCOPY(MyApp)
  private:
    Void SubFunc(Void) static_throws;    
    SFCError MyAllocation(Void) { ... }  // エラーが発生する可能性のある処理
  public:
    Void MainFunc(Void);
  ...
};

Void SubFunc(Void) static_throws
{
  // 現在のエラーをチェックする
  if (static_try()) {  
    // エラーが設定されていないとき
    static_throw(MyAllocation());  // エラーを設定する
  }
  ...
}

Void MainFunc(Void)
{
  ...
  SubFunc();
  switch (static_catch()) {
    // エラー内容に応じた処理
    ...
  }
  ...
}

解説

型名を引数にとり、以下の型宣言を生成します。

typedef Base&    BaseRef;
typedef Base*    BasePtr;
typedef Base**   BaseHandle;

解説

型名を引数にとり、以下の型宣言を生成します。

typedef Base volatile    BaseVolatile;
typedef BaseVolatile&    BaseVolatileRef;
typedef BaseVolatile*    BaseVolatilePtr;
typedef BaseVolatile**   BaseVolatileHandle;

解説

型名を引数にとり、以下の型宣言を生成します。

typedef Base const    BaseConst;
typedef BaseConst&    BaseConstRef;
typedef BaseConst*    BaseConstPtr;
typedef BaseConst**   BaseConstHandle;

解説

型名を引数にとり、以下の型宣言を生成します。

typedef Base volatile const   BaseVolatileConst;
typedef BaseVolatileConst&    BaseVolatileConstRef;
typedef BaseVolatileConst*    BaseVolatileConstPtr;
typedef BaseVolatileConst**   BaseVolatileConstHandle;

解説

型名を引数にとり、以下と等価な型宣言を行います。

SFMTYPEDEFBASE(Base)
SFMTYPEDEFVOLATILE(Base)
SFMTYPEDEFCONST(Base)
SFMTYPEDEFVOLATILECONST(Base)

解説

型名を引数にとり、以下と等価な型宣言を行います。

SFMTYPEDEFPACK(Base)
SFMTYPEDEFPACK(BasePtr)
SFMTYPEDEFPACK(BaseHandle)

解説

型名とその別名を引数にとり、以下と等価な型宣言を行います。

typedef Type   Alias;
SFMTYPEDEFTYPE(Alias);

解説

クラス名を引数にとり、以下と等価な型宣言を行います。

class Class;
SFMTYPEDEFTYPE(Class);

使用例

SFMTYPEDEFCLASS(A)
class A {
  ...
}

マクロ展開の例

SFMTYPEDEFTYPE マクロは以下のようにマクロ展開されます。

SFMTYPEDEFCLASS(MyClass);
class MyClass {
private:
  ...
};

class MyClass;
typedef MyClass&                     MyClassRef;
typedef MyClass*                     MyClassPtr;
typedef MyClass**                    MyClassHandle;
typedef MyClass volatile             MyClassVolatile;
typedef MyClass volatile&            MyClassVolatileRef;
typedef MyClass volatile*            MyClassVolatilePtr;
typedef MyClass volatile**           MyClassVolatileHandle;
typedef MyClass const                MyClassConst;
typedef MyClass const&               MyClassConstRef;
typedef MyClass const*               MyClassConstPtr;
typedef MyClass const**              MyClassConstHandle;
typedef MyClass volatile const       MyClassVolatileConst;
typedef MyClass volatile const&      MyClassVolatileConstRef;
typedef MyClass volatile const*      MyClassVolatileConstPtr;
typedef MyClass volatile const**     MyClassVolatileConstHandle;
typedef (MyClass*)&                  MyClassPtrRef;
typedef (MyClass*)*                  MyClassPtrPtr;
typedef (MyClass*)**                 MyClassPtrHandle;
typedef MyClass* volatile            MyClassPtrVolatile; 
typedef MyClass* volatile&           MyClassPtrVolatileRef;
typedef MyClass* volatile*           MyClassPtrVolatilePtr;
typedef MyClass* volatile**          MyClassPtrVolatileHandle;
typedef MyClass* const               MyClassPtrConst;
typedef MyClass* const&              MyClassPtrConstRef;
typedef MyClass* const*              MyClassPtrConstPtr;
typedef MyClass* const**             MyClassPtrConstHandle;
typedef MyClass* volatile const      MyClassPtrVolatileConst;
typedef MyClass* volatile const&     MyClassPtrVolatileConstRef;
typedef MyClass* volatile const*     MyClassPtrVolatileConstPtr;
typedef MyClass* volatile const**    MyClassPtrVolatileConstHandle;
typedef (MyClass**)&                 MyClassHandleRef;
typedef (MyClass**)*                 MyClassHandlePtr;
typedef (MyClass**)**                MyClassHandleHandle;
typedef MyClass** volatile           MyClassHandleVolatile;
typedef MyClass** volatile&          MyClassHandleVolatileRef;
typedef MyClass** volatile*          MyClassHandleVolatilePtr;
typedef MyClass** volatile**         MyClassHandleVolatileHandle;
typedef MyClass** const              MyClassHandleConst;
typedef MyClass** const&             MyClassHandleConstRef;
typedef MyClass** const*             MyClassHandleConstPtr;
typedef MyClass** const**            MyClassHandleConstHandle;
typedef MyClass** volatile const     MyClassHandleVolatileConst;
typedef MyClass** volatile const&    MyClassHandleVolatileConstRef;
typedef MyClass** volatile const*    MyClassHandleVolatileConstPtr;
typedef MyClass** volatile const**   MyClassHandleVolatileConstHandle;

class MyClass {
private:
  ...
};

解説

クラス名を引数にとり、以下と等価な型宣言を行います。

SFMTYPEDEFCLASS(Class)
SFMTYPEDEFALIAS(SFXBrewPointer<Class>, Class##Smp)
SFMTYPEDEFALIAS(SFXBrewPointer<Class volatile>, Class##VolatileSmp)
SFMTYPEDEFALIAS(SFXBrewPointer<Class const>, Class##ConstSmp)
SFMTYPEDEFALIAS(SFXBrewPointer<Class volatile const>, Class##VolatileConstSmp)

解説

クラス名を引数にとり、以下と等価な型宣言を行います。

SFMTYPEDEFCLASS(Class)
SFMTYPEDEFALIAS(SFXResponderPointer<Class>, Class##Smp)
SFMTYPEDEFALIAS(SFXResponderPointer<Class volatile>, Class##VolatileSmp)
SFMTYPEDEFALIAS(SFXResponderPointer<Class const>, Class##ConstSmp)
SFMTYPEDEFALIAS(SFXResponderPointer<Class volatile const>, Class##VolatileConstSmp)

解説

構造体名を引数にとり、以下の型宣言を行います。

struct Struct;
SFMTYPEDEFTYPE(Struct);

解説

共用体名を引数にとり、以下の型宣言を行います。

union Union;
SFMTYPEDEFTYPE(Union);

解説

クラス名または構造体名を引数にとり、 以下のような AtomRec 構造体からそれが定義されるクラスまたは構造体への暗黙の型変換演算子の宣言を生成します。

operator Class&(void);
operator Class const&(void) const;

AtomRec 構造体

AtomRec 構造体とは、クラスまたは構造体のメンバと同じメモリ配置を持つ C 言語の構造体と互換性のある POD(Plain Old Data) 構造体のことです。 詳細は、RealView コード生成ツールの最適化(Sophia Cradle 社 Web サイト)をご覧ください。 クラスや構造体に AtomRec 構造体を定義すると、 クラスや構造体の初期化コードのサイズと実行速度を最適化することができます。 このとき、AtomRec 構造体を定義するクラスでは仮想関数、多重継承、仮想継承を利用してはいけません。 AtomRec 構造体を利用するには、 SFMUTILITYATOMDECLARE マクロと SFMUTILITYATOMIMPLEMENT マクロを使って AtomRec 構造体からクラスまたは構造体への暗黙の型変換演算子と、 SFMUTILITYATOMICCASTDECLARE マクロと SFMUTILITYATOMICCASTIMPLEMENT マクロを使って AtomRec 構造体と、クラスまたは構造体の相互型変換関数(atomic_cast 演算子)を実装する必要があります。 AtomRec 構造体は、SFXEvent, SFXEventRange, 図形と色のクラスなどで利用されています。

	注意
	SFMUTILITYATOMDECLARE マクロを使用するときは、 これらの実装用マクロである SFMUTILITYATOMIMPLEMENT マクロも利用する必要があります。

通常、 このマクロは、 AtomRec 構造体が定義されるクラスまたは構造体と AtomRec 構造体を相互に型変換する関数(atomic_cast 演算子)の宣言・実装に使われる SFMUTILITYATOMICCASTDECLARE / SFMUTILITYATOMICCASTIMPLEMENT マクロと一緒に利用されます。

使用例

class Class {
  public:
    SFMTYPEDEFSTRUCT(AtomRec)
    struct AtomRec {
      SFMUTILITYATOMDECLARE(Class)

        ...

}

SFMUTILITYATOMICCASTDECLARE(Class, AtomRec)

SFMUTILITYATOMIMPLEMENT(Class, AtomRec)
SFMUTILITYATOMICCASTIMPLEMENT(Class, AtomRec)

解説

クラス名または構造体名と AtomRec 構造体名を引数にとり、 以下のような AtomRec 構造体からそれが定義されるクラスまたは構造体への暗黙の型変換演算子の実装を生成します。

inline Class::AtomicRec::operator Class&(void) 
{ 
    return *reinterpret_cast<Class*>(this); 
} 

inline Class::AtomicRec::operator Class const&(void) const
{ 
    return *reinterpret_cast<Class const*>(this);
}

	注意
	SFMUTILITYATOMIMPLEMENT は、実装用マクロとして SFMUTILITYATOMDECLARE マクロと一緒に使います。

使用例

class Class {
  public:
    SFMTYPEDEFSTRUCT(AtomRec)
    struct AtomRec {
      SFMUTILITYATOMDECLARE(Class)

        ...

}

SFMUTILITYATOMICCASTDECLARE(Class, AtomRec)

SFMUTILITYATOMIMPLEMENT(Class, AtomRec)
SFMUTILITYATOMICCASTIMPLEMENT(Class, AtomRec)

解説

クラス名または構造体名と AtomRec 構造体名を引数にとり、 以下のような AtomRec 構造体が定義されるクラスまたは構造体と、AtomRec 構造体を相互に型変換する関数(atomic_cast 演算子)の宣言を生成します。

extern Class* atomic_cast(Class::AtomRec* param); 
extern Class const* atomic_cast(Class::AtomRec const* param);
extern Class::AtomRec* atomic_cast(Class* param); 
extern Class::AtomRec const* atomic_cast(Class const* param);

	注意
	SFMUTILITYATOMICCASTDECLARE マクロを使用するときは、 これらの実装用マクロである SFMUTILITYATOMICCASTIMPLEMENT マクロも利用する必要があります。

通常、 このマクロは、 AtomRec 構造体からそれが定義されるクラスまたは構造体への暗黙の型変換演算子の宣言・実装に使われる SFMUTILITYATOMDECLARE / SFMUTILITYATOMIMPLEMENT マクロと一緒に利用されます。

使用例

class Class {
  public:
    SFMTYPEDEFSTRUCT(AtomRec)
    struct AtomRec {
      SFMUTILITYATOMDECLARE(Class)

        ...

}

SFMUTILITYATOMICCASTDECLARE(Class, AtomRec)

SFMUTILITYATOMIMPLEMENT(Class, AtomRec)
SFMUTILITYATOMICCASTIMPLEMENT(Class, AtomRec)

解説

クラス名または構造体名とその AtomRec 構造体名を引数にとり、 以下のような AtomRec 構造体が定義されるクラスまたは構造体と、AtomRec 構造体を相互に型変換する関数(atomic_cast 演算子)を生成します。

inline Class::AtomicRec* atomic_cast(Class* param)
{ 
    return reinterpret_cast<Class::AtomicRec*>(param);
} 

inline Class::AtomicRec const* atomic_cast(Class const* param)
{ 
    return reinterpret_cast<Class::AtomicRec const*>(param);
}

inline Class* atomic_cast(Class::AtomicRec* param)
{ 
    return reinterpret_cast<Class*>(param);
} 

inline Class const* atomic_cast(Class::AtomicRec const* param)
{ 
    return reinterpret_cast<Class const*>(param);
}

	注意
	SFMUTILITYATOMICCASTIMPLEMENT は、 実装用マクロとして SFMUTILITYATOMICCASTDECLARE マクロと一緒に使います。

使用例

class Class {
  public:
    SFMTYPEDEFSTRUCT(AtomRec)
    struct AtomRec {
      SFMUTILITYATOMDECLARE(Class)

        ...

}

SFMUTILITYATOMICCASTDECLARE(Class, AtomRec)

SFMUTILITYATOMIMPLEMENT(Class, AtomRec)
SFMUTILITYATOMICCASTIMPLEMENT(Class, AtomRec)

解説

static メンバのみで構成されるクラスはインスタンスを生成できません。

クラス名を引数にとり、以下のように展開されます。

private:
explicit Class(void);
Class(Class const&);
~Class(void);
const Class& operator=(Class const&);

使用例

SFMTYPEDEFCLASS(A)
class A {
  SFMSEALCONSTRUCT(A)
  ...
}

解説

ラッパークラスでは、 SFMSEALCONSTRUCT の代わりに SFMSEALWRAPPER を使います。

解説

レスポンダクラスでは、 SFMSEALCONSTRUCT の代わりに SFMSEALRESPONDER を使います。

解説

バッファを管理するクラスなどで、インスタンスのコピーに関する問題を回避します。

クラス名を引数にとり、以下のように展開されます。

private:
Class(Class const&);
Class& operator=(Class const&);

解説

クラスのインスタンスの代入に関する問題を回避します。

クラス名を引数にとり、以下のように展開されます。

private:
Class& operator=(Class const&);

解説

新たにレスポンダクラスを定義する場合、SFYResponder クラスからの継承の階層数に応じて SFMRESPONDERINSTANTIATEZERO、SFMRESPONDERINSTANTIATEONE、SFMRESPONDERINSTANTIATETWO、SFMRESPONDERINSTANTIATETHREE、 SFMRESPONDERINSTANTIATEFOUR、SFMRESPONDERINSTANTIATEFIVE、SFMRESPONDERINSTANTIATESIX、SFMRESPONDERINSTANTIATESEVEN マクロ使って SFYResponder クラスから新たに定義するクラスまでの継承順序を記述する必要があります。

上の例の場合、MyWindow は SFZWindow、SFZWindow は SFYContainer、 SFYContainer は SFYWidget、SFYWidget は SFYResponder というように SFYResponder から MyWindow まで 4 階層に渡って継承するので SFMRESPONDERINSTANTIATEFOUR マクロを使います。

SFYResponder からの継承が 3 階層の場合は SFMRESPONDERINSTANTIATETHREE マクロ、5 階層の場合は SFMRESPONDERINSTANTIATEFIVE マクロを使います。7 階層継承する場合の SFMRESPONDERINSTANTIATESEVEN マクロまで用意されています。

	RealView Compilation Tools for BREW 1.2 の不具合
	RealView Compilation Tools for BREW 1.2 コンパイラの不具合を回避するためのマクロです。 RealView Compilation Tools for BREW 1.2 以外のコンパイラでは無視されます。

解説

新たにラッパークラスを定義する場合、 SFBBase クラスからの継承の階層数に応じて SFMWRAPPERINSTANTIATEZERO、SFMWRAPPERINSTANTIATEONE、SFMWRAPPERINSTANTIATETWO、SFMWRAPPERINSTANTIATETHREE、 SFMWRAPPERINSTANTIATEFOUR、SFMWRAPPERINSTANTIATEFIVE、SFMWRAPPERINSTANTIATESIX、SFMWRAPPERINSTANTIATESEVEN マクロ使って SFBBase クラスから新たに定義するクラスまでの継承順序を記述する必要があります。

上の例の場合、IHash インターフェースは IBase インターフェースを継承しますので、 IBase インターフェースのラッパークラスを SFBBase クラスとすると、 IHash インターフェースのラッパークラスである SFBHash クラスは SFBBase クラスを継承するので SFMWRAPPERINSTANTIATEONE(SFBHash, SFBBase) とマクロ宣言します。

SFBBase クラスでは、継承関係で最上位に位置するので SFMWRAPPERINSTANTIATEZERO マクロを使ってこの部分は SFMWRAPPERINSTANTIATEZERO(SFBBase) とマクロ宣言します。

A、B、C の 3 つのラッパークラスがあり、B は A、C は B をそれぞれ継承する場合は SFMWRAPPERINSTANTIATETWO マクロを使って SFMWRAPPERINSTANTIATETWO(C, B, A) とマクロ宣言します。

A、B、C、D の 4 つのラッパークラスの場合は SFMWRAPPERINSTANTIATETHREE(D, C, B, A) とマクロ宣言します。

	RealView Compilation Tools for BREW 1.2 の不具合
	RealView Compilation Tools for BREW 1.2 コンパイラの不具合を回避するためのマクロです。 RealView Compilation Tools for BREW 1.2 以外のコンパイラでは無視されます。

使用例

4 文字リテラルの生成です。

SFCType val = four_char_code('A', 'b', 'c', 'd');
ACharPtr p = reinterpret_cast<ACharPtr>(&val);