From d9ea0564d0954967788b688a224cf81f7892c4a7 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sun, 28 Feb 2021 14:24:24 -0500 Subject: Make serd_uri_string_length() precise and add it to public API --- include/serd/serd.h | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) (limited to 'include/serd/serd.h') diff --git a/include/serd/serd.h b/include/serd/serd.h index dd165360..af087ab5 100644 --- a/include/serd/serd.h +++ b/include/serd/serd.h @@ -576,6 +576,18 @@ SERD_API bool serd_uri_is_within(SerdURIView r, SerdURIView base); +/** + Return the length of `uri` as a string. + + This can be used to get the expected number of bytes that will be written by + serd_write_uri(). + + @return A string length in bytes, not including the null terminator. +*/ +SERD_API +size_t +serd_uri_string_length(SerdURIView uri); + /** Write `uri` as a string to `sink`. @@ -584,7 +596,9 @@ serd_uri_is_within(SerdURIView r, SerdURIView base); @param uri URI to write as a string. @param sink Sink to write string output to. @param stream Opaque user argument to pass to `sink`. - @return The number of bytes written. + + @return The number of bytes written, which is less than + `serd_uri_string_length(uri)` on error. */ SERD_API size_t -- cgit v1.2.1