diff options
Diffstat (limited to 'include')
| -rw-r--r-- | include/serd/serd.h | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/include/serd/serd.h b/include/serd/serd.h index 47eca580..72a4c3fa 100644 --- a/include/serd/serd.h +++ b/include/serd/serd.h @@ -469,6 +469,18 @@ 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_PURE_API +size_t +serd_uri_string_length(SerdURIView uri); + +/** Write `uri` as a string to `sink`. This will call `sink` several times to emit the URI. @@ -476,7 +488,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 |