
This function is used to set the contents of a field which is determined at runtime. You can optionally choose to set only if the destination is empty and/or only if the source is not empty.
There is no reason to use this statement if the field to be set is deterministic when writing the action.
The supplied symbolic field name and the data string may contain any of the escape sequences described in Escape Sequences. Remember that the resolved name is not an escape sequence.
As an example you might set the name to \v1 implying that the name is in track variable 1. Variable 1 could contain Artist or Title or almost any other Yate field name. A complete list of the valid symbolic names can be found in the Insert Yate Field text field context menu. The names are not case sensitive.
in order to facilitate setting the rating, use a value of 0-5 which will be converted as required. If you want to write a specific value in the range of 1-255 for the internal representation of the rating, enter it as a negative number.