From 5e0e0df9b494bb9ef698533db42f2ea496046a32 Mon Sep 17 00:00:00 2001 From: Paul Vinciguerra Date: Thu, 5 Mar 2020 11:47:41 -0500 Subject: [PATCH] docs: document the unformat '%_' option Type: docs Change-Id: Id864fcff768a78aa313b193f2eaabe545d95bec4 Signed-off-by: Paul Vinciguerra --- docs/gettingstarted/developers/infrastructure.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/gettingstarted/developers/infrastructure.md b/docs/gettingstarted/developers/infrastructure.md index 12f96d5ad41..e50972d7dc1 100644 --- a/docs/gettingstarted/developers/infrastructure.md +++ b/docs/gettingstarted/developers/infrastructure.md @@ -278,6 +278,20 @@ The phrase "bitzero %|" means "set the specified bit in the supplied bitmask" if unformat parses "bitzero". Although it looks like it could be fairly handy, it's very lightly used in the code base. +`%_` toggles whether or not to skip input white space. + +For transition from skip to no-skip in middle of format string, skip input white space. For example, the following: + +```c +fmt = "%_%d.%d%_->%_%d.%d%_" +unformat (input, fmt, &one, &two, &three, &four); +``` +matches input "1.2 -> 3.4". +Without this, the space after -> does not get skipped. + + +``` + ### How to parse a single input line Debug CLI command functions MUST NOT accidentally consume input -- 2.16.6