Symbol List Functions
BookmarksCount ()
This function returns the number of bookmarks in the bookmark list. Use BookmarksItem to access the bookmark at a particular index in the list.
BookmarksDelete (name)
Deletes the bookname named name.
BookmarksItem (index)
This function returns the bookmark at the given index. The size of the bookmark list is returned by BookmarksCount. Index values start at zero, and continue up to one less than the value returned by Bookmarks-
Count.
This example enumerates all the bookmarks: cmark = BookmarksCount() imark = 0 while (imark < cmark)
{ bookmark = BookmarksItem(imark)
// … do something with bookmark imark = imark + 1
}
See “Bookmark Record” on page 379.
BookmarksLookupLine (filename, ln)
Searches for the bookmark at the given position. The file is in filename and the line number is ln.
Returns a Bookmark record, or nil if the bookmark is not found. See “Bookmark Record” on page 379.
BookmarksLookupName (name)
Searches for the bookmark named name.
Returns a Bookmark record or nil if the bookmark is not found. See “Bookmark Record” on page 379.
Symbol List Functions
A symbol list is a zero-based indexed collection of Symbol records. See “Symbol Record” on page 382.
Some of the symbol access functions return symbol list handles.
Symbol lists are allocated resources that should be freed using SymListFree when you are finished accessing them. Source Insight automatically cleans up dynamically allocated resources when a macro terminates.
However, Source Insight may run out of resources if you allocated many handles without freeing unused handles.
SymListCount ()
This function returns the number of symbols in the symbol list. Use SymListItem to access the symbol record
at a particular zero-based index in the list. See “Symbol Record” on page 382.
SymListFree (hsyml)
This function deallocates the given symbol list.
Source Insight 4 User Guide 399