Sets/clears/toggles a breakpoint, bookmark, or error indication upon the current line.

Synopsis

previousValue = EditSetFlag(option, value)

Args

option is which item to Set/Clear/Toggle. One of the following:

'UNNAME' Unnamed bookmark.
'NAM1' Named bookmark 1.
'NAM2' Named bookmark 2.
'NAM3' Named bookmark 3.
'NAM4' Named bookmark 4.
'NAM5' Named bookmark 5.
'NAM6' Named bookmark 6.
'NAM7' Named bookmark 7.
'NAM8' Named bookmark 8.
'NAM9' Named bookmark 9.
'NAM0' Named bookmark 10.
'BREAK' Breakpoint.
'ERROR' Error indication.

If omitted, 'ERROR' is assumed.

value is whether you wish to toggle, set, or clear that item. It is one of the following:

-1 Clear the item from all lines.
0 Clear the item from the current line.
1 Set the item in the current line.
2 Toggle the item in the current line.

If omitted, 1 is assumed.

Returns

The previous state of the item (ie, 0 if it was clear, or 1 if it was set) or an empty string if an error.

Notes

A given line can have only one bookmark, named or unnamed. Therefore, setting an unnamed bookmark clears any named bookmark upon the line. Setting a named bookmark clears any unnamed, or other named, bookmarks.

Clearing all lines of a named bookmark will be regarded as a desire to clear all 10 named bookmarks upon all lines.