text: provide public text_iterator_init

It can be used to initialize a (stack allocated) Iterator structure,
avoiding the copying of the return value as done by text_iterator_get
which depending on the implementation might be problematic.

1 files changed, 1 insertions, 0 deletions

diff --git a/text.h b/text.h
index 3bdb311..37e667b 100644
--- a/text.h
+++ b/text.h
@@ -250,6 +250,7 @@ char *text_bytes_alloc0(const Text*, size_t pos, size_t len);
  * @{
  */
 Iterator text_iterator_get(const Text*, size_t pos);
+bool text_iterator_init(const Text*, Iterator*, size_t pos);
 const Text *text_iterator_text(const Iterator*);
 bool text_iterator_valid(const Iterator*);
 bool text_iterator_has_next(const Iterator*);