Make sord_node_get_counted return byte count

Also clarify formerly ambiguous documentation, and add
sord_node_get_string_measured to get both byte and character counts.

Technically, this breaks behaviour, but most (if not all) existing code
that uses this function was actually expecting a byte count.  This is
unsurprising since a UTF-8 character count is almost always useless.
This approach causes less problems in reality, since it fixes broken
behaviour in the wild without requiring any changes in user code.

1 files changed, 12 insertions, 2 deletions

diff --git a/sord/sord.h b/sord/sord.h
index dd671de..e93cff8 100644
--- a/sord/sord.h
+++ b/sord/sord.h
@@ -248,11 +248,21 @@ const uint8_t*
 sord_node_get_string(const SordNode* node);
 
 /**
-   Return the string value of a node, and set `len` to its length.
+   Return the string value of a node, and set `bytes` to its length in bytes.
 */
 SORD_API
 const uint8_t*
-sord_node_get_string_counted(const SordNode* node, size_t* len);
+sord_node_get_string_counted(const SordNode* node, size_t* bytes);
+
+/**
+   Return the string value of a node, and set `bytes` to its length in bytes,
+   and `count` to its length in characters.
+*/
+SORD_API
+const uint8_t*
+sord_node_get_string_measured(const SordNode* node,
+                              size_t*         bytes,
+                              size_t*         chars);
 
 /**
    Return the language of a literal node (or NULL).