mbtable.h File Reference

Type representing a multibyte character table. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	MbTable
	Multibyte character table. More...

Functions
void	mbtable_free (struct MbTable **table)
	Free an MbTable object. More...
struct MbTable *	mbtable_parse (const char *str)
	Parse a multibyte string into a 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.h.

Function Documentation

mbtable_free()

void mbtable_free

(

struct MbTable **

table

)

Free an MbTable object.

Parameters

[out]

table

MbTable to free

Definition at line 280 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:

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 = { 0 };
  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;
 
  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: