MtFmt: inc/mm_fmt.h 源文件

浏览该文件的文档.
// SPDX-License-Identifier: LGPL-3.0
#if !defined(_INCLUDE_MM_FMT_H_)
#define _INCLUDE_MM_FMT_H_
#include "mm_cfg.h"
#include "mm_parser.h"
#include "mm_result.h"
#include "mm_string.h"
#include "mm_type.h"
 
typedef struct tagMStrFmtFormatArgument
{
    iptr_t value;
    MStrFmtArgType type;
} MStrFmtFormatArgument;
 
typedef struct tagMStrFmtArgsContext
{
    va_list* p_ap;
    usize_t max_place;
    MStrFmtFormatArgument cache[MFMT_PLACE_MAX_NUM];
} MStrFmtArgsContext;
 
typedef enum tagMStrFmtIntIndex
{
    MStrFmtIntIndex_Bin,
 
    MStrFmtIntIndex_Oct,
 
    MStrFmtIntIndex_Dec,
 
    MStrFmtIntIndex_Hex,
 
    MStrFmtIntIndex_Hex_UpperCase,
 
    MStrFmtIntIndex_Hex_WithPrefix,
 
    MStrFmtIntIndex_Hex_UpperCase_WithPrefix,
} MStrFmtIntIndex;
 
MSTR_EXPORT_API(mstr_result_t)
mstr_format(MString* res_str, const char* fmt, usize_t fmt_place, ...);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_vformat(
    const char* fmt,
    MString* res_str,
    usize_t fmt_place,
    va_list* ap_ptr
);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_context_format(
    MString* res_str, const char* fmt, MStrFmtArgsContext* ctx
);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_itoa(
    MString* str,
    int32_t value,
    MStrFmtIntIndex index,
    MStrFmtSignDisplay sign
);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_utoa(MString* res_str, uint32_t value, MStrFmtIntIndex index);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_iqtoa(
    MString* res_str,
    int32_t value,
    uint32_t quat,
    MStrFmtSignDisplay sign
);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_uqtoa(MString* res_str, uint32_t value, uint32_t quat);
 
MSTR_EXPORT_API(mstr_result_t)
mstr_fmt_ttoa(
    MString* res_str,
    const MStrTime* tm,
    const MStrFmtChronoFormatSpec* spec
);
#endif // !_INCLUDE_MM_FMT_H_