diff options
author | Laurent Bercot <ska-skaware@skarnet.org> | 2020-11-24 11:26:35 +0000 |
---|---|---|
committer | Laurent Bercot <ska-skaware@skarnet.org> | 2020-11-24 11:26:35 +0000 |
commit | 680b08a9d69fcb3582203ca5e1e6f0ba88fea9e0 (patch) | |
tree | e81ba779f78f75a2683f06c2ff70737bdfbf1388 | |
parent | 8d67429c8b37415b04ec195dab9bdbcec8ec013a (diff) | |
download | execline-680b08a9d69fcb3582203ca5e1e6f0ba88fea9e0.tar.xz |
Better forstdin
No need for the complexity: the important distinction is between
"eof after reading something" and "eof right away". 0 is a natural
fit for eof after some data, and 1 is a natural fit for immediate eof.
Anything else can be scripted around this.
-rw-r--r-- | NEWS | 4 | ||||
-rw-r--r-- | doc/forstdin.html | 11 | ||||
-rw-r--r-- | doc/upgrade.html | 4 | ||||
-rw-r--r-- | src/execline/forstdin.c | 13 |
4 files changed, 16 insertions, 16 deletions
@@ -3,8 +3,8 @@ Changelog for execline. In 2.7.0.0 ---------- - - forstdin QoL changes: new -e option to exit nonzero on EOF, -and it now only splits on newlines by default. + - forstdin QoL changes: now it exits 1 if it doesn't read anything, +and it only splits on newlines by default. - New "default" directive to trap, replacing the irrelevant "timeout". diff --git a/doc/forstdin.html b/doc/forstdin.html index c7cc3d4..44939fe 100644 --- a/doc/forstdin.html +++ b/doc/forstdin.html @@ -30,7 +30,7 @@ run another program. </p> <pre> - forstdin [ -p | -o <em>okcodes</em> | -x <em>breakcodes</em> ] [ -e eofcode ] [ -n ] [ -C | -c ] [ -0 | -d <em>delim</em> ] <em>variable</em> <em>loop...</em> + forstdin [ -p | -o <em>okcodes</em> | -x <em>breakcodes</em> ] [ -E firsteofcode ] [ -e eofcode ] [ -n ] [ -C | -c ] [ -0 | -d <em>delim</em> ] <em>variable</em> <em>loop...</em> </pre> <ul> @@ -39,7 +39,8 @@ run another program. <li> For every argument <em>x</em> in the split output, <tt>forstdin</tt> runs <em>loop...</em> as a child process, with <em>variable</em>=<em>x</em> added to its environment. </li> - <li><tt>forstdin</tt> then exits 0. + <li><tt>forstdin</tt> then exits 0 if it has read something on stdin, +and 1 if it hasn't read anything. </li> </ul> <h2> Options </h2> @@ -63,8 +64,10 @@ not listed in <em>okcodes</em>, forstdin will exit immediately with an option, but with inverted meaning - the listed exit codes are codes that will make forstdin break the loop and exit, and the unlisted exit codes will make it keep looping. </li> - <li> <tt>-e</tt> <em>eofcode</em> : if forstdin reads EOF, -exit <em>eofcode</em>. Default is 0. </li> + <li> <tt>-E</tt> <em>firsteofcode</em> : if forstdin encounters +EOF on its first attempt to read data, exit <em>firsteofcode</em>. Default is 1. </li> + <li> <tt>-e</tt> <em>eofcode</em> : if forstdin has already +read data, and encounters EOF, exit <em>eofcode</em>. Default is 0. </li> <li> Other options are used to <a href="el_transform.html">control the substitution mechanism</a> for every <em>x</em>. Of course, you can't split <em>x</em>. The default delimiter for <tt>forstdin</tt> is a diff --git a/doc/upgrade.html b/doc/upgrade.html index 690c87e..d12b051 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -23,8 +23,8 @@ <ul> <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> dependency bumped to 2.9.4.0. </li> - <li> <a href="forstdin.html">forstdin</a> gets a new <tt>-e</tt> -option, and now only splits on newlines by default. </li> + <li> <a href="forstdin.html">forstdin</a> now exits 1 on immediate EOF, +and only splits on newlines by default. </li> <li> New <tt>default</tt> directive to <a href="trap.html">trap</a>, replacing the <tt>timeout</tt> one, which was ill-suited to that program. </li> </ul> diff --git a/src/execline/forstdin.c b/src/execline/forstdin.c index 323ef59..1a329f2 100644 --- a/src/execline/forstdin.c +++ b/src/execline/forstdin.c @@ -18,7 +18,7 @@ #include <execline/config.h> #include <execline/execline.h> -#define USAGE "forstdin [ -p | -o okcode,okcode,... | -x breakcode,breakcode,... ] [ -e eofcode ] [ -n ] [ -C | -c ] [ -0 | -d delim ] var command..." +#define USAGE "forstdin [ -p | -o okcode,okcode,... | -x breakcode,breakcode,... ] [ -n ] [ -C | -c ] [ -0 | -d delim ] var command..." #define dieusage() strerr_dieusage(100, USAGE) static genalloc pids = GENALLOC_ZERO ; /* pid_t */ @@ -51,14 +51,13 @@ int main (int argc, char const **argv, char const *const *envp) size_t delimlen = 4 ; size_t nbc = 0 ; unsigned short okcodes[256] ; - int crunch = 0, chomp = 0, not = 1 ; - unsigned short eofcode = 0 ; + int crunch = 0, chomp = 0, not = 1, eofcode = 1 ; PROG = "forstdin" ; { subgetopt_t l = SUBGETOPT_ZERO ; for (;;) { - int opt = subgetopt_r(argc, argv, "pnCc0d:o:x:e:", &l) ; + int opt = subgetopt_r(argc, argv, "pnCc0d:o:x:", &l) ; if (opt == -1) break ; switch (opt) { @@ -81,9 +80,6 @@ int main (int argc, char const **argv, char const *const *envp) not = 1 ; if (!ushort_scanlist(okcodes, 256, l.arg, &nbc)) dieusage() ; break ; - case 'e' : - if (!ushort_scan(l.arg, &eofcode)) dieusage() ; - break ; default : dieusage() ; } } @@ -118,7 +114,6 @@ int main (int argc, char const **argv, char const *const *envp) if (chomp) break ; } else modif.len-- ; - if ((modif.len == modifstart) && crunch) continue ; } else { @@ -129,6 +124,8 @@ int main (int argc, char const **argv, char const *const *envp) else strerr_diefu1sys(111, "netstring_get") ; } } + eofcode = 0 ; + if (crunch && modif.len == modifstart) continue ; if (!stralloc_0(&modif)) strerr_diefu1sys(111, "stralloc_0") ; if (!env_merge(newenv, envlen+2, envp, envlen, modif.s, modif.len)) strerr_diefu1sys(111, "merge environment") ; |