SaveWatch command: Difference between revisions
Jump to navigation
Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| <span class="f_Para">Saves to a local file the list of items currently displayed in the </span><span class="f_GUIlabel">W...") |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
{| | {| | ||
|width=" | |width="125px"| '''Action:''' | ||
|width=" | |width="775px"| | ||
<span class="f_Para">Saves to a local file the list of items currently displayed in the </span>< | <span class="f_Para">Saves to a local file the list of items currently displayed in the </span><var>Watch Window</var><span class="f_Para">, as described in [[Saving and restoring Watch Window contents|Saving and restoring Watch Window contents]]. </span> | ||
<span class="f_Para">The command's first optional argument is the name of the </span><span class="f_Monospace">.watch</span><span class="f_Para"> file in which to store the </span>< | <span class="f_Para">The command's first optional argument is the name of the </span><span class="f_Monospace">.watch</span><span class="f_Para"> file in which to store the </span><var>Watch Window</var><span class="f_Para"> contents: </span> | ||
<p class="syntax">saveWatch [''watchfile'' [overwrite]]</p> | <p class="syntax">saveWatch [''watchfile'' [overwrite]]</p> | ||
| Line 14: | Line 14: | ||
Otherwise, if you specify a ''watchfile'' argument (the .watch extension may be omitted), the Watch Window contents are stored in the named file when the command executes. | Otherwise, if you specify a ''watchfile'' argument (the .watch extension may be omitted), the Watch Window contents are stored in the named file when the command executes. | ||
The Client saves the watch file in the folder that contains the JanusDebugger.exe file, [[ | The Client saves the watch file in the folder that contains the JanusDebugger.exe file, [[Changing the location of Client work files|by default.]] | ||
<span class="f_Para">If a watch file with the same name already exists when </span><span class=" | <span class="f_Para">If a watch file with the same name already exists when </span><span class="term">saveWatch</span><span class="f_Para"> executes, the result depends on whether you also specified the </span><span class="f_Monospace">overwrite</span><span class="f_Para"> parameter: </span> | ||
*If it is not specified, the saveWatch command fails, and an error message is issued. | * If it is not specified, the saveWatch command fails, and an error message is issued. | ||
*If it is specified, the existing file gets overwritten. | * If it is specified, the existing file gets overwritten. | ||
You may also specify the watch file name in these ways: | You may also specify the watch file name in these ways: | ||
*As a [[ | * As a [[Working with macro variables|macro variable]]. For example: | ||
<p class="syntax">set &a = "foo" | <p class="syntax">set &a = "foo" | ||
saveWatch &a overwrite </p> | |||
*With an absolute file system path, which ''must be enclosed in quotation marks.'' | * With an absolute file system path, which ''must be enclosed in quotation marks.'' | ||
<p class="syntax">saveWatch "c:\temp\foo.watch" | <p class="syntax">saveWatch "c:\temp\foo.watch" | ||
saveWatch "c:\temp\foo.watch" overwrite </p> | |||
The [[ | The [[LoadWatch command|loadWatch]] command restores the Watch Window contents from a watch file. | ||
|- | |- | ||
| '''Client menu:''' | | '''Client menu:''' | ||
Latest revision as of 04:19, 9 February 2023
| Action: |
Saves to a local file the list of items currently displayed in the Watch Window, as described in Saving and restoring Watch Window contents. The command's first optional argument is the name of the .watch file in which to store the Watch Window contents: saveWatch [watchfile [overwrite]] If you omit watchfile, a Windows file selection dialog box lets you create a .watch file when the command executes. Otherwise, if you specify a watchfile argument (the .watch extension may be omitted), the Watch Window contents are stored in the named file when the command executes. The Client saves the watch file in the folder that contains the JanusDebugger.exe file, by default. If a watch file with the same name already exists when saveWatch executes, the result depends on whether you also specified the overwrite parameter:
You may also specify the watch file name in these ways:
set &a = "foo" saveWatch &a overwrite
saveWatch "c:\temp\foo.watch" saveWatch "c:\temp\foo.watch" overwrite The loadWatch command restores the Watch Window contents from a watch file. |
| Client menu: | Data Display > Save Watch |
| Introduced: | Build 49 |