One parsed conversion specification. More...

#include <ra8_esp_hosted_fmt_internal.h>

Data Fields
uint16_t	width
	Minimum field width; zero if absent.
uint8_t	consumed
	Characters consumed after the per-cent.
char	conv
	Conversion character, zero on failure.
ra8_esp_hosted_fmt_len_t	len
	Argument width from the length modifier.
bool	zero_pad
	The 0 flag was present.
bool	left_justify
	The - flag was present.

Detailed Description

One parsed conversion specification.

Produced by priv_ra8_esp_hosted_fmt_parse from the characters following a per-cent sign, and consumed by the formatter driver. Splitting parsing from emission is what keeps both functions inside the project's function length limit and lets the parser be tested on its own.

Invariant: consumed counts the characters after the per-cent sign, including the conversion character, and is zero only when the specification is malformed.; conv is zero when, and only when, parsing failed.

Example:: ra8_esp_hosted_fmt_spec_t spec = {};

if (priv_ra8_esp_hosted_fmt_parse("08x rest", &spec)) { emit(&spec); }

priv_ra8_esp_hosted_fmt_parse
bool priv_ra8_esp_hosted_fmt_parse(const char *after_percent, ra8_esp_hosted_fmt_spec_t *out)
Parse one conversion specification.
Definition ra8_esp_hosted_fmt.c:419

ra8_esp_hosted_fmt_spec_t
struct ra8_esp_hosted_fmt_spec ra8_esp_hosted_fmt_spec_t