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. |
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)
After you download the example template, you can import the template to any workspace to see this example code in action.