NeoMutt  2019-11-11
Teaching an old dog new tricks
DOXYGEN
state.h File Reference

Keep track when processing files. More...

#include <stdint.h>
#include <stdio.h>
#include <wchar.h>
+ Include dependency graph for state.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  State
 Keep track when processing files. More...
 

Macros

#define MUTT_STATE_NO_FLAGS   0
 No flags are set. More...
 
#define MUTT_DISPLAY   (1 << 0)
 Output is displayed to the user. More...
 
#define MUTT_VERIFY   (1 << 1)
 Perform signature verification. More...
 
#define MUTT_PENDINGPREFIX   (1 << 2)
 Prefix to write, but character must follow. More...
 
#define MUTT_WEED   (1 << 3)
 Weed headers even when not in display mode. More...
 
#define MUTT_CHARCONV   (1 << 4)
 Do character set conversions. More...
 
#define MUTT_PRINTING   (1 << 5)
 Are we printing? - MUTT_DISPLAY "light". More...
 
#define MUTT_REPLYING   (1 << 6)
 Are we replying? More...
 
#define MUTT_FIRSTDONE   (1 << 7)
 The first attachment has been done. More...
 
#define state_set_prefix(state)   ((state)->flags |= MUTT_PENDINGPREFIX)
 
#define state_reset_prefix(state)   ((state)->flags &= ~MUTT_PENDINGPREFIX)
 
#define state_puts(STATE, STR)   fputs(STR, (STATE)->fp_out)
 
#define state_putc(STATE, STR)   fputc(STR, (STATE)->fp_out)
 

Typedefs

typedef uint8_t StateFlags
 Flags for State->flags, e.g. MUTT_DISPLAY. More...
 

Functions

void state_attach_puts (struct State *s, const char *t)
 Write a string to the state. More...
 
void state_mark_attach (struct State *s)
 Write a unique marker around content. More...
 
void state_mark_protected_header (struct State *s)
 Write a unique marker around protected headers. More...
 
void state_prefix_put (struct State *s, const char *buf, size_t buflen)
 Write a prefixed fixed-string to the State. More...
 
void state_prefix_putc (struct State *s, char c)
 Write a prefixed character to the state. More...
 
int state_printf (struct State *s, const char *fmt,...)
 Write a formatted string to the State. More...
 
int state_putws (struct State *s, const wchar_t *ws)
 Write a wide string to the state. More...
 

Detailed Description

Keep track when processing files.

Authors
  • Richard Russon

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 state.h.

Macro Definition Documentation

◆ MUTT_STATE_NO_FLAGS

#define MUTT_STATE_NO_FLAGS   0

No flags are set.

Definition at line 31 of file state.h.

◆ MUTT_DISPLAY

#define MUTT_DISPLAY   (1 << 0)

Output is displayed to the user.

Definition at line 32 of file state.h.

◆ MUTT_VERIFY

#define MUTT_VERIFY   (1 << 1)

Perform signature verification.

Definition at line 33 of file state.h.

◆ MUTT_PENDINGPREFIX

#define MUTT_PENDINGPREFIX   (1 << 2)

Prefix to write, but character must follow.

Definition at line 34 of file state.h.

◆ MUTT_WEED

#define MUTT_WEED   (1 << 3)

Weed headers even when not in display mode.

Definition at line 35 of file state.h.

◆ MUTT_CHARCONV

#define MUTT_CHARCONV   (1 << 4)

Do character set conversions.

Definition at line 36 of file state.h.

◆ MUTT_PRINTING

#define MUTT_PRINTING   (1 << 5)

Are we printing? - MUTT_DISPLAY "light".

Definition at line 37 of file state.h.

◆ MUTT_REPLYING

#define MUTT_REPLYING   (1 << 6)

Are we replying?

Definition at line 38 of file state.h.

◆ MUTT_FIRSTDONE

#define MUTT_FIRSTDONE   (1 << 7)

The first attachment has been done.

Definition at line 39 of file state.h.

◆ state_set_prefix

#define state_set_prefix (   state)    ((state)->flags |= MUTT_PENDINGPREFIX)

Definition at line 53 of file state.h.

◆ state_reset_prefix

#define state_reset_prefix (   state)    ((state)->flags &= ~MUTT_PENDINGPREFIX)

Definition at line 54 of file state.h.

◆ state_puts

#define state_puts (   STATE,
  STR 
)    fputs(STR, (STATE)->fp_out)

Definition at line 55 of file state.h.

◆ state_putc

#define state_putc (   STATE,
  STR 
)    fputc(STR, (STATE)->fp_out)

Definition at line 56 of file state.h.

Typedef Documentation

◆ StateFlags

typedef uint8_t StateFlags

Flags for State->flags, e.g. MUTT_DISPLAY.

Definition at line 30 of file state.h.

Function Documentation

◆ state_attach_puts()

void state_attach_puts ( struct State s,
const char *  t 
)

Write a string to the state.

Parameters
sState to write to
tText to write

Definition at line 70 of file state.c.

71 {
72  if (!s || !s->fp_out || !t)
73  return;
74 
75  if (*t != '\n')
77  while (*t)
78  {
79  state_putc(s, *t);
80  if ((*t++ == '\n') && *t)
81  if (*t != '\n')
83  }
84 }
FILE * fp_out
File to write to.
Definition: state.h:47
void state_mark_attach(struct State *s)
Write a unique marker around content.
Definition: state.c:41
#define state_putc(STATE, STR)
Definition: state.h:56
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ state_mark_attach()

void state_mark_attach ( struct State s)

Write a unique marker around content.

Parameters
sState to write to

Definition at line 41 of file state.c.

42 {
43  if (!s || !s->fp_out)
44  return;
45  if ((s->flags & MUTT_DISPLAY) &&
46  (!C_Pager || (mutt_str_strcmp(C_Pager, "builtin") == 0)))
47  {
49  }
50 }
#define MUTT_DISPLAY
Output is displayed to the user.
Definition: state.h:32
#define state_puts(STATE, STR)
Definition: state.h:55
WHERE char AttachmentMarker[256]
Unique ANSI string to mark PGP messages in an email.
Definition: globals.h:48
FILE * fp_out
File to write to.
Definition: state.h:47
StateFlags flags
Flags, e.g. MUTT_DISPLAY.
Definition: state.h:49
WHERE char * C_Pager
Config: External command for viewing messages, or &#39;builtin&#39; to use NeoMutt&#39;s.
Definition: globals.h:134
int mutt_str_strcmp(const char *a, const char *b)
Compare two strings, safely.
Definition: string.c:615
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ state_mark_protected_header()

void state_mark_protected_header ( struct State s)

Write a unique marker around protected headers.

Parameters
sState to write to

Definition at line 56 of file state.c.

57 {
58  if ((s->flags & MUTT_DISPLAY) &&
59  (!C_Pager || (mutt_str_strcmp(C_Pager, "builtin") == 0)))
60  {
62  }
63 }
#define MUTT_DISPLAY
Output is displayed to the user.
Definition: state.h:32
#define state_puts(STATE, STR)
Definition: state.h:55
StateFlags flags
Flags, e.g. MUTT_DISPLAY.
Definition: state.h:49
WHERE char ProtectedHeaderMarker[256]
Unique ANSI string to mark protected headers in an email.
Definition: globals.h:49
WHERE char * C_Pager
Config: External command for viewing messages, or &#39;builtin&#39; to use NeoMutt&#39;s.
Definition: globals.h:134
int mutt_str_strcmp(const char *a, const char *b)
Compare two strings, safely.
Definition: string.c:615
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ state_prefix_put()

void state_prefix_put ( struct State s,
const char *  buf,
size_t  buflen 
)

Write a prefixed fixed-string to the State.

Parameters
sState to write to
bufString to write
buflenLength of string

Definition at line 171 of file state.c.

172 {
173  if (s->prefix)
174  {
175  while (buflen--)
176  state_prefix_putc(s, *buf++);
177  }
178  else
179  fwrite(buf, buflen, 1, s->fp_out);
180 }
char * prefix
String to add to the beginning of each output line.
Definition: state.h:48
FILE * fp_out
File to write to.
Definition: state.h:47
void state_prefix_putc(struct State *s, char c)
Write a prefixed character to the state.
Definition: state.c:131
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ state_prefix_putc()

void state_prefix_putc ( struct State s,
char  c 
)

Write a prefixed character to the state.

Parameters
sState to write to
cCharacter to write

Definition at line 131 of file state.c.

132 {
133  if (s->flags & MUTT_PENDINGPREFIX)
134  {
136  if (s->prefix)
137  state_puts(s, s->prefix);
138  }
139 
140  state_putc(s, c);
141 
142  if (c == '\n')
143  state_set_prefix(s);
144 }
#define state_puts(STATE, STR)
Definition: state.h:55
#define MUTT_PENDINGPREFIX
Prefix to write, but character must follow.
Definition: state.h:34
char * prefix
String to add to the beginning of each output line.
Definition: state.h:48
#define state_reset_prefix(state)
Definition: state.h:54
StateFlags flags
Flags, e.g. MUTT_DISPLAY.
Definition: state.h:49
#define state_set_prefix(state)
Definition: state.h:53
#define state_putc(STATE, STR)
Definition: state.h:56
+ Here is the caller graph for this function:

◆ state_printf()

int state_printf ( struct State s,
const char *  fmt,
  ... 
)

Write a formatted string to the State.

Parameters
sState to write to
fmtprintf format string
...Arguments to formatting string
Return values
numNumber of characters written

Definition at line 153 of file state.c.

154 {
155  int rc;
156  va_list ap;
157 
158  va_start(ap, fmt);
159  rc = vfprintf(s->fp_out, fmt, ap);
160  va_end(ap);
161 
162  return rc;
163 }
FILE * fp_out
File to write to.
Definition: state.h:47
+ Here is the caller graph for this function:

◆ state_putws()

int state_putws ( struct State s,
const wchar_t *  ws 
)

Write a wide string to the state.

Parameters
sState to write to
wsWide string to write
Return values
0Success
-1Error

Definition at line 113 of file state.c.

114 {
115  const wchar_t *p = ws;
116 
117  while (p && (*p != L'\0'))
118  {
119  if (state_putwc(s, *p) < 0)
120  return -1;
121  p++;
122  }
123  return 0;
124 }
static int state_putwc(struct State *s, wchar_t wc)
Write a wide character to the state.
Definition: state.c:93
+ Here is the call graph for this function:
+ Here is the caller graph for this function: