hyung-hwan/qse
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Browse Source
This commit is contained in:
hyung-hwan 2008-07-20 08:48:47 +00:00
parent 892aebdfcd
commit 39d80c6e86
2 changed files with 96 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ase/doc/doxyfile
View File

@ -5,7 +5,7 @@
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
PROJECT_NAME = ase PROJECT_NAME = ase
PROJECT_NUMBER = PROJECT_NUMBER =
OUTPUT_DIRECTORY = ../out/doc OUTPUT_DIRECTORY = ./api
CREATE_SUBDIRS = NO CREATE_SUBDIRS = NO
OUTPUT_LANGUAGE = English OUTPUT_LANGUAGE = English
USE_WINDOWS_ENCODING = YES USE_WINDOWS_ENCODING = YES
@ -25,7 +25,7 @@ ABBREVIATE_BRIEF = "The $name class" \
ALWAYS_DETAILED_SEC = NO ALWAYS_DETAILED_SEC = NO
INLINE_INHERITED_MEMB = NO INLINE_INHERITED_MEMB = NO
FULL_PATH_NAMES = YES FULL_PATH_NAMES = YES
STRIP_FROM_PATH = ../inc STRIP_FROM_PATH = ../include
STRIP_FROM_INC_PATH = STRIP_FROM_INC_PATH =
SHORT_NAMES = NO SHORT_NAMES = NO
JAVADOC_AUTOBRIEF = YES JAVADOC_AUTOBRIEF = YES
@ -82,7 +82,7 @@ WARN_LOGFILE =
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
# configuration options related to the input files # configuration options related to the input files
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
INPUT = ../inc/ase INPUT = ../include/ase
FILE_PATTERNS = *.h \ FILE_PATTERNS = *.h \
*.hxx \ *.hxx \
*.hpp \ *.hpp \

147
ase/include/ase/awk/awk.h
View File

@ -1,5 +1,7 @@
/* awk.h - functions to embed an AWK interpreter */
/* /*
* $Id: awk.h 268 2008-07-19 08:03:49Z baconevi $ * $Id: awk.h 269 2008-07-19 14:48:47Z baconevi $
* *
* {License} * {License}
*/ */
@ -7,13 +9,6 @@
#ifndef _ASE_AWK_AWK_H_ #ifndef _ASE_AWK_AWK_H_
#define _ASE_AWK_AWK_H_ #define _ASE_AWK_AWK_H_
/**
* @file awk.h
* @brief Defines an AWK interpreter
*
* This file defines most of the data types and functions required to embed
* a AWK interpreter engine.
*/
#include <ase/types.h> #include <ase/types.h>
#include <ase/macros.h> #include <ase/macros.h>
@ -164,11 +159,13 @@ enum ase_awk_option_t
* operator(.), and a parse-time function check. */ * operator(.), and a parse-time function check. */
ASE_AWK_EXPLICIT = (1 << 1), ASE_AWK_EXPLICIT = (1 << 1),
#if 0
/* a function name should not coincide to be a variable name */ /* a function name should not coincide to be a variable name */
/*ASE_AWK_UNIQUEFN = (1 << 2),*/ /*ASE_AWK_UNIQUEFN = (1 << 2),*/
/* allow variable shading */ /* allow variable shading */
/*ASE_AWK_SHADING = (1 << 3),*/ /*ASE_AWK_SHADING = (1 << 3),*/
#endif
/* support shift operators */ /* support shift operators */
ASE_AWK_SHIFT = (1 << 4), ASE_AWK_SHIFT = (1 << 4),
@ -601,51 +598,85 @@ extern ase_awk_val_t* ase_awk_val_zero;
/** @brief represents a numeric value 1 */ /** @brief represents a numeric value 1 */
extern ase_awk_val_t* ase_awk_val_one; extern ase_awk_val_t* ase_awk_val_one;
/** /*
* @brief creates an instance of ase_awk_t * create an ase_awk_t instance
* @param mmgr the pointer to a memory manager *
* @return a pointer to an ase_awk_t instance on success, ASE_NULL on failure * The ase_awk_open() function is used to create a new ase_awk_t instance.
* The instance created can be passed to other ase_awk_xxx() functions and
* is valid until it is successfully destroyed using the ase_ase_close()
* function.
*
* returns the pointer to an ase_awk_t instance on success, ASE_NULL on failure
*/ */
/*ase_awk_t* ase_awk_open (const ase_awk_prmfns_t* prmfns);*/ ase_awk_t* ase_awk_open (
ase_awk_t* ase_awk_open (const ase_mmgr_t* mmgr); /* memory manager */
const ase_mmgr_t* mmgr
);
/** /*
* @brief destroys an instance of ase_awk_t * destroy an ase_awk_instance
* @param awk the pointer to an ase_awk_t instance to destory *
* @return 0 on success, -1 on failure * An ase_awk_t instance should be destroyed using the ase_awk_close() function
* when finished being used. The instance passed is not valid any more once
* the function returns success.
*
* returns 0 on success, -1 on failure
*/ */
int ase_awk_close (ase_awk_t* awk); int ase_awk_close (
/* the pointer to an ase_awk_t instance */
ase_awk_t* awk
);
/** /*
* @brief clears an awk interpreter * clear an ase_awk_t instance
* @param awk the pointer to an ase_awk_t instance to clear *
* @return 0 on success, -1 on failure * If you want to reuse an ase_awk_t instance that finished being used,
* you may call ase_awk_close instead of destroying and creating a new
* ase_awk_t instance using ase_awk_close() and ase_awk_open().
*
* returns 0 on success, -1 on failure
*/ */
int ase_awk_clear (ase_awk_t* awk); int ase_awk_clear (
/* the pointer to an ase_awk_t instance */
ase_awk_t* awk
);
/** /*
* @brief associates the user-specified data with an interpreter * associate the user-specified data with an ase_awk_t instance
* @param awk the pointer to an ase_awk_t instance *
* @param data the pointer to a user-specified data * The ase_awk_setassocdata() function is used to associate custom data
* @return n/a * with an ase_awk_t instance. The associated data can be retrieved with
* the ase_awk_getassocdata() function.
*/ */
void ase_awk_setassocdata (ase_awk_t* awk, void* data); void ase_awk_setassocdata (
/* the pointer to an ase_awk_t instance */
ase_awk_t* awk,
/* the pointer to user-specified data */
void* data
);
/** /*
* @brief returns the user-specified data associated with an interpreter * return the user-specified data associated with an ase_awk_t instance
* @param awk the pointer to an ase_awk_t instance *
* @return The pointer to the user-specified data through ase_awk_setassocdata. * The ase_awk_getassocdata() function is used to retrieve custom data
* is returned. ASE_NULL is returned if ase_awk_setassocdata is never * specified by a user with the ase_awk_setassocdata() function.
* called. *
* returns the pointer to the user-specified data through ase_awk_setassocdata
* is returned. ASE_NULL is returned if ase_awk_setassocdata was never called.
*/ */
void* ase_awk_getassocdata (ase_awk_t* awk); void* ase_awk_getassocdata (
/* the pointer to an ase_awk_t instance */
ase_awk_t* awk
);
/** /*
* @brief returns the pointer to the memory manager in use * return the pointer to the memory manager in use
* @param awk the pointer to an ase_awk_t instance * returns the pointer to the memory manager set through ase_awk_open
* @return the pointer to the memory manager set through ase_awk_open
*/ */
ase_mmgr_t* ase_awk_getmmgr (ase_awk_t* awk); ase_mmgr_t* ase_awk_getmmgr (
/* the pointer to an ase_awk_t instance */
ase_awk_t* awk
);
const ase_char_t* ase_awk_geterrstr (ase_awk_t* awk, int num); const ase_char_t* ase_awk_geterrstr (ase_awk_t* awk, int num);
int ase_awk_seterrstr (ase_awk_t* awk, int num, const ase_char_t* str); int ase_awk_seterrstr (ase_awk_t* awk, int num, const ase_char_t* str);
@ -675,8 +706,9 @@ void ase_awk_setmaxdepth (ase_awk_t* awk, int types, ase_size_t depth);
int ase_awk_getword (ase_awk_t* awk, int ase_awk_getword (ase_awk_t* awk,
const ase_char_t* okw, ase_size_t olen, const ase_char_t* okw, ase_size_t olen,
const ase_char_t** nkw, ase_size_t* nlen); const ase_char_t** nkw, ase_size_t* nlen);
/**
* Enables replacement of a name of a keyword, intrinsic global variables, /*
* enable replacement of a name of a keyword, intrinsic global variables,
* and intrinsic functions. * and intrinsic functions.
* *
* If nkw is ASE_NULL or nlen is zero and okw is ASE_NULL or olen is zero, * If nkw is ASE_NULL or nlen is zero and okw is ASE_NULL or olen is zero,
@ -684,20 +716,25 @@ int ase_awk_getword (ase_awk_t* awk,
* it unsets the replacement for okw and olen. If all of them are valid, * it unsets the replacement for okw and olen. If all of them are valid,
* it sets the word replace for okw and olen to nkw and nlen. * it sets the word replace for okw and olen to nkw and nlen.
* *
* @return * returns 0 on success, -1 on failure
* On success, 0 is returned.
* On failure, -1 is returned.
*/ */
int ase_awk_setword (ase_awk_t* awk, int ase_awk_setword (
const ase_char_t* okw, ase_size_t olen, /* the pointer to an ase_awk_t instance */
const ase_char_t* nkw, ase_size_t nlen); ase_awk_t* awk,
/* the pointer to an old keyword */
const ase_char_t* okw,
/* the length of the old keyword */
ase_size_t olen,
/* the pointer to an new keyword */
const ase_char_t* nkw,
/* the length of the new keyword */
ase_size_t nlen
);
/** /*
* Sets the customized regular processing routine. * set the customized regular processing routine. (TODO: NOT YET IMPLEMENTED)
* *
* @return * returns 0 on success, -1 on failure
* On success, 0 is returned.
* On failure, -1 is returned.
*/ */
int ase_awk_setrexfns (ase_awk_t* awk, ase_awk_rexfns_t* rexfns); int ase_awk_setrexfns (ase_awk_t* awk, ase_awk_rexfns_t* rexfns);