aboutsummaryrefslogtreecommitdiffstats
path: root/cppawk-cons.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2022-04-05 19:22:52 -0700
committerKaz Kylheku <kaz@kylheku.com>2022-04-05 19:22:52 -0700
commit1c77097f7ebb99142ac349d98b3e87cb8b96020a (patch)
tree4ed1c1aace49e1e2e69063a4f3ec337b37888351 /cppawk-cons.1
parent4bd486a99fff29ad18eef64dee6c704319874048 (diff)
downloadcppawk-1c77097f7ebb99142ac349d98b3e87cb8b96020a.tar.gz
cppawk-1c77097f7ebb99142ac349d98b3e87cb8b96020a.tar.bz2
cppawk-1c77097f7ebb99142ac349d98b3e87cb8b96020a.zip
Add box_str function.
Diffstat (limited to 'cppawk-cons.1')
-rw-r--r--cppawk-cons.19
1 files changed, 8 insertions, 1 deletions
diff --git a/cppawk-cons.1 b/cppawk-cons.1
index bdbbc5b..215d669 100644
--- a/cppawk-cons.1
+++ b/cppawk-cons.1
@@ -59,6 +59,7 @@ cons \- Lisp-like data representation and control flow macros
box(av) // convert Awk number or string Lisp value.
unbox(lv) // convert Lisp value to Awk number or string.
+ box_str(av) // create Lisp boxed string from Awk value av
box_sym(av) // create Lisp symbol named av
cons(a, d) // create cons cell with car = a and cdr = d.
@@ -605,13 +606,14 @@ to distinguish numbers from non-numbers.
symbolp("Sabc") -> 1 // manually produced symbol abc
.ft R
-.SS Functions \fIbox\fP, \fIunbox\fP and \fIbox_sym\fP
+.SS Functions \fIbox\fP, \fIunbox\fP, \fIbox_str\fP and \fIbox_sym\fP
.bk
.B Syntax:
.ft B
box(av)
unbox(lv)
+ box_str(av)
box_sym(av)
.ft R
@@ -666,6 +668,11 @@ For any other value,
prints a diagnostic message and terminates the process.
The
+.B box_str
+function boxes an Awk value as a string, regardless of whether or
+not it is numeric.
+
+The
.B box_sym
function boxes an Awk value
.I av