X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=internals%2F_PDCLIB_encoding.h;h=b29fe93d0a8acba5d715c1326cdb24740a14c60b;hp=81e6a9ef615949157b4db2505eaacfb66c2c5793;hb=42fd57564862984972524bf7133f82e5b4120932;hpb=c4820b95d793b05a0f5930789d3983b4bfc9ad18

diff --git a/internals/_PDCLIB_encoding.h b/internals/_PDCLIB_encoding.h
index 81e6a9e..b29fe93 100644
--- a/internals/_PDCLIB_encoding.h
+++ b/internals/_PDCLIB_encoding.h
@@ -120,6 +120,14 @@ static inline _PDCLIB_size_t _PDCLIB_c32rtowc(
 #endif
 
 typedef struct {
+    /* Reads at most *_P_insz bytes from *_P_inbuf and writes the result into 
+     * *_P_outbuf, writing at most *_P_outsz characters. Updates *_P_outbuf,
+     * *_P_outsz, *_P_inbuf, *_P_outsz with the resulting state
+     *
+     * Returns true if the conversion completed successfully (i.e. one of 
+     * _P_outsize or _P_insize reached zero and no coding errors were 
+     * encountered), else return false.
+     */
     _PDCLIB_bool_t (*__mbtoc32)(
         _PDCLIB_char32_t       **_PDCLIB_restrict   _P_outbuf,
         _PDCLIB_size_t          *_PDCLIB_restrict   _P_outsz,