get text line

Extract a single line from multi-line text content.
NameDescriptionTypeModifier
value

Multi-line text content.

StringNone
number

Integer index specifying the line in value to be extracted.

StringNone
variable

(Optional) Variable to receive the extracted text.

StringNone
A single line from multi-line text content.
This action may be used within the following project items: test modules and user-defined actions.
The following settings are applicable to this action: remove double quotes from cells, standard ASCII only.
                                
                                    	file	variable	
get text file	d:\Example.txt	para	
&nbsp			
	value	number	variable
get text line	#para	2	s
                                
                            
  • value argument:
    • While it is possible to use literal text content in the value argument, in most practical cases you will want to use a variable here (preceded by #) which has been pre-loaded with multi-line text. Possible sources of such text: a multi-line text control (see get), or a text file (see get text file action).
  • number argument:
    • Note that line numbering begins with 1.
    • TestArchitect issues a warning if the value in number is larger than the total number of lines in the multi-line text.
  • variable argument:
    • If the variable in argument variable has not been declared, the action creates it as a global.
    • If the variable argument is left empty, TestArchitect supplies a global variable with the name _result.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333