about summary refs log tree commit diff
path: root/libste.3
diff options
context:
space:
mode:
Diffstat (limited to 'libste.3')
-rw-r--r--libste.319
1 files changed, 19 insertions, 0 deletions
diff --git a/libste.3 b/libste.3
index 994d12a..717cd85 100644
--- a/libste.3
+++ b/libste.3
@@ -19,6 +19,8 @@
 .Fn stechr "const char *src" "const char *end" "int c"
 .Ft "char *"
 .Fn steprn "char *dst" "char *end" "const char *fmt" "..."
+.Ft "char *"
+.Fn steprl "char *dst" "char *end" "long n"
 .Sh DESCRIPTION
 .Nm libste
 provides five useful functions for dealing with strings.
@@ -106,6 +108,23 @@ On truncation,
 .Fa end
 is returned.
 .Pp
+.Nm steprl
+formats
+.Fa n
+as a decimal number
+.Pq potentially with a leading minus
+and appends it to
+.Fa dst ,
+but writes no characters beyond
+.Fa end .
+If any characters are written,
+.Fa dst
+will be NUL-terminated
+and the return value is a pointer to the NUL byte.
+On truncation,
+.Fa end
+is returned.
+.Pp
 Note that it is safe to pass the return value of all functions listed above
 as argument for
 .Fa dst