spf

spf 的协作图:

函数
int	xwvsnpf (char *buf, xwsz_t size, const char *fmt, va_list args)
	格式化字符串（同vsnprintf）
int	xwsnpf (char *buf, xwsz_t size, const char *fmt,...)
	格式化字符串（同snprintf）
int	xwvspf (char *buf, const char *fmt, va_list args)
	格式化字符串（同vsprintf）
int	xwspf (char *buf, const char *fmt,...)
	格式化字符串（同sprintf）

详细描述

函数说明

xwvsnpf()

int xwvsnpf	(	char *	buf,
		xwsz_t	size,
		const char *	fmt,
		va_list	args
	)

格式化字符串（同vsnprintf）

< left justified

< unsigned/signed long

在文件 xwspf.c 第 1161 行定义.

{
        int rc;
        xwu64_t num;
        char * str, * end;
        struct xwvsnpf_format_spec spec = {0};
 
        if (size > XWSSZ_MAX) {
                /* Reject out-of-range values early. */
                rc = 0;
                goto err_oor;
        }
 
        str = buf;
        end = buf + size;
 
        /* Make sure end is always >= buf */
        if (end < buf) {
                end = ((void *)-1);
                size = (xwsz_t)(end - buf);
        }
 
        while (*fmt) {
                const char * oldfmt = fmt;
                int read = xwvsnpf_format_decode(fmt, &spec);
                fmt += read;
                switch (spec.type) {
                case XWVSNPF_FT_NONE: {
                        int copy = read;
                        if (str < end) {
                                if (copy > end - str) {
                                        copy = end - str;
                                }
                                memcpy(str, oldfmt, (xwsz_t)copy);
                        }
                        str += read;
                        break;
                }
 
                case XWVSNPF_FT_WIDTH:
                        spec.field_width = (xws16_t)va_arg(args, int);
                        break;
 
                case XWVSNPF_FT_PRECISION:
                        spec.precision = (xws16_t)va_arg(args, int);
                        break;
 
                case XWVSNPF_FT_CHAR: {
                        char c;
 
                        if (!(spec.flags & XWVSNPF_F_LEFT)) {
                                while (--spec.field_width > 0) {
                                        if (str < end) {
                                                *str = ' ';
                                        }
                                        ++str;
                                }
                        }
                        c = (char)va_arg(args, int);
                        if (str < end) {
                                *str = c;
                        }
                        ++str;
                        while (--spec.field_width > 0) {
                                if (str < end) {
                                        *str = ' ';
                                }
                                ++str;
                        }
                        break;
                }
 
                case XWVSNPF_FT_STR:
                        str = xwvsnpf_format_string(str, end, va_arg(args, char *),
                                                    spec);
                        break;
 
                case XWVSNPF_FT_PTR:
                        str = xwvsnpf_format_pointer(fmt+1, str, end,
                                                     va_arg(args, void *), spec);
                        while (isalnum((int)(*fmt))) {
                                fmt++;
                        }
                        break;
 
                case XWVSNPF_FT_PERCENT_CHAR:
                        if (str < end) {
                                *str = '%';
                        }
                        ++str;
                        break;
 
                case XWVSNPF_FT_INVALID:
                        if (str < end) {
                                *str = '%';
                        }
                        ++str;
                        break;
 
#if defined(XWLIBCFG_SPF_FLOAT) && (1U == XWLIBCFG_SPF_FLOAT)
                case XWVSNPF_FT_FLOAT:
                case XWVSNPF_FT_FLOAT_SCI:
                case XWVSNPF_FT_FLOAT_GENERAL:
                        str = xwvsnpf_format_float(str, end, va_arg(args, double), spec);
                        break;
 
#  if defined(XWLIBCFG_SPF_LONG_DOUBLE) && (1U == XWLIBCFG_SPF_LONG_DOUBLE)
                case XWVSNPF_FT_LONG_DOUBLE:
                case XWVSNPF_FT_LONG_DOUBLE_SCI:
                case XWVSNPF_FT_LONG_DOUBLE_GENERAL:
                        str = xwvsnpf_format_long_double(str, end, va_arg(args, long double), spec);
                        break;
#  endif /* XWLIBCFG_SPF_LONG_DOUBLE */
#endif /* XWLIBCFG_SPF_FLOAT */
 
                default:
                        switch (spec.type) {
                        case XWVSNPF_FT_LONG_LONG:
                                num = (xwu64_t)va_arg(args, long long);
                                break;
                        case XWVSNPF_FT_ULONG:
                                num = (xwu64_t)va_arg(args, unsigned long);
                                break;
                        case XWVSNPF_FT_LONG:
                                num = (xwu64_t)va_arg(args, long);
                                break;
                        case XWVSNPF_FT_XWSZ_T:
                                if (spec.flags & XWVSNPF_F_SIGN) {
                                        num = (xwu64_t)va_arg(args, xwssz_t);
                                } else {
                                        num = (xwu64_t)va_arg(args, xwsz_t);
                                }
                                break;
                        case XWVSNPF_FT_PTRDIFF:
                                num = (xwu64_t)va_arg(args, ptrdiff_t);
                                break;
                        case XWVSNPF_FT_INTMAX_T:
                                num = (xwu64_t)va_arg(args, intmax_t);
                                break;
                        case XWVSNPF_FT_UINTMAX_T:
                                num = (xwu64_t)va_arg(args, uintmax_t);
                                break;
                        case XWVSNPF_FT_UBYTE:
                                num = (xwu64_t)va_arg(args, int);
                                break;
                        case XWVSNPF_FT_BYTE:
                                num = (xwu64_t)va_arg(args, int);
                                break;
                        case XWVSNPF_FT_USHORT:
                                num = (xwu64_t)va_arg(args, int);
                                break;
                        case XWVSNPF_FT_SHORT:
                                num = (xwu64_t)va_arg(args, int);
                                break;
                        case XWVSNPF_FT_INT:
                                num = (xwu64_t)va_arg(args, int);
                                break;
                        default:
                                num = (xwu64_t)va_arg(args, unsigned int);
                        }
                        str = xwvsnpf_format_number(str, end, num, spec);
                }
        }
 
        if (size > 0) {
                if (str < end) {
                        *str = '\0';
                } else {
                        end[-1] = '\0';
                }
        }
        rc = str - buf;
err_oor:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwsnpf()

int xwsnpf	(	char *	buf,
		xwsz_t	size,
		const char *	fmt,
			...
	)

格式化字符串（同snprintf）

在文件 xwspf.c 第 1337 行定义.

{
        va_list args;
        int i;
 
        va_start(args, fmt);
        i = xwvsnpf(buf, size, fmt, args);
        va_end(args);
 
        return i;
}

函数调用图:

xwvspf()

int xwvspf	(	char *	buf,
		const char *	fmt,
		va_list	args
	)

格式化字符串（同vsprintf）

在文件 xwspf.c 第 1349 行定义.

{
        return xwvsnpf(buf, INT_MAX, fmt, args);
}

函数调用图:

这是这个函数的调用关系图:

xwspf()

int xwspf	(	char *	buf,
		const char *	fmt,
			...
	)

格式化字符串（同sprintf）

在文件 xwspf.c 第 1354 行定义.

{
        va_list args;
        int i;
 
        va_start(args, fmt);
        i = xwvspf(buf, fmt, args);
        va_end(args);
        return i;
}

函数调用图: