mutt_commands.h File Reference

Definitions of NeoMutt commands. More...

#include "config.h"
#include <stddef.h>
#include "mutt/lib.h"

Include dependency graph for mutt_commands.h:

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

Go to the source code of this file.

Macros
#define	MUTT_NAMED   (1 << 0)
#define	COMMANDS_REGISTER(cmds)   commands_register(cmds, mutt_array_size(cmds))

Enumerations
enum	MuttSetCommand { MUTT_SET_SET , MUTT_SET_INV , MUTT_SET_UNSET , MUTT_SET_RESET }
	Flags for parse_set() More...

Functions
void	mutt_commands_init (void)
	Initialize commands array and register default commands. More...
void	commands_register (const struct Command *cmds, const size_t num_cmds)
	Add commands to Commands array. More...
void	mutt_commands_free (void)
	Free Commands array. More...
size_t	mutt_commands_array (struct Command **first)
	Get Commands array. More...
struct Command *	mutt_command_get (const char *s)
	Get a Command by its name. More...
void	mutt_commands_apply (void *data, void(*application)(void *, const struct Command *))
	Run a callback function on every Command. More...

Detailed Description

Definitions of NeoMutt commands.

Authors

• Bernard Pratz

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

Macro Definition Documentation

MUTT_NAMED

#define MUTT_NAMED   (1 << 0)

Definition at line 44 of file mutt_commands.h.

COMMANDS_REGISTER

#define COMMANDS_REGISTER

(

cmds

)

commands_register(cmds, mutt_array_size(cmds))

Definition at line 47 of file mutt_commands.h.

Enumeration Type Documentation

MuttSetCommand

enum MuttSetCommand

Flags for parse_set()

Enumerator
MUTT_SET_SET	default is to set all vars
MUTT_SET_INV	default is to invert all vars
MUTT_SET_UNSET	default is to unset all vars
MUTT_SET_RESET	default is to reset all vars to default

Definition at line 35 of file mutt_commands.h.

{
  MUTT_SET_SET,   
  MUTT_SET_INV,   
  MUTT_SET_UNSET, 
  MUTT_SET_RESET, 
};

Function Documentation

mutt_commands_init()

void mutt_commands_init

(

void

)

Initialize commands array and register default commands.

Definition at line 137 of file mutt_commands.c.

{
  ARRAY_RESERVE(&commands, 100);
  COMMANDS_REGISTER(mutt_commands);
}

Here is the caller graph for this function:

commands_register()

void commands_register	(	const struct Command *	cmds,
		const size_t	num_cmds
	)

Add commands to Commands array.

Parameters

cmds	Array of Commands
num_cmds	Number of Commands in the Array

Definition at line 159 of file mutt_commands.c.

{
  for (int i = 0; i < num_cmds; i++)
  {
    ARRAY_ADD(&commands, cmds[i]);
  }
  ARRAY_SORT(&commands, commands_cmp);
}

Here is the call graph for this function:

mutt_commands_free()

void mutt_commands_free

(

void

)

Free Commands array.

Definition at line 171 of file mutt_commands.c.

{
  ARRAY_FREE(&commands);
}

Here is the caller graph for this function:

mutt_commands_array()

size_t mutt_commands_array

(

struct Command **

first

)

Get Commands array.

Parameters

first

Set to first element of Commands array

Return values

num	Size of Commands array

Definition at line 181 of file mutt_commands.c.

{
  *first = ARRAY_FIRST(&commands);
  return ARRAY_SIZE(&commands);
}

Here is the caller graph for this function:

mutt_command_get()

struct Command * mutt_command_get

(

const char *

s

)

Get a Command by its name.

Parameters

s	Command string to lookup

Return values

ptr	Success, Command
NULL	Error, no such command

Definition at line 193 of file mutt_commands.c.

{
  struct Command *cmd = NULL;
  ARRAY_FOREACH(cmd, &commands)
  {
    if (mutt_str_equal(s, cmd->name))
      return cmd;
  }
  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_commands_apply()

void mutt_commands_apply	(	void *	data,
		void(*)(void *, const struct Command *)	application
	)

Run a callback function on every Command.

Parameters

data	Data to pass to the callback function
application	Callback function

This is used by Lua to expose all of NeoMutt's Commands.

Definition at line 212 of file mutt_commands.c.

{
  struct Command *cmd = NULL;
  ARRAY_FOREACH(cmd, &commands)
  {
    application(data, cmd);
  }
}

Here is the caller graph for this function: