MtFmt: inc/mm_parser.h 源文件

浏览该文件的文档.
// SPDX-License-Identifier: LGPL-3.0
#if !defined(_INCLUDE_MM_PARSER_H_)
#include "mm_cfg.h"
#include "mm_result.h"
#include "mm_string.h"
#include "mm_type.h"
 
#define _INCLUDE_MM_PARSER_H_
#define MFMT_PARSER_STATE_SIZE    48
 
#define MFMT_PLACE_MAX_NUM        16
 
#define MFMT_PLACE_MAX_WIDTH      32
 
#define MFMT_CHRONO_PLACE_MAX_NUM 8
 
//
// 这个东东实现了一个超级小的支持类python的format语法的格式化器
// 并且提供了一些其它的格式化函数
//
 
typedef struct tagMStrFmtParserState MStrFmtParserState;
 
typedef enum tagMStrFmtArgClass
{
    MStrFmtArgClass_Value,
 
    MStrFmtArgClass_Array,
 
    MStrFmtArgClass_EscapeChar,
} MStrFmtArgClass;
 
typedef enum tagMStrFmtArgType
{
    MStrFmtArgType_Unknown,
 
    MStrFmtArgType_Int8,
 
    MStrFmtArgType_Int16,
 
    MStrFmtArgType_Int32,
 
    MStrFmtArgType_Uint8,
 
    MStrFmtArgType_Uint16,
 
    MStrFmtArgType_Uint32,
 
    MStrFmtArgType_CString,
 
    MStrFmtArgType_Time,
 
    MStrFmtArgType_QuantizedValue,
 
    MStrFmtArgType_QuantizedUnsignedValue,
 
    MStrFmtArgType_Array_Bit = 0x1000,
 
    MStrFmtArgType_Array_Int8,
 
    MStrFmtArgType_Array_Int16,
 
    MStrFmtArgType_Array_Int32,
 
    MStrFmtArgType_Array_Uint8,
 
    MStrFmtArgType_Array_Uint16,
 
    MStrFmtArgType_Array_Uint32,
 
    MStrFmtArgType_Array_CString,
 
    MStrFmtArgType_Array_Time,
 
    MStrFmtArgType_Array_QuantizedValue,
 
    MStrFmtArgType_Array_QuantizedUnsignedValue,
} MStrFmtArgType;
 
typedef enum tagMStrFmtAlign
{
    MStrFmtAlign_Left,
 
    MStrFmtAlign_Center,
 
    MStrFmtAlign_Right,
} MStrFmtAlign;
 
typedef enum tagMStrFmtSignDisplay
{
    MStrFmtSignDisplay_Always,
 
    MStrFmtSignDisplay_NegOnly,
 
    MStrFmtSignDisplay_Neg_Or_Space,
} MStrFmtSignDisplay;
 
typedef enum tagMStrFmtFormatType
{
    MStrFmtFormatType_UnSpec,
 
    MStrFmtFormatType_Binary,
 
    MStrFmtFormatType_Oct,
 
    MStrFmtFormatType_Deciaml,
 
    MStrFmtFormatType_Hex,
 
    MStrFmtFormatType_Hex_UpperCase,
 
    MStrFmtFormatType_Hex_WithPrefix,
 
    MStrFmtFormatType_Hex_UpperCase_WithPrefix,
} MStrFmtFormatType;
 
typedef struct tagMStrFmtValueFormatSpec
{
    int reserved;
} MStrFmtValueFormatSpec;
 
typedef struct tagMStrFmtChronoValueFormatSpec
{
    mstr_bool_t fixed_length;
 
    uint8_t format_length;
} MStrFmtChronoValueFormatSpec;
 
typedef enum tagMStrFmtChronoValueType
{
    MStrFmtChronoValueType_Year,
 
    MStrFmtChronoValueType_Month,
 
    MStrFmtChronoValueType_Day,
 
    MStrFmtChronoValueType_Hour24,
 
    MStrFmtChronoValueType_Minute,
 
    MStrFmtChronoValueType_Second,
 
    MStrFmtChronoValueType_SubSecond,
 
    MStrFmtChronoValueType_Hour,
 
    MStrFmtChronoValueType_Week,
} MStrFmtChronoValueType;
 
typedef struct tagMStrFmtChronoItemFormatSpec
{
    MStrFmtChronoValueType value_type;
 
    MStrFmtChronoValueFormatSpec chrono_spec;
 
    const char* split_beg;
 
    const char* split_end;
} MStrFmtChronoItemFormatSpec;
 
typedef struct tagMStrFmtChronoFormatSpec
{
    MStrFmtChronoItemFormatSpec items[MFMT_CHRONO_PLACE_MAX_NUM];
 
    usize_t item_cnt;
} MStrFmtChronoFormatSpec;
 
typedef union tagMStrFmtFormatSpecUnion {
    MStrFmtValueFormatSpec value;
 
    MStrFmtChronoFormatSpec chrono;
} MStrFmtFormatSpecUnion;
 
typedef struct tagMStrFmtFormatSpec
{
    MStrFmtFormatType fmt_type;
 
    MStrFmtFormatSpecUnion spec;
} MStrFmtFormatSpec;
 
typedef struct tagMStrFmtFormatDescript
{
    char fill_char;
 
    MStrFmtAlign fmt_align;
 
    MStrFmtSignDisplay sign_display;
 
    int32_t width;
 
    MStrFmtFormatSpec fmt_spec;
} MStrFmtFormatDescript;
 
typedef struct tagMStrFmtArgProperty
{
    uint32_t a, b;
} MStrFmtArgProperty;
 
typedef struct tagMStrFmtParseResultValueResult
{
    uint32_t id;
 
    MStrFmtArgType typ;
 
    MStrFmtArgProperty prop;
 
    MStrFmtFormatDescript spec;
 
    const char* reserved[2];
} MStrFmtParseResultValueResult;
 
typedef struct tagMStrFmtParseResultArrayResult
{
    uint32_t id;
 
    MStrFmtArgType ele_typ;
 
    MStrFmtArgProperty ele_prop;
 
    MStrFmtFormatDescript spec;
 
    const char* split_beg;
 
    const char* split_end;
} MStrFmtParseResultArrayResult;
 
typedef union tagMStrFmtParseResultValue {
    char escape_char;
 
    MStrFmtParseResultValueResult val;
 
    MStrFmtParseResultArrayResult arr;
} MStrFmtParseResultValue;
 
typedef struct tagMStrFmtParseResult
{
    MStrFmtArgClass arg_class;
 
    MStrFmtParseResultValue val;
} MStrFmtParseResult;
 
MSTR_EXPORT_API(void)
mstr_fmt_parser_init(
    byte_t* mem, const char* inp, MStrFmtParserState** ppstate
);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_parse_goal(
    MStrFmtParserState* state, MStrFmtParseResult* result
);
 
MSTR_EXPORT_API(usize_t)
mstr_fmt_parser_end_position(
    MStrFmtParserState* state, const char* pbeg
);
#endif // _INCLUDE_MM_FMT_H_