TestExpr

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
< [[::Category:Functions|Category:Functions]]

A function added by the New Vegas Script Extender.

Description

TestExpr is passed any expression and returns True (1) if it succeeds, or False (0) if it fails; meaning it generates an NVSE Error, and the error message is suppressed from appearing in the console.

This is an alternative to validating one's data, which might require multiple lines. Essentially it is saying; "I know this line of code might fail, so tell me if it does and I will handle it. In this case the 'error' is normal, so don't alert the user".

Comparable to the 'try', 'catch/except' found in some programming languages. Added by NVSE 4.1.

Syntax

[help]
(Result:bool) TestExpr AnyLine:expression

Example

Simple example, instead of bothering to check a key exists with Ar_HasKey:

if TestExpr SomeArray[SomeKey]
    ; SomeArray has SomeKey
else
    ; SomeArray does not have SomeKey, but don't show an error about that.
endif

Suppose you want to keep a tally of the number of times the player encounters every NPC of a particular name:

array_var aTally
ref rActor
string_var actor_name

let aTally := Ar_Construct "stringmap"
; ...

let actor_name := $rActor

if TestExpr aTally[actor_name] += 1
   ; do nothing. The increment worked because the actor_name is in the array already
else
    aTally[actor_name] := 1 ; * first time we met actor_name, so create the entry
endif

Suppose you are worried a ref variable might be empty for some reason, so your functions would fail:

ref rActor
int iStrengthStat

if TestExpr iStrengthStat := rActor.GetAV "Strength"
    ; do nothing. The function worked, so rActor must be valid
else
    ; rActor isn't valid, so don't proceed further yet
    return
endif

Notes

  • You can assign variables using ':=', '+=', etc, using any NVSE aware command (such as TestExpr, Eval, While...), not just with Let.

See Also