dassign
Changes the value of a scalar variable
Format
dassign target value
Arguments
target
The name of a scalar variable in your program.
value
A source-language expression that evaluates to a scalar value. This expression can use the name of another variable.
Description
The dassign command evaluates an expression and replaces the value of a variable with the evaluated result. The location can be a scalar variable, a dereferenced pointer variable, or an element in an array or structure.
The default focus for the
dassign command is
thread. If you do not change the focus, this command acts upon the
thread of interest (TOI). If the current focus specifies a width that is wider than
t (thread) and is not
d (default), -
dassign iterates over the threads in the focus set and performs the assignment in each. In addition, if you use a list with the
dfocus command, the
dassign command iterates over each list member.
The CLI interprets each symbol name in the expression according to the current context. Because the value of a source variable might not have the same value across threads and processes, the value assigned can differ in your threads and processes. If the data type of the resulting value is incompatible with that of the target location, you must cast the value into the target’s type. (Casting is described in Chapter 13 of the TotalView User Guide.)
Assigning Characters and Strings
• If you are assigning a character to a target, place the character value within single-quotation marks; for example, ‘c’.
• You can use the standard C language escape character sequences; for example, \n and \t. These escape sequences can also be in a character or string assignment.
• If you are assigning a string to a target, place the string within quotation marks. However, you must escape the quotation marks so they are not interpreted by Tcl; for example, \"The quick brown fox\".
If value contains an expression, the TotalView expression system evaluates the expression. See Using the Evaluate Window in the TotalView User Guide for information.
Command alias
Alias | Definition | Description |
as | dassign | Changes a scalar variable’s value |
Examples
dassign scalar_y 102
Stores the value 102 in each occurrence of variable scalar_y for all processes and threads in the current set.
dassign i 10*10
Stores the value 100 in variable i.
dassign i i*i
Does not work and the CLI displays an error message. If i is a simple scalar variable, you can use the following statements:
set x [lindex [capture dprint i] 2]
dassign i [expr $x * $x]
f {p1 p2 p3} as scalar_y 102
Stores the value 102 in each occurrence of variable scalar_y contained in processes 1, 2, and 3.