(history.info.gz) History Expansion
Info Catalog
(history.info.gz) Managing the History File
(history.info.gz) History Functions
2.3.7 History Expansion
-----------------------
These functions implement history expansion.
-- Function: int history_expand (char *string, char **output)
Expand STRING, placing the result into OUTPUT, a pointer to a
string ( History Interaction). Returns:
`0'
If no expansions took place (or, if the only change in the
text was the removal of escape characters preceding the
history expansion character);
`1'
if expansions did take place;
`-1'
if there was an error in expansion;
`2'
if the returned line should be displayed, but not executed,
as with the `:p' modifier ( Modifiers).
If an error ocurred in expansion, then OUTPUT contains a
descriptive error message.
-- Function: char * get_history_event (const char *string, int
*cindex, int qchar)
Returns the text of the history event beginning at STRING +
*CINDEX. *CINDEX is modified to point to after the event
specifier. At function entry, CINDEX points to the index into
STRING where the history event specification begins. QCHAR is a
character that is allowed to end the event specification in
addition to the "normal" terminating characters.
-- Function: char ** history_tokenize (const char *string)
Return an array of tokens parsed out of STRING, much as the shell
might. The tokens are split on the characters in the
HISTORY_WORD_DELIMITERS variable, and shell quoting conventions
are obeyed.
-- Function: char * history_arg_extract (int first, int last, const
char *string)
Extract a string segment consisting of the FIRST through LAST
arguments present in STRING. Arguments are split using
`history_tokenize'.
Info Catalog
(history.info.gz) Managing the History File
(history.info.gz) History Functions
automatically generated byinfo2html