#include <SFBWebUtil.h.hpp>

class SFBWebUtil : public SFBQuery;

SFMTYPEDEFWRAPPER(SFBWebUtil)

[ public ]
SInt32 DecodeBase64(
    VoidConstPtr in   // 入力
                      // Base64 でエンコードされ、null 終結 
    VoidPtr out       // 出力バッファ
);

[ public ]
SInt32 DecodeBase64(
    SFXBufferConstRef in   // 入力
                           // Base64 でエンコードされ、null 終結
    SFXBufferPtr out       // 出力バッファ 
                           // null の場合、何もせずに -2 を返す
);

[ public ]
ACharPtr EncodeBase64(
    VoidConstPtr in   // 入力
    SInt32 length     // in の長さ
    VoidPtr out       // 出力バッファ
);

[ public ]
Void EncodeBase64(
    SFXBufferConstRef in   // 入力
    SFXBufferPtr out       // 出力バッファ
                           // null の場合、メソッドは何もしないで終了する
);

[ public ]
SFXBuffer EncodeBase64(
    SFXBufferConstRef in   // 入力
);

[ public ]
SInt32 MakeUrl(
    ACharConstPtr base       // null 終結のベース URL ( null の場合もある)
    ACharConstPtr relative   // null 終結の相対ベース URL ( null の場合もある)
    ACharPtr result          // 完全 URL の格納先( null の場合もある)
    SInt32 resultLength      // result のサイズ( バイト数 )
);

[ public ]
SInt32 MakeUrl(
    SFXAnsiStringConstRef base       // null 終結のベース URL ( null の場合もある)
    SFXAnsiStringConstRef relative   // null 終結の相対ベース URL ( null の場合もある)
    SFXAnsiStringPtr result          // 完全 URL の格納先( null の場合もある)
);

[ public ]
SFXAnsiString MakeUrl(
    SFXAnsiStringConstRef base       // null 終結のベース URL ( null の場合もある)
    SFXAnsiStringConstRef relative   // null 終結の相対ベース URL ( null の場合もある)
);

[ public, static ]
SFBWebUtilSmp NewInstance(
    SFCErrorPtr exception = null   // エラー値
);

[ public, static ]
SFBWebUtilSmp NewInstance(
    AEECLSID id                    // クラスID
    SFCErrorPtr exception = null   // エラー値
);

[ public ]
SInt32 ParseFormFields(
    ACharHandle in         // x-www-urlencoded エンコードの名前 / 値のペアリストへのポインタ
                           // リターン時は、次のフォームフィールドの先頭に設定される in と *in 
                           // どちらも null であってはならない
    WebFormField* fields   // 構文解析後の値を格納する WebFormFields の配列 null の場合もある
    SInt32 maxFields       // fields 内の要素の数
    UInt32 flags           // 0、または WEBUTIL_PFFF_NODECODE の論理 OR 名前と値の URL デコードを抑止する
                           // fields には、未加工の null 終結しない値が格納される
                           // これは、フォームフィールドへの入力にバイナリデータが予想される場合に有用
                           // ( null を %00 としてエンコードできるため)
                           // WEBUTIL_PFFF_NOMUTATE - URL デコードと null 終結を抑止する fields には、
                           // *in へのポインタが格納される
                           // それ以上の構文解析はコール側で処理する必要がある
                           // in は次のフォームフィールドに設定されるが、*in が指しているメモリーは変更できない
);

[ public ]
SFCError ParseUrl(
    ACharConstPtr url   // 構文解析するnull 終結文字列
    UrlParts* parts     // 読み込む UrlParts 構造体へのポインタ
);

[ public ]
SFCError ParseUrl(
    SFXAnsiStringConstRef url   // 構文解析する null 終結文字列
    UrlParts* parts             // 読み込む UrlParts 構造体へのポインタ
);

[ public ]
ACharPtr UrlDecode(
    ACharConstPtr in      // デコードするバイトへのポインタ
    SInt32Ptr inLength    // in のサイズリターン時に、消費されたバイト数に設定される
    ACharPtr out          // デコードの出力バッファ
    SInt32Ptr outLength   // 入力時は、out のサイズ 
                          // out が null の場合、指定したバッファサイズに設定される
                          // out が非 null の場合、デコードされたデータの長さに設定される
                          // この長さは、デコードされた in が out のサイズよりも短い場合に 
                          // out のサイズよりも短いことがある
);

[ public ]
Void UrlDecode(
    SFXAnsiStringConstRef in   // デコードするバイトへのポインタ
    SInt32Ptr inLength         // in のサイズリターン時に、消費されたバイト数に設定される
    SFXAnsiStringPtr out       // デコードの出力バッファ
    SInt32Ptr outLength        // 入力時は、out のサイズ
                               // out が null の場合、指定したバッファサイズに設定される
                               // out が非 null の場合、デコードされたデータの長さに設定される
                               // この長さは、デコードされた in が out のサイズよりも短い場合に 
                               // out のサイズよりも短いことがある
);

[ public ]
ACharPtr UrlEncode(
    ACharConstPtr in      // エンコードする文字列へのポインタ
    SInt32Ptr inLength    // in の長さへのポインタリターン時に、正しくエンコードされたバイト数に設定される
    ACharPtr out          // エンコードしたバイトを書き込む場所カウント目的では null の場合もある
    SInt32Ptr outLength   // 入力時は、out のサイズ 
                          // out が null の場合、指定したバッファサイズに設定される
                          // out が非 null の場合、エンコードされたデータの長さに設定される
                          // この長さは、エンコードされた in が sizeof( out ) よりも短い場合に 
                          // sizeof( out )よりも短いことがある
);

[ public ]
Void UrlEncode(
    SFXAnsiStringConstRef in   // エンコードする文字列へのポインタ
    SInt32Ptr inLength         // in の長さへのポインタリターン時に、正しくエンコードされたバイト数に設定される
    SFXAnsiStringPtr out       // エンコードしたバイトを書き込む場所カウント目的では null の場合もある
    SInt32Ptr outLength        // 入力時は、out のサイズ 
                               // out が null の場合、指定したバッファサイズに設定される
                               // out が非 null の場合、エンコードされたデータの長さに設定される
                               // この長さは、エンコードされた in が sizeof( out ) よりも短い場合に 
                               // sizeof( out )よりも短いことがある
);