|
@@ -66,9 +66,9 @@ typedef LSUP_rc (*term_enc_fn_t)(
|
|
* Implementations MUST set the "codec" member of the iterator to the address
|
|
* Implementations MUST set the "codec" member of the iterator to the address
|
|
* of the codec that generated it.
|
|
* of the codec that generated it.
|
|
*
|
|
*
|
|
- * @param[in] gr The graph to be encoded. The graph's namespace map is used by the
|
|
|
|
- * codec for namespace prefixing. The graph may only be freed after the loop is
|
|
|
|
- * finalized.
|
|
|
|
|
|
+ * @param[in] gr The graph to be encoded. The graph's namespace map is used by
|
|
|
|
+ * the codec for namespace prefixing. The graph may only be freed after the
|
|
|
|
+ * loop is finalized.
|
|
*
|
|
*
|
|
* @return A codec iterator handle to be passed to a #gr_codec_iter_fn_t
|
|
* @return A codec iterator handle to be passed to a #gr_codec_iter_fn_t
|
|
* function and, eventually, to a #gr_codec_done_fn_t function.
|
|
* function and, eventually, to a #gr_codec_done_fn_t function.
|
|
@@ -87,9 +87,9 @@ typedef LSUP_CodecIterator * (*gr_encode_init_fn_t)(const LSUP_Graph *gr);
|
|
*
|
|
*
|
|
* @param[out] res Handle to be populated with a string obtained from encoding.
|
|
* @param[out] res Handle to be populated with a string obtained from encoding.
|
|
* The output data should be UTF-8 [TODO or UTF-16] encoded. This pointer
|
|
* The output data should be UTF-8 [TODO or UTF-16] encoded. This pointer
|
|
- * should be eventually freed manually at the end of the loop. It is
|
|
|
|
- * reallocated at each iteration, so memory from a previous iteration may be
|
|
|
|
- * overwritten with new data.
|
|
|
|
|
|
+ * must be initialized (even to NULL) and should be eventually freed manually
|
|
|
|
+ * at the end of the loop. It is reallocated at each iteration, so memory from
|
|
|
|
+ * a previous iteration may be overwritten with new data.
|
|
*
|
|
*
|
|
* @return LSUP_OK if a new token was processed; LSUP_END if the end of the
|
|
* @return LSUP_OK if a new token was processed; LSUP_END if the end of the
|
|
* loop was reached.
|
|
* loop was reached.
|