(fetch-array array indices...)

Retrieves a value from an array. The arguments to this function are the array and the indices of the array. fetch-array checks that there are exactly the right number of indices and range-checks them.

Example: Retrieve element 3,5 from array 2d-array.

(setq value (fetch-array 2d-array 3 5))

See also:

(fetch-database-entry dbname key)

Reads the entry in the database corresponding to the given key and inserts it into the current buffer.

See also:

(fetch-help-database-entry dbname keys-string)

VMS only

Takes the entry in the help database corresponding to the given key string and inserts it into the current buffer.

The key string is a sequence of up to 9 keys separated by whitespace. For example, to insert the help for the entry:

copy /log

the string would be:

"copy /log"

The variable fetch-help-database-flags is used to control the information retrieved from the help database file.

See also:

(file-exists file-name)

Returns 1 if the specified file exists and is writeable, -1 if the file exists but is only readable, and 0 otherwise.

See also:

(file-format-string format file-name)

file-format-string is used to create formatted string based on parts of filenames.

The format string is made of format specifications and literal characters. literal characters are copied to the output as is. Format specifications are replaced with appropriate text.

The format specification syntax is:

% arg fmt-type

The optional arg is a positive or negative decimal number.

The possible values for fmt-type are shown in the following table. The examples in the table are based on a file specification of:

c:\users\barry\bemacs\emacsinit.ml
Type Description Example Output
% literal % character %% %
fn filename %fn emacsinit
ft filetype %ft .ml
fa filename and filetype %fa emacsinit.ml
pc path character %pc \
pa disk and directory %pa c:\users\barry\bemacs\
ps set path split point %4ps%ph c:\users\barry\bemacs\
ph path head %3ps%ph
%2ps%ph
%1ps%ph
%0ps%ph
%-1ps%ph
%-2ps%ph
c:\users\barry\bemacs\
c:\users\barry\
c:\users\
c:\users\barry\bemacs\
c:\users\barry\
c:\users\
pt path tail %-2ps%pt
%3ps%pt
%2ps%pt
%1ps%pt
%0ps%pt
%-1ps%pt
%-2ps%pt
barry\bemacs\
 
bemacs\
barry\bemacs\
 
bemacs\
barry\bemacs\
pv disk %pv c:
pd directory %pd \users\barry\bemacs\

(file-is-a-directory file-name)

Returns 1 if the specified file-name is a directory and 0 otherwise.

Examples:

(file-is-a-directory "/tmp")

(file-is-a-directory "c:\\temp")

See also:

(file-name-expand-and-default file-name default-file-name)

Returns a string containing a file name. The file name returned is the file-name will any missing part of the file name defaulted from the default-file-name parameter and the current working directory.

(filter-region command)

Takes the region and passes it as input to the given operating system command. The output from the command replaces the region. The contets of the region are saved in Kill buffer.

See also:

(following-char)

Returns the character immediately following dot as an integer. The null character (0) is returned if dot is at the end of the buffer.

See also:

(force-exit-process process-name exit-code)

Forces the image running is the specified subprocess to exit with the specified code. This can be used to stop an image that has run amok. All exit handlers for the image will be run.

If no image is running in the process, the exit request will be queued up and executed next time the target process executes in user mode (the next time an image is run).

See also:

(forward-balanced-paren-line expression-1)

Moves dot forward until either the end of the buffer is reached, or an unmatched closing parenthesis is encountered, or the beginning of a line is encountered at parenthesis level zero, that is, without an unmatched parenthesis existing between the line and the starting position of dot.

The parameter is the number of parentheses to ignore before applying the match.

The definition of parenthesis is derived from the syntax table for the current buffer.

See also:

(forward-character repeat-count) ^F or right-arrow

Moves dot forward prefix-argument times repeat-count characters. If repeat-count is omitted, 1 is assumed. End-of-lines and tabs each count as one character. You cannot move past the end of the buffer.

See also:

(forward-paragraph) ESC-)

Moves dot to the end of the current or following paragraph. Blank lines that separate paragraphs and are not considered parts of paragraphs.

Paragraphs are defined by the variable paragraph-delimiters.

See also:

(forward-paren)

Moves dot forward until an unmatched closing parenthesis, or the end of the buffer is found. This can be used to aid in skipping over Lisp S-expressions.

The argument is the number of parentheses to ignore before applying the match.

The definition of parenthesis is derived from the syntax table for the current buffer.

See also:

(forward-sentence) ESC-e

Moves dot forward to the end of a sentence. A sentence is bounded by the string variable sentence-delimiters.

See also:

(forward-word repeat-count) ESC-f

Moves dot forward to the end of the prefix-argument times repeat-count word. If repeat-count is omitted, 1 is assumed. If dot is not currently in the middle of a word, the command skips all intervening punctuation. It then skips over the words, leaving dot positioned after the last character of the word.

A word is defined by the current syntax table.

See also:

(fundamental-mode)

Turns on a major mode similar to Normal Mode. It provides a natural environment for processing ordinary text, or program sources for which there is no specialised language mode. The main advantage of Fundamental Mode over Normal mode is that it displays parenthesis balancing.

See also: