mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-27 18:25:05 +00:00
d3d6814b2d
'+' flag can be used with signed integer type (%d) and causes positive
integers to be prefixed with '+' (e.g. +1745). This emphasizes output
values as a signed value. It can be mixed with left-justification flag
'-': %-+8d. It's ignored when used with unsigned integer or non-integer
types: %u, %x, %p, %s, %c, etc.
BUG=none
BRANCH=none
TEST=make buildall &&
int32_t d = 1745;
CPRINTS("'%-+8d'", -d); /* '-1745 ' */
CPRINTS("'%-+8d'", d); /* '+1745 ' */
CPRINTS("'%d'", d); /* '1745' */
CPRINTS("'%+08d'", -d); /* '000-1745' */
CPRINTS("'%+08d'", d); /* '000+1745' */
CPRINTS("'%+d'", -d); /* '-1745' */
CPRINTS("'%+d'", d); /* '+1745' */
CPRINTS("'%+s'", "foo"); /* 'foo' */
CPRINTS("'%-+8s'", "foo"); /* 'foo ' */
CPRINTS("'%+08x'", d); /* '000006d1' */
CPRINTS("'%+u'", d); /* '1745' */
Change-Id: I8dcd34b0cf03dbefc500b9c98fea235d85bde8d3
Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org>
Reviewed-on: https://chromium-review.googlesource.com/363924
86 lines
3.0 KiB
C
86 lines
3.0 KiB
C
/* Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
/* Printf-like functionality for Chrome EC */
|
|
|
|
#ifndef __CROS_EC_PRINTF_H
|
|
#define __CROS_EC_PRINTF_H
|
|
|
|
#include <stdarg.h> /* For va_list */
|
|
#include "common.h"
|
|
|
|
/*
|
|
* Printf formatting: % [flags] [width] [.precision] [length] [type]
|
|
*
|
|
* Flags may be any/all of the following, and must occur in the following
|
|
* order if present:
|
|
* - '0' = prefixed with 0's instead of spaces (%08x)
|
|
* - '-' = left-justify instead of right-justify (%-5s)
|
|
* - '+' = prefix positive value with '+' (%+d). Write '%-+' instead of
|
|
* '%+-' when used with left-justification. Ignored when
|
|
* used with unsigned integer types or non-integer types.
|
|
*
|
|
* Width is the minimum output width, and may be:
|
|
* - A number ("0" - "255")
|
|
* - '*' = use next integer argument as width
|
|
*
|
|
* Precision must be preceded by a decimal point, and may be:
|
|
* - A number ("0" - "255")
|
|
* - '*' = use next integer argument as precision
|
|
*
|
|
* For integers, precision will put a decimal point before that many digits.
|
|
* So snprintf(buf, size, "%.6d", 123) sets buf="0.000123". This is most
|
|
* useful for printing times, voltages, and currents.
|
|
*
|
|
* Length may be:
|
|
* - 'l' = integer is 64-bit instead of native 32-bit
|
|
*
|
|
* Type may be:
|
|
* - 'c' - character
|
|
* - 's' - null-terminated ASCII string
|
|
* - 'h' - binary data, print as hex; precision is length of data in bytes.
|
|
* So "%.8h" prints 8 bytes of binary data
|
|
* - 'p' - pointer
|
|
* - 'd' - signed integer
|
|
* - 'u' - unsigned integer
|
|
* - 'x' - unsigned integer, print as lower-case hexadecimal
|
|
* - 'X' - unsigned integer, print as upper-case hexadecimal
|
|
* - 'b' - unsigned integer, print as binary
|
|
*
|
|
* Special format codes:
|
|
* - "%T" - current time in seconds - interpreted as "%.6T" for precision.
|
|
* This does NOT use up any arguments.
|
|
*/
|
|
|
|
/**
|
|
* Print formatted output to a function, like vfprintf()
|
|
*
|
|
* @param addchar Function to be called for each character added.
|
|
* Will be passed the same context passed to vfnprintf(),
|
|
* and the character to add. Should return 0 if the
|
|
* character was accepted or non-zero if the character
|
|
* was dropped due to overflow.
|
|
* @param context Context pointer to pass to addchar()
|
|
* @param format Format string (see above for acceptable formats)
|
|
* @param args Parameters
|
|
* @return EC_SUCCESS, or non-zero if output was truncated.
|
|
*/
|
|
int vfnprintf(int (*addchar)(void *context, int c), void *context,
|
|
const char *format, va_list args);
|
|
|
|
/**
|
|
* Print formatted outut to a string.
|
|
*
|
|
* Guarantees null-termination if size!=0.
|
|
*
|
|
* @param str Destination string
|
|
* @param size Size of destination in bytes
|
|
* @param format Format string
|
|
* @return EC_SUCCESS, or non-zero if output was truncated.
|
|
*/
|
|
int snprintf(char *str, int size, const char *format, ...);
|
|
|
|
#endif /* __CROS_EC_PRINTF_H */
|