Editing TryToMoveTo - ReferenceAlias

[[Category:Scripting]]
[[Category:Papyrus]]
[[Category:Latent Functions]]
'''Member of:''' [[ReferenceAlias Script]]

This is a convenient way to move a reference in an alias without calling [[GetReference - ReferenceAlias|GetReference]]() on it. It's mostly useful in cases where you have lots of aliases that may or may not be filled and you want to call [[MoveTo - ObjectReference|MoveTo]]() on them without having to test for a object reference being present first.

== Syntax ==
<syntaxhighlight lang="papyrus">
bool Function TryToMoveTo(ObjectReference RefToMoveTo)
	ObjectReference Ref = GetReference()
	if Ref
		Ref.MoveTo(RefToMoveTo)
		Return True
	EndIf
	Return False
EndFunction
</syntaxhighlight>

== Parameters ==
*RefToMoveTo: The reference to move this alias's reference to

== Return Value ==
True if the reference was moved, false if there was no reference to move

== Examples ==
<syntaxhighlight lang="papyrus">
; Move the bandit to his marker
BanditAlias.TryToMoveTo(MarkerRef)
</syntaxhighlight>
==Notes:==
'''(AliasTryFunctions == TRUE) is NOT an accurate reflection of (AliasRef == HasExpectedResults) OR (Alias == HasNewOrNoValue)'''

* IS a reflection that the alias met the criteria to have the functions called upon them

*Many, if not most of these functions are external dispatch to other scripts and do not wait for expected results
*True means alias had valid reference, and is queued to run your desired function on it, or POSSIBLY already has
*False means the alias does not have a reference, or does not have a reference of the appropriate type
*Try functions do NOT return false if the function called(AddToFaction(), Clear() Etc) go on to fail for any reason
== See Also ==
*[[ReferenceAlias Script]]
*[[MoveTo - ObjectReference]]