Synopsis
create_line_mark
Usage
User_Mark create_line_mark (Integer c);
Description
The function create_line_mark returns an object of the type
User_Mark . This object contains information regarding the current
position and current buffer. The parameter c is used to specify the
color to use when the line is displayed.
See also
Synopsis
create_user_mark
Usage
User_Mark create_user_mark ();
Description
The function create_user_mark returns an object of the type
User_Mark . This object contains information regarding the current
position and current buffer.
See also
Synopsis
dupmark
Usage
Integer dupmark ();
Description
This function returns zero if the mark is not set or, if the mark is
set, a duplicate of it is pushed onto the mark stack and a non-zero
value is returned.
See also
Synopsis
goto_user_mark
Usage
Void goto_user_mark (User_Mark mark);
Description
This function returns to the position of the User Mark mark . Before
this function may be called, the current buffer must be the buffer
associated with the makr.
See also
Synopsis
is_user_mark_in_narrow
Usage
Integer is_user_mark_in_narrow (User_Mark m);
Description
This function returns non-zero if the user mark m refers to a
position that is within the current narrow restriction of the current
buffer. It returns zero if the mark lies outside the restriction.
An error will be generated if m does not represent a mark for the current
buffer.
See also
Synopsis
is_visible_mark
Usage
is_visible_mark ();
Description
This function may be used to test whether or not the mark is a visible
mark. A visible mar is one which causes the region defined by it to
be highlighted.
It returns 1 is the mark is visible, or 0 if the mark
is not visible or does not exist.
See also
Synopsis
markp
Usage
Void markp ();
Description
This function returns a non-zero value if the mark is set; otherwise, it
returns zero. If a mark is set, a region is defined.
See also
Synopsis
move_user_mark
Usage
Void move_user_mark (User_Mark mark);
Description
This function call takes a previously created User Mark,
mark , and
moves it to the current position and buffer. This means that if one
subsequently calls
goto_user_mark with this mark as an argument, the
the position will be set to what it is prior to the call to
move_user_mark .
Note: This function call is not equivalent to simply using
mark = create_user_mark ();
because independent copies of a User Mark are not created uponn
assignment. That is, if one has
variable mark1, mark2;
setbuf ("first");
mark1 = create_user_mark ();
mark2 = mark1;
setbuf ("second");
and then calls
move_user_mark (mark1);
both user marks,
mark1 and
mark2 will be moved since they refer to
the same mark.
See also
Synopsis
pop_mark
Usage
pop_mark (Integer g);
Description
pop_mark pops the most recent mark pushed onto the mark stack. If
the argument g is non-zero, the editing position will be moved to
the location of the mark. However, if g is zero, the editing
position will be unchanged.
See also
Synopsis
pop_spot
Usage
Void pop_spot ();
Description
This function is used after a call to
push_spot to return to the
editing position at the last call to
push_spot in the current buffer.
See also
Synopsis
push_mark
Usage
Void push_mark();
Description
This function marks the current position as the beginning of a region.
and pushes other marks onto a stack. A region is defined by this
mark and the editing point. The mark is removed from the stack only
when the function
pop_mark is called.
For example,
define mark_buffer ()
{
bob ();
push_mark ();
eob ();
}
marks the entire buffer as a region.
See also
Synopsis
push_spot
Usage
Void push_spot ();
Description
push_spot pushes the location of the current buffer location onto a
stack. This function does not set the mark. The function
push_mark
should be used for that purpose. The spot can be returned to using the
function
pop_spot .
Note: Spots are local to each buffer. It is not
possible to call
push_spot from one buffer and then subsequently
call
pop_spot from another buffer to return to the position in the
first buffer. For this purpose, one must use user marks instead.
See also
Synopsis
user_mark_buffer
Usage
String user_mark_buffer (User_Mark m);
Description
This function returns the name of the buffer associated with the
User Mark specified by m .
See also