From 352a9060b6813c41527f0c5da43f0c86aecfde2a Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Mon, 2 Apr 2018 21:26:45 +0200 Subject: Add statefull preprocessing to rdline Signed-off-by: David Oberhollenzer --- lib/include/util.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'lib/include/util.h') diff --git a/lib/include/util.h b/lib/include/util.h index 9ba9ffb..6943567 100644 --- a/lib/include/util.h +++ b/lib/include/util.h @@ -43,6 +43,18 @@ typedef struct { cleared if end-of-file is reached. The line must be deallocated with free(). + + The following transformations are applied: + - Space characters are replaced with regular white space characters. + - Sequences of space characters are truncated to a single space. + - A '#' sign is interpreted as the start of a comment and removed, + together with everything that follows. + - Padding spaces are removed from the line. + - If a '"' is encounterd, the above rules are disabled, until a + after the matching '"' is read. A '"' can be escaped by preceeding + it with a backslash. + - If a second, coresponding '"' is not found, processing fails with + errno set to EILSEQ. */ char *rdline(int fd); -- cgit v1.2.3