stm_r_xx_longdesstm_r_longdes (id, filename, &status)
Input/Output The name of the file that contains the long description.
● Thefilename
follows the conventions of the host operating system.
● This function returns the value of the argumentfilename
when one is specified. If an empty string’’
(two contiguous quotation marks) is specified, Rational Statemate creates a temporary file where it stores the text. The name of this temporary file is returned by the function.
● If no long description exists for the element,status
receives the valuestm_missing_long_description
.To retrieve the long description for the activityA1,
use the following statements:stm_id act_id;
stm_filename long_des_file;
int status;
.
.
act_id = stm_r_ac ("A1", &status);
long_des_file = stm_r_ac_longdes (act_id, "text.txt",
&status);
.
.
.The long description for the activityA1
is written to the system filetext.txt
. This file resides in the directory that is the current workarea. The variablelong_des_file
contains the string’text.txt’
following statement execution.