kc3-lang/libxkbcommon/src/compose/escape.h

• Show log

  Commit

• Hash : 652b03cc
  Author :
  Date : 2024-09-01T08:32:21
  

  compose: Add Compose table dump internal API
  
  - Move `print_compose_table_entry` to own file and add a `file`
    argument to select output.
  - Add `xkb_compose_table_dump` to dump a Compose table.
  
  This change is needed in order to share the feature “dump a Compose
  table” between tests and tools.
  

Download

• src/compose/escape.h

• /*
   * Copyright © 2023 Pierre Le Marre <dev@wismill.eu>
   *
   * 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 (including the next
   * paragraph) 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 COMPOSE_ESCAPE_H
  #define COMPOSE_ESCAPE_H
  
  #include "config.h"
  
  #include <stdlib.h>
  
  #include "src/utils.h"
  
  /* Ad-hoc escaping for UTF-8 string
   *
   * Note that it only escapes the strict minimum to get a valid Compose file.
   * It also escapes hexadecimal digits after an hexadecimal escape. This is not
   * strictly needed by the current implementation: "\x0abcg" parses as "␊bcg",
   * but better be cautious than sorry and produce "\x0a\x62\x63g" instead.
   * In the latter string there is no ambiguity and no need to know the maximum
   * number of digits supported by the escape sequence.
   */
  static inline char*
  escape_utf8_string_literal(const char *from)
  {
      const size_t length = strlen(from);
      /* Longest escape is converting ASCII character to "\xNN" */
      char* to = calloc(4 * length + 1, sizeof(*to));
      if (!to)
          return NULL;
  
      size_t t = 0;
      bool previous_is_hex_escape = false;
      uint8_t nbytes = 0;
      for (size_t f = 0; f < length;) {
          if ((unsigned char) from[f] < 0x80) {
              /* ASCII */
              if (from[f] <= 0x10 || from[f] == 0x7f ||
                  (is_xdigit(from[f]) && previous_is_hex_escape))
              {
                  /* Control character or
                     hexadecimal digit following an hexadecimal escape */
                  snprintf_safe(&to[t], 5, "\\x%02x", from[f]);
                  t += 4;
                  previous_is_hex_escape = true;
              } else if (from[f] == '"' || from[f] == '\\') {
                  /* Quote and backslash */
                  snprintf_safe(&to[t], 3, "\\%c", from[f]);
                  t += 2;
                  previous_is_hex_escape = false;
              } else {
                  /* Other characters */
                  to[t++] = from[f];
                  previous_is_hex_escape = false;
              }
              f++;
              continue;
          }
          /* Test next byte for the next Unicode codepoint’s bytes count */
          else if ((unsigned char) from[f] < 0xe0)
              nbytes = 2;
          else if ((unsigned char) from[f] < 0xf0)
              nbytes = 3;
          else
              nbytes = 4;
          memcpy(&to[t], &from[f], nbytes);
          t += nbytes;
          f += nbytes;
          previous_is_hex_escape = false;
      }
      to[t++] = '\0';
      return realloc(to, t);
  }
  
  #endif
  

Download