mbtable.c File Reference

Type representing a multibyte character table. More...

#include "config.h"
#include <stdint.h>
#include <string.h>
#include <wchar.h>
#include "mutt/lib.h"
#include "mbtable.h"
#include "set.h"
#include "types.h"

Include dependency graph for mbtable.c:

Go to the source code of this file.

Functions
struct MbTable *	mbtable_parse (const char *s)
	Parse a multibyte string into a table. More...
static void	mbtable_destroy (const struct ConfigSet *cs, void *var, const struct ConfigDef *cdef)
	Destroy an MbTable object - Implements ConfigSetType::destroy() -. More...
static int	mbtable_string_set (const struct ConfigSet *cs, void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
	Set an MbTable by string - Implements ConfigSetType::string_set() -. More...
static int	mbtable_string_get (const struct ConfigSet *cs, void *var, const struct ConfigDef *cdef, struct Buffer *result)
	Get a MbTable as a string - Implements ConfigSetType::string_get() -. More...
static struct MbTable *	mbtable_dup (struct MbTable *table)
	Create a copy of an MbTable object. More...
static int	mbtable_native_set (const struct ConfigSet *cs, void *var, const struct ConfigDef *cdef, intptr_t value, struct Buffer *err)
	Set an MbTable config item by MbTable object - Implements ConfigSetType::native_set() -. More...
static intptr_t	mbtable_native_get (const struct ConfigSet *cs, void *var, const struct ConfigDef *cdef, struct Buffer *err)
	Get an MbTable object from a MbTable config item - Implements ConfigSetType::native_get() -. More...
static int	mbtable_reset (const struct ConfigSet *cs, void *var, const struct ConfigDef *cdef, struct Buffer *err)
	Reset an MbTable to its initial value - Implements ConfigSetType::reset() -. More...
void	mbtable_free (struct MbTable **table)
	Free an MbTable object. More...

Variables
const struct ConfigSetType	cst_mbtable
	Config type representing a multi-byte table. More...

Detailed Description

Type representing a multibyte character table.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program 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 General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file mbtable.c.

Function Documentation

mbtable_parse()

struct MbTable* mbtable_parse

(

const char *

s

)

Parse a multibyte string into a table.

Parameters

s	String of multibyte characters

Return values

ptr	New MbTable object

Definition at line 49 of file mbtable.c.

{
  struct MbTable *t = NULL;
  size_t slen, k;
  mbstate_t mbstate;
  char *d = NULL;

  slen = mutt_str_len(s);
  if (!slen)
    return NULL;

  t = mutt_mem_calloc(1, sizeof(struct MbTable));

  t->orig_str = mutt_str_dup(s);
  /* This could be more space efficient.  However, being used on tiny
   * strings (`$to_chars` and `$status_chars`), the overhead is not great. */
  t->chars = mutt_mem_calloc(slen, sizeof(char *));
  t->segmented_str = mutt_mem_calloc(slen * 2, sizeof(char));
  d = t->segmented_str;

  memset(&mbstate, 0, sizeof(mbstate));
  while (slen && (k = mbrtowc(NULL, s, slen, &mbstate)))
  {
    if ((k == (size_t) (-1)) || (k == (size_t) (-2)))
    {
      /* XXX put message in err buffer; fail? warning? */
      mutt_debug(LL_DEBUG1, "mbrtowc returned %d converting %s in %s\n",
                 (k == (size_t) (-1)) ? -1 : -2, s, t->orig_str);
      if (k == (size_t) (-1))
        memset(&mbstate, 0, sizeof(mbstate));
      k = (k == (size_t) (-1)) ? 1 : slen;
    }

    slen -= k;
    t->chars[t->len++] = d;
    while (k--)
      *d++ = *s++;
    *d++ = '\0';
  }

  return t;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbtable_dup()

static struct MbTable* mbtable_dup ( struct MbTable *  table )

static

Create a copy of an MbTable object.

Parameters

table

MbTable to duplicate

Return values

ptr	New MbTable object

Definition at line 185 of file mbtable.c.

{
  if (!table)
    return NULL; /* LCOV_EXCL_LINE */

  struct MbTable *m = mutt_mem_calloc(1, sizeof(*m));
  m->orig_str = mutt_str_dup(table->orig_str);
  return m;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbtable_free()

void mbtable_free

(

struct MbTable **

table

)

Free an MbTable object.

Parameters

[out]

table

MbTable to free

Definition at line 281 of file mbtable.c.

{
  if (!table || !*table)
    return;

  FREE(&(*table)->orig_str);
  FREE(&(*table)->chars);
  FREE(&(*table)->segmented_str);
  FREE(table);
}

Here is the caller graph for this function:

Variable Documentation

cst_mbtable

const struct ConfigSetType cst_mbtable

Initial value:

= {
  DT_MBTABLE,
  "mbtable",
  mbtable_string_set,
  mbtable_string_get,
  mbtable_native_set,
  mbtable_native_get,
  NULL, 
  NULL, 
  mbtable_reset,
  mbtable_destroy,
}

Config type representing a multi-byte table.

Definition at line 295 of file mbtable.c.