mbtable.h File Reference

Type representing a multibyte character table. More...

#include <stdbool.h>

Include dependency graph for mbtable.h:

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
bool	mbtable_equal (const struct MbTable *a, const struct MbTable *b)
	Compare two MbTables.
void	mbtable_free (struct MbTable **ptr)
	Free an MbTable object.
const char *	mbtable_get_nth_wchar (const struct MbTable *table, int index)
	Extract one char from a multi-byte table.
struct MbTable *	mbtable_parse (const char *str)
	Parse a multibyte string into a table.

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_equal()

bool mbtable_equal	(	const struct MbTable *	a,
		const struct MbTable *	b )

Compare two MbTables.

Parameters

a	First MbTable
b	Second MbTable

Return values

true	They are identical

Definition at line 51 of file mbtable.c.

{
  if (!a && !b) /* both empty */
    return true;
  if (!a ^ !b) /* one is empty, but not the other */
    return false;
 
  return mutt_str_equal(a->orig_str, b->orig_str);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbtable_free()

void mbtable_free

(

struct MbTable **

ptr

)

Free an MbTable object.

Parameters

[out]

ptr

MbTable to free

Definition at line 318 of file mbtable.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct MbTable *table = *ptr;
  FREE(&table->orig_str);
  FREE(&table->chars);
  FREE(&table->segmented_str);
 
  FREE(ptr);
}

Here is the caller graph for this function:

mbtable_get_nth_wchar()

const char * mbtable_get_nth_wchar	(	const struct MbTable *	table,
		int	index )

Extract one char from a multi-byte table.

Parameters

table	Multi-byte table
index	Select this character

Return values

ptr	String pointer to the character

Extract one multi-byte character from a string table. If the index is invalid, then a space character will be returned. If the character selected is '
' (Ctrl-M), then "" will be returned.

Definition at line 341 of file mbtable.c.

{
  if (!table || !table->chars || (index < 0) || (index >= table->len))
    return " ";
 
  if (table->chars[index][0] == '\r')
    return "";
 
  return table->chars[index];
}

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 66 of file mbtable.c.

{
  struct MbTable *t = NULL;
  size_t slen;
  size_t k;
  mbstate_t mbstate = { 0 };
  char *d = NULL;
 
  slen = mutt_str_len(s);
  if (!slen)
    return NULL;
 
  t = MUTT_MEM_CALLOC(1, 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, char *);
  t->segmented_str = MUTT_MEM_CALLOC(slen * 2, char);
  d = t->segmented_str;
 
  while (slen && (k = mbrtowc(NULL, s, slen, &mbstate)))
  {
    if ((k == ICONV_ILLEGAL_SEQ) || (k == ICONV_BUF_TOO_SMALL))
    {
      /* XXX put message in err buffer; fail? warning? */
      mutt_debug(LL_DEBUG1, "mbrtowc returned %zd converting %s in %s\n", k, s, t->orig_str);
      if (k == ICONV_ILLEGAL_SEQ)
        memset(&mbstate, 0, sizeof(mbstate));
      k = (k == ICONV_ILLEGAL_SEQ) ? 1 : slen;
    }
 
    slen -= k;
    t->chars[t->len++] = d;
    while (k-- > 0)
      *d++ = *s++;
    *d++ = '\0';
  }
 
  return t;
}

Here is the call graph for this function:

Here is the caller graph for this function: