xref: /dports/net-im/telegram-desktop/tdesktop-3.2.5-full/Telegram/ThirdParty/nimf/libnimf/nimf-types.c

/* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 2; tab-width: 2 -*- */
/*
 * nimf-types.c
 * This file is part of Nimf.
 *
 * Copyright (C) 2015-2019 Hodong Kim <cogniti@gmail.com>
 *
 * Nimf is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published
 * by the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Nimf is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program;  If not, see <http://www.gnu.org/licenses/>.
 */

#include "nimf-types.h"
#include "nimf-enum-types-private.h"

/**
 * SECTION:nimf-types
 * @title: Types
 * @section_id: nimf-types
 */

/**
 * nimf_key_new:
 *
 * Creates a new #NimfKey. All fields are set to 0.
 *
 * Return: a new #NimfKey, which should be freed with nimf_key_free().
 */
NimfKey *
nimf_key_new ()
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  return g_slice_new0 (NimfKey);
}

/**
 * nimf_key_new_from_nicks:
 * @nicks: an array of gchar
 *
 * Return: a new #NimfKey, which should be freed with nimf_key_free().
 */
NimfKey *
nimf_key_new_from_nicks (const gchar **nicks)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  NimfKey     *key = g_slice_new0 (NimfKey);
  GEnumValue  *enum_value;  /* Do not free */
  GFlagsValue *flags_value; /* Do not free */
  GFlagsClass *flags_class = g_type_class_ref (NIMF_TYPE_MODIFIER_TYPE);
  GEnumClass  *enum_class  = g_type_class_ref (NIMF_TYPE_KEY_SYM);

  gint i;
  for (i = 0; nicks[i] != NULL; i++)
  {
    if (g_str_has_prefix (nicks[i], "<"))
    {
      flags_value = g_flags_get_value_by_nick (flags_class, nicks[i]);

      if (flags_value)
        key->state |= flags_value->value;
      else
        g_warning ("NimfModifierType doesn't have a member with that nickname: %s", nicks[i]);
    }
    else
    {
      enum_value = g_enum_get_value_by_nick (enum_class, nicks[i]);

      if (enum_value)
        key->keyval = enum_value->value;
      else
        g_warning ("NimfKeySym doesn't have a member with that nickname: %s", nicks[i]);
    }
  }

  g_type_class_unref (flags_class);
  g_type_class_unref (enum_class);

  return key;
}

/**
 * nimf_key_newv:
 * @keys: an array of gchar
 *
 * Creates a new array of #NimfKey.
 *
 * Returns: a new array of #NimfKey, which should be freed with
 *   nimf_key_freev().
 */
NimfKey **
nimf_key_newv (const gchar **keys)
{
  NimfKey **nimf_keys = g_malloc0_n (1, sizeof (NimfKey *));

  gint i;
  for (i = 0; keys[i] != NULL; i++)
  {
    gchar **nicks = g_strsplit (keys[i], " ", -1);
    NimfKey *key = nimf_key_new_from_nicks ((const gchar **) nicks);
    g_strfreev (nicks);

    nimf_keys = g_realloc_n (nimf_keys, sizeof (NimfKey *), i + 2);
    nimf_keys[i] = key;
    nimf_keys[i + 1] = NULL;
  }

  return nimf_keys;
}

/**
 * nimf_key_freev:
 * @keys: an array of #NimfKey
 *
 * Frees an array of @keys
 */
void
nimf_key_freev (NimfKey **keys)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  if (keys)
  {
    int i;
    for (i = 0; keys[i] != NULL; i++)
      nimf_key_free (keys[i]);

    g_free (keys);
  }
}

/**
 * nimf_key_free:
 * @key: a #NimfKey
 *
 * Frees a @key
 */
void
nimf_key_free (NimfKey *key)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  g_return_if_fail (key != NULL);

  g_slice_free (NimfKey, key);
}

/**
 * nimf_preedit_attr_new:
 * @type: a #NimfPreeditAttrType
 * @start_index: start index in characters
 * @end_index: end index in characters; The character at this index is not
 *   included.
 *
 * Returns: a new #NimfPreeditAttr, which should be freed with
 *   nimf_preedit_attr_free().
 */
NimfPreeditAttr *
nimf_preedit_attr_new (NimfPreeditAttrType type,
                       guint               start_index,
                       guint               end_index)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  NimfPreeditAttr *attr;

  attr = g_new (NimfPreeditAttr, 1);
  attr->type        = type;
  attr->start_index = start_index;
  attr->end_index   = end_index;

  return attr;
}

/**
 * nimf_preedit_attrs_copy:
 * @attrs: an array of #NimfPreeditAttr
 *
 * Returns: a new array of #NimfPreeditAttr, which should be freed with
 *   nimf_preedit_attr_freev().
 */
NimfPreeditAttr **
nimf_preedit_attrs_copy (NimfPreeditAttr **attrs)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  NimfPreeditAttr **preedit_attrs;
  gint              i;

  g_return_val_if_fail (attrs, NULL);

  preedit_attrs = g_malloc0_n (1, sizeof (NimfPreeditAttr *));

  for (i = 0; attrs[i] != NULL; i++)
  {
    preedit_attrs = g_realloc_n (preedit_attrs, 1 + i + 1, sizeof (NimfPreeditAttr *));
    preedit_attrs[i] = g_memdup (attrs[i], sizeof (NimfPreeditAttr));
    preedit_attrs[i + 1] = NULL;
  }

  return preedit_attrs;
}

/**
 * nimf_preedit_attr_free:
 * @attr: a #NimfPreeditAttr
 *
 * Frees a @attr
 */
void
nimf_preedit_attr_free (NimfPreeditAttr *attr)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  g_free (attr);
}

/**
 * nimf_preedit_attr_freev:
 * @attrs: an array of #NimfPreeditAttr
 *
 * Frees an array of @attrs
 */
void
nimf_preedit_attr_freev (NimfPreeditAttr **attrs)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  if (attrs)
  {
    int i;
    for (i = 0; attrs[i] != NULL; i++)
      nimf_preedit_attr_free (attrs[i]);

    g_free (attrs);
  }
}

/**
 * nimf_method_info_new:
 *
 * Returns: a new #NimfMethodInfo, which should be freed with
 *   nimf_method_info_free().
 */
NimfMethodInfo *
nimf_method_info_new ()
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  return g_slice_new0 (NimfMethodInfo);
}

/**
 * nimf_method_info_free:
 * @info: a #NimfMethodInfo
 *
 * Frees an @info.
 */
void
nimf_method_info_free (NimfMethodInfo *info)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  if (info)
    g_slice_free (NimfMethodInfo, info);
}

/**
 * nimf_method_info_freev:
 * @infos: an array of #NimfMethodInfo
 *
 * Frees an array of @infos.
 */
void
nimf_method_info_freev (NimfMethodInfo **infos)
{
  g_debug (G_STRLOC ": %s", G_STRFUNC);

  if (infos)
  {
    int i;
    for (i = 0; infos[i]; i++)
      nimf_method_info_free (infos[i]);

    g_free (infos);
  }
}