input.h File Reference

Functions for reading a character of input from stdin, using the inputrc information for key bindings. More...

#include <wchar.h>
#include "input_common.h"

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

Go to the source code of this file.

Enumerations
enum	{   R_BEGINNING_OF_LINE = R_NULL+10, R_END_OF_LINE, R_FORWARD_CHAR, R_BACKWARD_CHAR,   R_FORWARD_WORD, R_BACKWARD_WORD, R_HISTORY_SEARCH_BACKWARD, R_HISTORY_SEARCH_FORWARD,   R_DELETE_CHAR, R_BACKWARD_DELETE_CHAR, R_KILL_LINE, R_YANK,   R_YANK_POP, R_COMPLETE, R_BEGINNING_OF_HISTORY, R_END_OF_HISTORY,   R_BACKWARD_KILL_LINE, R_KILL_WHOLE_LINE, R_KILL_WORD, R_BACKWARD_KILL_WORD,   R_DUMP_FUNCTIONS, R_HISTORY_TOKEN_SEARCH_BACKWARD, R_HISTORY_TOKEN_SEARCH_FORWARD, R_SELF_INSERT,   R_VI_ARG_DIGIT, R_VI_DELETE_TO, R_EXECUTE, R_BEGINNING_OF_BUFFER,   R_END_OF_BUFFER, R_REPAINT, R_UP_LINE, R_DOWN_LINE }
	Key codes for inputrc-style keyboard functions that are passed on to the caller of input_read().
Functions
int	input_init ()
	Initialize the terminal by calling setupterm, and set up arrays used by readch to detect escape sequences for special keys.
void	input_destroy ()
	free up memory used by terminal functions.
wint_t	input_readch ()
	Read a character from fd 0.
void	input_unreadch (wint_t ch)
	Push a character or a readline function onto the stack of unread characters that input_readch will return before actually reading from fd 0.
void	input_mapping_add (const wchar_t *sequence, const wchar_t *cmd)
	Add a key mapping from the specified sequence.
void	input_mapping_get_names (array_list_t *list)
int	input_mapping_erase (const wchar_t *sequence)
const wchar_t *	input_mapping_get (const wchar_t *sequence)
const wchar_t *	input_terminfo_get_sequence (const wchar_t *name)
	Return the sequence for the terminfo variable of the specified name.
const wchar_t *	input_terminfo_get_name (const wchar_t *seq)
	Return the name of the terminfo variable with the specified sequence.
void	input_terminfo_get_names (array_list_t *lst, int skip_null)
	Return a list of all known terminfo names.
wchar_t	input_function_get_code (const wchar_t *name)
	Returns the input function code for the given input function name.
void	input_function_get_names (array_list_t *lst)
	Returns a list of all existing input function names.

---

Detailed Description

Functions for reading a character of input from stdin, using the inputrc information for key bindings.

---

Function Documentation

int input_init (   )

Initialize the terminal by calling setupterm, and set up arrays used by readch to detect escape sequences for special keys. Before calling input_init, terminfo is not initialized and MUST not be used

void input_mapping_add (  const wchar_t *  sequence, const wchar_t *  cmd )

Add a key mapping from the specified sequence. Parameters: mode  the name of the mapping mode to add this mapping to s  the sequence d  a description of the sequence cmd  an input function that will be run whenever the key sequence occurs

wint_t input_readch (   )

Read a character from fd 0. Try to convert some escape sequences into character constants, but do not permanently block the escape character. This is performed in the same way vim does it, i.e. if an escape character is read, wait for more input for a short time (a few milliseconds). If more input is avaialable, it is assumed to be an escape sequence for a special character (such as an arrow key), and readch attempts to parse it. If no more input follows after the escape key, it is assumed to be an actual escape key press, and is returned as such.

const wchar_t* input_terminfo_get_sequence (  const wchar_t *  name  )

Return the sequence for the terminfo variable of the specified name. If no terminfo variable of the specified name could be found, return 0 and set errno to ENOENT. If the terminfo variable does not have a value, return 0 and set errno to EILSEQ.

---