code/slist_8h_source.html

#ifndef MUTT_LIB_SLIST_H

#define MUTT_LIB_SLIST_H


#include <stddef.h>

#include <stdbool.h>

#include <stdint.h>

#include "list.h"


struct Buffer;


#define SLIST_SEP_SPACE (1 << 13)

#define SLIST_SEP_COMMA (1 << 14)

#define SLIST_SEP_COLON (1 << 15)


#define SLIST_SEP_MASK  0xE000


#define SLIST_ALLOW_DUPES    (1 << 17)

#define SLIST_ALLOW_EMPTY    (1 << 18)

#define SLIST_CASE_SENSITIVE (1 << 19)


struct Slist

{

  struct ListHead head;

  size_t count;

  uint32_t flags;

};


struct Slist *slist_add_list(struct Slist *list, const struct Slist *add);

struct Slist *slist_add_string(struct Slist *list, const char *str);

bool          slist_compare(const struct Slist *a, const struct Slist *b);

struct Slist *slist_dup(const struct Slist *list);

struct Slist *slist_empty(struct Slist **list);

void          slist_free(struct Slist **list);

bool          slist_is_member(const struct Slist *list, const char *str);

struct Slist *slist_new(uint32_t flags);

struct Slist *slist_parse(const char *str, uint32_t flags);

struct Slist *slist_remove_string(struct Slist *list, const char *str);

int           slist_to_buffer(const struct Slist *list, struct Buffer *buf);


#endif /* MUTT_LIB_SLIST_H */

list.h
Singly-linked list type.

slist_remove_string
struct Slist * slist_remove_string(struct Slist *list, const char *str)
Remove a string from a list.
Definition: slist.c:258

slist_empty
struct Slist * slist_empty(struct Slist **list)
Empty out an Slist object.
Definition: slist.c:141

slist_parse
struct Slist * slist_parse(const char *str, uint32_t flags)
Parse a list of strings into a list.
Definition: slist.c:200

slist_add_list
struct Slist * slist_add_list(struct Slist *list, const struct Slist *add)
Add a list to another list.
Definition: slist.c:58

slist_compare
bool slist_compare(const struct Slist *a, const struct Slist *b)
Compare two string lists.
Definition: slist.c:103

slist_add_string
struct Slist * slist_add_string(struct Slist *list, const char *str)
Add a string to a list.
Definition: slist.c:80

slist_is_member
bool slist_is_member(const struct Slist *list, const char *str)
Is a string a member of a list?
Definition: slist.c:177

slist_dup
struct Slist * slist_dup(const struct Slist *list)
Create a copy of an Slist object.
Definition: slist.c:120

slist_to_buffer
int slist_to_buffer(const struct Slist *list, struct Buffer *buf)
Export an Slist to a Buffer.
Definition: slist.c:292

slist_new
struct Slist * slist_new(uint32_t flags)
Create a new string list.
Definition: slist.c:43

slist_free
void slist_free(struct Slist **list)
Free an Slist object.
Definition: slist.c:162

Buffer
String manipulation buffer.
Definition: buffer.h:34

Slist
String list.
Definition: slist.h:47

Slist::head
struct ListHead head
List containing values.
Definition: slist.h:48

Slist::count
size_t count
Number of values in list.
Definition: slist.h:49

Slist::flags
uint32_t flags
Flags controlling list, e.g. SLIST_SEP_SPACE.
Definition: slist.h:50