Add ocr

Signed-off-by: Mattias Andrée <m@maandree.se>

1 files changed, 44 insertions, 0 deletions

diff --git a/libcharconv.h b/libcharconv.h
index b1d6599..f8d15c1 100644
--- a/libcharconv.h
+++ b/libcharconv.h
@@ -1202,4 +1202,48 @@ enum libcharconv_result libcharconv_domino_tiles_vertical(const char *s, size_t
 enum libcharconv_result libcharconv_clock_faces(const char *s, size_t slen, size_t *n, uint_least32_t *cp, size_t *ncp);
 
 
+/**
+ * Convert
+ * 'S' and 's' to OCR HOOK,
+ * 'd' and 'h' to OCR CHAIR,
+ * 'Y' to OCR FORK,
+ * 'A' to OCR INVERTED FORK,
+ * 'I' to OCR BELT BUCKLE,
+ * 'X' and 'x' to OCR BOW TIE,
+ * '\' to OCR DOUBLE BACKSLASH,
+ * 'C' and 'c' to OCR BRANCH BANK IDENTIFICATION,
+ * '/' to OCR AMOUNT OF CHECK,
+ * 'P' and 'p' to OCR DASH,
+ * '_' to OCR CUSTOMER ACCOUNT NUMBER, and
+ * 'E' to HELLSCHREIBER PAUSE SYMBOL
+ * 
+ * @param   s     Text to convert
+ * @param   slen  The number of bytes available in `s`
+ * @param   n     Output parameter for the number of consumed bytes
+ * @param   cp    Output buffer for the codepoints
+ * @param   ncp   Input parameter for the number of codepoints that
+ *                fit in `cp`, and output parameter for the number
+ *                of output codepoints (if it exceeds the original
+ *                value of `ncp`, a larger buffer is needed)
+ * @return        LIBCHARCONV_NO_CONVERT:
+ *                  `*n` is the number of bytes from the beginning
+ *                  of `s` that cannot be converted
+ *                LIBCHARCONV_CONVERTED:
+ *                  `*n` is the number of bytes from the beginning
+ *                  of `s` that was converted to a codepoint which
+ *                  is stored in `*cp`
+ *                LIBCHARCONV_INDETERMINATE:
+ *                  If all text has been input, no more can be
+ *                  converted, otherwise more of the text most
+ *                  be made available before the function can
+ *                  determine whether the beginning of `s` can be
+ *                  converted or what it should be converted to
+ *                LIBCHARCONV_CONVERT_IF_END:
+ *                  As LIBCHARCONV_CONVERTED the entire text has
+ *                  been input, as LIBCHARCONV_INDETERMINATE
+ *                  otherwise
+ */
+enum libcharconv_result libcharconv_ocr(const char *s, size_t slen, size_t *n, uint_least32_t *cp, size_t *ncp);
+
+
 #endif