SPACE Function

This SPACE function returns the value of an answered variable, including an appended space character. To this, the function tests whether the variable is answered. If it is, it merges the answer, followed by a space character. If the variable is unanswered, it merges nothing (""). If append:TEXT is left empty, the default is [space]. Otherwise, replace append:TEXT with a character or text string that can be used in place of the space character. You can use the following characters in your function:

Character Description
\\ backslash character
\h non-breaking hyphen
\l line break
\p paragraph mark
\s non-breaking space
\t tab

 

Function name SPACE
Usage model SPACE ( t:TEXT, append:TEXT )
Parameters This function requires you to replace one or two parameters:

t: TEXT

The function determines wether or not this variable is answered.

append: TEXT

The function uses the value of this variable to determine what it enters after the t: TEXT value.
Result A text value.

Example

For example, assume you need to merge a client's full name. Some clients, however, do not have a middle name. You can create a script that includes this middle name (if it's provided), followed by a space. If no middle name is given, nothing will be placed into the final document.

Client First Name + " " + SPACE(Client Middle Name) + Client Last Name

Sometimes you may want to place a character other than a space into the final document. The second optional parameter for this expression enables you to specify what this character should be.

In the following example, the script uses the SPACE expression to determine if each of the variables in the address block are answered. If so, it places the answer to the variable, followed by a line break character (rather than a space character) into the document. You can use this to place each "part" of the address on its own line.

SPACE(Address Line 1, "\l") +
SPACE(Address Line 2, "\l") +
SPACE(City, ",") + SPACE(State) + SPACE(Zip Code)

Download

After you download the example template, you can import the template to any workspace to see this example code in action.