alias (Command Alias Utility)
Description
The alias
command allows you to create, delete, and list aliases for other commands or command sequences in VSDebugPro. This feature is useful for creating shortcuts to frequently used commands, simplifying complex command sequences, or customizing your debugging environment.
Syntax
alias <add/del/list> <name> <string>
Parameters
<add/del/list>
: The operation to perform (add a new alias, delete an existing alias, or list all aliases).<name>
: The name of the alias (for add and del operations).<string>
: The command or command sequence the alias represents (for add operation).
Usage Notes
- Alias names must be unique and cannot override existing VSDebugPro commands.
- Aliases can reference other aliases, but be cautious of creating circular references.
Examples
-
Adding a simple alias:
alias add dm dumpmem
Creates an alias
dm
for the dumpmem command. -
Adding a complex alias:
alias add imgcopy memcpy img1.data img0.data img0.height * img0.stride "
Creates an alias
imgcopy
that copyes the img1 bytes data to img0. -
Deleting an alias:
alias del dm
Deletes the alias
dm
. -
Listing all aliases:
alias list
Displays all currently defined aliases.
Error Handling
- Invalid operation: Shows an error if the operation is not
add
,del
, orlist
. - Duplicate alias: Displays an error when trying to add an alias that already exists.
- Non-existent alias: Reports an error when trying to delete an alias that doesn’t exist.
- Reserved name: Shows an error if trying to create an alias with a name that conflicts with existing commands.
These examples demonstrate how the alias
command can be used to create powerful shortcuts and custom commands, significantly enhancing your debugging workflow in VSDebugPro.