check text line

Check a specified line of multi-line text content against a text string or regular expression.
NameDescriptionTypeModifier
value

Multi-line text content.

StringNone
number

Integer index specifying the line in value to be tested against the contents of expected argument.

StringNone
expected

Text or pattern to test for.

StringNone
Result is Passed if the specified line matches the expected line, otherwise Failed.
This action may be used within the following project items: test modules and user-defined actions.
The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only.
                                
                                    	file	variable	
get text file	d:\Example.txt	para	
&nbsp			
	value	number	expected
check text line	#para	2	TestArchitect helps teams automate more tests than ever.
                                
                            
  • 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.
    • Result registers as Failed if value in number is larger than the total lines in the multi-line text.
  • expected argument:
    • The expected argument can accept regular expressions. Note that argument values that include regular expressions must be entirely enclosed in curly braces {}. As an example, {[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}} specifies the pattern for an acceptable email address. More simply, .* represents the general wildcard for regular expressions, so that {.*arch.*} matches starch, marching, testarchitect, etc.
  • 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