ws.h File Reference

#include "wsutf8.h"

Go to the source code of this file.

Data Structures
struct	WsCompilerParamsRec

Typedefs
typedef void(*	WsIOProc) (const char *data, size_t len, void *context)
typedef void(*	WsPragmaMetaProc) (const WsUtf8String *property_name, const WsUtf8String *content, const WsUtf8String *scheme, void *context)
typedef struct WsCompilerParamsRec	WsCompilerParams
typedef struct WsCompilerRec *	WsCompilerPtr

Enumerations
enum	WsResult {   WS_OK, WS_ERROR_OUT_OF_MEMORY, WS_ERROR_SYNTAX, WS_ERROR_SEMANTIC,   WS_ERROR_IO, WS_ERROR }

Functions
WsCompilerPtr	ws_create (WsCompilerParams *params)
void	ws_destroy (WsCompilerPtr compiler)
WsResult	ws_compile_file (WsCompilerPtr compiler, const char *input_name, FILE *input, FILE *output)
WsResult	ws_compile_data (WsCompilerPtr compiler, const char *input_name, const unsigned char *input, size_t input_len, unsigned char **output_return, size_t *output_len_return)
void	ws_free_byte_code (unsigned char *byte_code)
const char *	ws_result_to_string (WsResult result)

Typedef Documentation

WsCompilerParams

typedef struct WsCompilerParamsRec WsCompilerParams

Definition at line 182 of file ws.h.

WsCompilerPtr

typedef struct WsCompilerRec* WsCompilerPtr

Definition at line 185 of file ws.h.

WsIOProc

typedef void(* WsIOProc) (const char *data, size_t len, void *context)

Definition at line 84 of file ws.h.

WsPragmaMetaProc

typedef void(* WsPragmaMetaProc) (const WsUtf8String *property_name, const WsUtf8String *content, const WsUtf8String *scheme, void *context)

Definition at line 95 of file ws.h.

Enumeration Type Documentation

WsResult

enum WsResult

Enumerator
WS_OK
WS_ERROR_OUT_OF_MEMORY
WS_ERROR_SYNTAX
WS_ERROR_SEMANTIC
WS_ERROR_IO
WS_ERROR

Definition at line 203 of file ws.h.

{
    /* Successful termination */
    WS_OK,

    /* The compiler ran out of memory. */
    WS_ERROR_OUT_OF_MEMORY,

    /* The input was not syntactically correct. */
    WS_ERROR_SYNTAX,

    /* The input was not semantically correct. */
    WS_ERROR_SEMANTIC,

    /* IO error. */
    WS_ERROR_IO,

    /* A generic `catch-all' error code.  This should not be used.  More
       descriptive error messages should be generated instead. */
    WS_ERROR
} WsResult;

Function Documentation

ws_compile_data()

WsResult ws_compile_data	(	WsCompilerPtr	compiler,
		const char *	input_name,
		const unsigned char *	input,
		size_t	input_len,
		unsigned char **	output_return,
		size_t *	output_len_return
	)

Definition at line 206 of file ws.c.

References compile_stream(), WS_ERROR_OUT_OF_MEMORY, ws_stream_close(), and ws_stream_new_data_input().

Referenced by convert_wmlscript_to_wmlscriptc(), and main().

{
    WsResult result;
    WsStream *stream;

    /* Initialize the input stream. */
    stream = ws_stream_new_data_input(input, input_len);
    if (stream == NULL)
        return WS_ERROR_OUT_OF_MEMORY;

    result = compile_stream(compiler, input_name, stream, output_return,
                            output_len_return);

    ws_stream_close(stream);

    return result;
}

ws_compile_file()

WsResult ws_compile_file	(	WsCompilerPtr	compiler,
		const char *	input_name,
		FILE *	input,
		FILE *	output
	)

Definition at line 177 of file ws.c.

References compile_stream(), ws_bc_data_free(), WS_ERROR_IO, WS_ERROR_OUT_OF_MEMORY, WS_FALSE, WS_OK, ws_stream_close(), and ws_stream_new_file().

Referenced by main().

{
    WsResult result;
    WsStream *stream;
    unsigned char *bc;
    size_t bc_len;

    /* Initialize the input stream. */
    stream = ws_stream_new_file(input, WS_FALSE, WS_FALSE);
    if (stream == NULL)
        return WS_ERROR_OUT_OF_MEMORY;

    result = compile_stream(compiler, input_name, stream, &bc, &bc_len);

    ws_stream_close(stream);

    if (result == WS_OK) {
        /* Store the result to the file. */
        if (fwrite(bc, 1, bc_len, output) != bc_len)
            result = WS_ERROR_IO;

        ws_bc_data_free(bc);
    }

    return result;
}

ws_create()

WsCompilerPtr ws_create

(

WsCompilerParams *

params

)

Definition at line 135 of file ws.c.

References COMPILER_MAGIC, WsCompilerRec::magic, WsCompilerRec::params, std_io(), WsCompilerParamsRec::stderr_cb, WsCompilerParamsRec::stderr_cb_context, WsCompilerParamsRec::stdout_cb, WsCompilerParamsRec::stdout_cb_context, and ws_calloc().

Referenced by convert_wmlscript_to_wmlscriptc(), and main().

{
    WsCompilerPtr compiler = ws_calloc(1, sizeof(*compiler));

    if (compiler == NULL)
        return NULL;

    /* Store user params if specified. */
    if (params)
        compiler->params = *params;

    /* Basic initialization. */

    compiler->magic = COMPILER_MAGIC;

    if (compiler->params.stdout_cb == NULL) {
        compiler->params.stdout_cb = std_io;
        compiler->params.stdout_cb_context = stdout;
    }
    if (compiler->params.stderr_cb == NULL) {
        compiler->params.stderr_cb = std_io;
        compiler->params.stderr_cb_context = stderr;
    }

    return compiler;
}

ws_destroy()

void ws_destroy

(

WsCompilerPtr

compiler

)

Definition at line 163 of file ws.c.

References ws_free().

Referenced by main().

{
    if (compiler == NULL)
        return;

    ws_free(compiler);

#if WS_MEM_DEBUG
    if (ws_has_leaks())
        ws_dump_blocks();
#endif /* WS_MEM_DEBUG */
}

ws_free_byte_code()

void ws_free_byte_code

(

unsigned char *

byte_code

)

Definition at line 228 of file ws.c.

References ws_bc_data_free().

Referenced by main().

{
    ws_bc_data_free(byte_code);
}

ws_result_to_string()

const char* ws_result_to_string

(

WsResult

result

)

Definition at line 234 of file ws.c.

References code, and result_codes.

Referenced by convert_wmlscript_to_wmlscriptc(), and main().

{
    int i;

    for (i = 0; result_codes[i].description; i++) {
        if (result_codes[i].code == result)
            return result_codes[i].description;
    }

    return "unknown result code";
}