tag.h File Reference

Notmuch tag functions. More...

#include "mutt/lib.h"

Include dependency graph for tag.h:

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

Go to the source code of this file.

Data Structures
struct	NmTags
	Array of Notmuch tags. More...

Functions
	ARRAY_HEAD (TagArray, char *)
void	nm_tag_array_free (struct NmTags *tags)
	Free all memory of a NmTags.
struct NmTags	nm_tag_str_to_tags (const char *tag_string)
	Converts a comma and/or space-delimited string of tags into an array.

Detailed Description

Notmuch tag functions.

Authors

• Austin Ray
• 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 tag.h.

Function Documentation

ARRAY_HEAD()

ARRAY_HEAD	(	TagArray	,
		char *
	)

nm_tag_array_free()

void nm_tag_array_free

(

struct NmTags *

tags

)

Free all memory of a NmTags.

Parameters

tags	NmTags being cleaned up

Definition at line 39 of file tag.c.

{
  ARRAY_FREE(&tags->tags);
  FREE(&tags->tag_str);
}

Here is the caller graph for this function:

nm_tag_str_to_tags()

struct NmTags nm_tag_str_to_tags

(

const char *

tag_str

)

Converts a comma and/or space-delimited string of tags into an array.

Parameters

tag_str

String containing a list of tags, comma- and/or space-delimited

Return values

obj	Array containing tags represented as strings

Definition at line 50 of file tag.c.

{
  char *buf = mutt_str_dup(tag_str);
 
  struct NmTags tags = { ARRAY_HEAD_INITIALIZER, buf };
 
  char *end = NULL;
  char *tag = NULL;
 
  for (char *p = buf; p && (p[0] != '\0'); p++)
  {
    if (!tag && mutt_isspace(*p))
      continue;
    if (!tag)
      tag = p; /* begin of the tag */
    if ((p[0] == ',') || (p[0] == ' '))
      end = p; /* terminate the tag */
    else if (p[1] == '\0')
      end = p + 1; /* end of optstr */
    if (!tag || !end)
      continue;
    if (tag >= end)
      break;
    *end = '\0';
 
    ARRAY_ADD(&tags.tags, tag);
 
    end = NULL;
    tag = NULL;
  }
 
  return tags;
}

Here is the call graph for this function:

Here is the caller graph for this function: