#include <SFBWebUtil.h.hpp>

class SFBWebUtil : public SFBQuery;

SFMTYPEDEFWRAPPER(SFBWebUtil)

[ public ]
SInt32 DecodeBase64(
    VoidConstPtr in   // input, base64 encoded, null-terminated 
    VoidPtr out       // output buffer 
);

[ public ]
SInt32 DecodeBase64(
    SFXBufferConstRef in   // input, base64 encoded, null-terminated
    SFXBufferPtr out       // output buffer 
		// if null, do nothing and return -2
);

[ public ]
ACharPtr EncodeBase64(
    VoidConstPtr in   // input
    SInt32 length     // length of in
    VoidPtr out       // output buffer 
);

[ public ]
Void EncodeBase64(
    SFXBufferConstRef in   // input
    SFXBufferPtr out       // output buffer 
                           // if null, do nothing and terminate
);

[ public ]
SFXBuffer EncodeBase64(
    SFXBufferConstRef in   // input
);

[ public ]
SInt32 MakeUrl(
    ACharConstPtr base       // the null-terminated base URL (may be null) 
    ACharConstPtr relative   // the null-terminated relative URL (may be null) 
    ACharPtr result          // where to put the full URL (may be null) 
    SInt32 resultLength      // size (in bytes) of result 
);

[ public ]
SInt32 MakeUrl(
    SFXAnsiStringConstRef base       // the null-terminated base URL (may be null) 
    SFXAnsiStringConstRef relative   // the null-terminated relative URL (may be null) 
    SFXAnsiStringPtr result          // where to put the full URL (may be null) 
);

[ public ]
SFXAnsiString MakeUrl(
    SFXAnsiStringConstRef base       // the null-terminated base URL (may be null) 
    SFXAnsiStringConstRef relative   // the null-terminated relative URL (may be null) 
);

[ public, static ]
SFBWebUtilSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBWebUtilSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

[ public ]
SInt32 ParseFormFields(
    ACharHandle in         // input/output, pointer to the x-www-urlencoded list of name value pairs, 
                           // on return it is set to the beginning of the next form field. 
                           // neither In nor *In may be null
    WebFormField* fields   // array of WebFormFields to be filled once parsed, may be null
    SInt32 maxFields       // number of the elements in awff
    UInt32 flags           // either 0 or a logical OR of:
                           // WEBUTIL_PFFF_NODECODE - suppress URL decoding of name and value, 
                           // awff will be filled with raw, but null-terminated values. 
                           / this can be useful if you expect binary data in your form fields (since nulls may be encoded as %00) 
                           // WEBUTIL_PFFF_NOMUTATE - suppress URL decoding _and_ null-termination, 
                           // awff will be filled with pointers into *In, any further parsing must be undertaken by the caller. 
                           // in will be set to the next form field, but the memory pointed to by *ppszIn will not be modified
);

[ public ]
SFCError ParseUrl(
    ACharConstPtr url   // the null-terminated string to parse
    UrlParts* parts     // pointer to UrlParts struct to fill out 
);

[ public ]
SFCError ParseUrl(
    SFXAnsiStringConstRef url   // the null-terminated string to parse
    UrlParts* parts             // pointer to UrlParts struct to fill out 
);

[ public ]
ACharPtr UrlDecode(
    ACharConstPtr in      // pointer to bytes to decode 
    SInt32Ptr inLength    //  sizeof In, on return set to number of bytes consumed 
    ACharPtr out          // where to decode to 
    SInt32Ptr outLength   // on entry, this provides the maximum number of bytes to write into Out[].
                          // on exit, this holds the number of bytes written to Out[]. 
                          // when Out == null, this input value is ignored and the value on exit 
                          // will be the number of bytes required to hold the decoded string
);

[ public ]
Void UrlDecode(
    SFXAnsiStringConstRef in   // pointer to bytes to decode 
    SInt32Ptr inLength         // sizeof In, on return set to number of bytes consumed
    SFXAnsiStringPtr out       // where to decode to 
    SInt32Ptr outLength        // on entry, this provides the maximum number of bytes to write into Out[].
                               // on exit, this holds the number of bytes written to Out[]. 
                               // when Out == null, this input value is ignored and the value on exit 
                               // will be the number of bytes required to hold the decoded string
);

[ public ]
ACharPtr UrlEncode(
    ACharConstPtr in      // pointer to string to be encoded 
    SInt32Ptr inLength    // pointer to the length of In, set on return to number of bytes successfully encoded 
    ACharPtr out          // where to write encoded bytes, may be null, for counting 
    SInt32Ptr outLength   // on entry, this provides the maximum number of bytes to write into Out[].
		// on exit, this holds the number of bytes written to Out[].
		// when Out == null, this input value is ignored and the value on exit will be the number 
		// of bytes required to hold the encoded string
);

[ public ]
Void UrlEncode(
    SFXAnsiStringConstRef in   // pointer to string to be encoded 
    SInt32Ptr inLength         // pointer to the length of In, set on return to number of bytes successfully encoded 
    SFXAnsiStringPtr out       // where to write encoded bytes, may be null, for counting 
    SInt32Ptr outLength        // on entry, this provides the maximum number of bytes to write into Out[].
		// on exit, this holds the number of bytes written to Out[].
		// when Out == null, this input value is ignored and the value on exit will be the number 
		// of bytes required to hold the encoded string
);