New upstream version 18.0.1+dfsg1

deps/libcaption/caption/utf8.h

@@ -0,0 +1,97 @@
+/**********************************************************************************************/
+/* The MIT License                                                                            */
+/*                                                                                            */
+/* Copyright 2016-2016 Twitch Interactive, Inc. or its affiliates. All Rights Reserved.       */
+/*                                                                                            */
+/* Permission is hereby granted, free of charge, to any person obtaining a copy               */
+/* of this software and associated documentation files (the "Software"), to deal              */
+/* in the Software without restriction, including without limitation the rights               */
+/* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell                  */
+/* copies of the Software, and to permit persons to whom the Software is                      */
+/* furnished to do so, subject to the following conditions:                                   */
+/*                                                                                            */
+/* The above copyright notice and this permission notice shall be included in                 */
+/* all copies or substantial portions of the Software.                                        */
+/*                                                                                            */
+/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR                 */
+/* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,                   */
+/* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE                */
+/* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER                     */
+/* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,              */
+/* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN                  */
+/* THE SOFTWARE.                                                                              */
+/**********************************************************************************************/
+#ifndef LIBCAPTION_UTF8_H
+#define LIBCAPTION_UTF8_H
+
+#include <stddef.h>
+#include <inttypes.h>
+
+// These types exist to make the code more self dcoumenting
+// utf8_char_t point is a null teminate string of utf8 encodecd chars
+//
+// utf8_size_t is the length of a string in chars
+// size_t is bytes
+typedef char utf8_char_t;
+typedef size_t utf8_size_t;
+/*! \brief
+    \param
+
+    Skiped continuation bytes
+*/
+const utf8_char_t* utf8_char_next (const char* s);
+/*! \brief
+    \param
+
+    returnes the length of the char in bytes
+*/
+size_t utf8_char_length (const utf8_char_t* c);
+
+/*! \brief
+    \param
+
+    returns length of the string in bytes
+    size is number of charcter to count (0 to count until NULL term)
+*/
+size_t utf8_string_length (const utf8_char_t* data, utf8_size_t size);
+/*! \brief
+    \param
+*/
+size_t utf8_char_copy (utf8_char_t* dst, const utf8_char_t* src);
+
+/*! \brief
+    \param
+
+    returnes the number of utf8 charcters in a string givne the numbe of bytes
+    to coutn until the a null terminator, pass 0 for size
+*/
+utf8_size_t utf8_char_count (const char* data, size_t size);
+/*! \brief
+    \param
+
+    returnes the length of the line in bytes triming not printable charcters at the end
+*/
+size_t utf8_trimmed_length (const char* data, size_t size);
+/*! \brief
+    \param
+
+    returns the length in bytes of the line including the new line charcter(s)
+    auto detects between windows(CRLF), unix(LF), mac(CR) and riscos (LFCR) line endings
+*/
+size_t utf8_line_length (const char* data);
+/*! \brief
+    \param
+
+    returns number of chars to include before split
+*/
+utf8_size_t utf8_wrap_length (const utf8_char_t* data, utf8_size_t size);
+
+/*! \brief
+    \param
+
+    returns number of new lins in teh string
+*/
+int utf8_line_count (const utf8_char_t* data);
+
+
+#endif