From 23c38e4e7c8ac5370802f5158ea3085e8d58081a Mon Sep 17 00:00:00 2001 From: des Date: Sun, 10 Jun 2001 15:48:04 +0000 Subject: sbuf_new(9) now returns a struct sbuf * instead of an int. If the caller does not provide a struct sbuf, sbuf_new(9) will allocate one and return a pointer to it. --- share/man/man9/sbuf.9 | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) (limited to 'share') diff --git a/share/man/man9/sbuf.9 b/share/man/man9/sbuf.9 index 220bec6..6c5b112 100644 --- a/share/man/man9/sbuf.9 +++ b/share/man/man9/sbuf.9 @@ -45,7 +45,7 @@ .Sh SYNOPSIS .Fd #include .Fd #include -.Ft int +.Ft struct sbuf *s .Fn sbuf_new "struct sbuf *s" "char *buf" "int length" "int flags" .Ft void .Fn sbuf_clear "struct sbuf *s" @@ -85,6 +85,13 @@ The function initializes the .Fa sbuf pointed to by its first argument. +If that pointer is +.Dv NULL , +.Fn sbuf_new +allocates a +.Fa struct sbuf +using +.Xr malloc 9 . The .Fa buf argument is a pointer to a buffer in which to store the actual string; @@ -213,7 +220,10 @@ or it is reinitialized to a sufficiently short string using .Fn sbuf_cpy . .Sh RETURN VALUES .Fn sbuf_new -returns \-1 if it failed to allocate a storage buffer, and zero +returns +.Dv NULL +if it failed to allocate a storage buffer, and a pointer to the new +.Fa sbuf otherwise. .Pp .Fn sbuf_setpos -- cgit v1.1