ADELIA |
VADELIA |
SADELIA |
WADELIA |
EADELIA |
(I/B) |
(I/B) |
(B) |
(I/B) |
(B) |
Description
This predefined function is used to insert or delete a certain number of spaces between each word of a character string.
Once the function is completed, words in the character string are separated by the number of spaces set as a parameter.
The separator between each word is the blank character.
Syntax
Result = &SPACE_OUT_WORDS(String;Number of spaces)
Parameters
Description |
Contents |
Controls |
|
Result |
Alphanumeric variable. |
Character string after inserting or deleting a number of spaces between each word. The result field is cleared before the function is run. |
|
String |
Alphanumeric constant or variable. |
Character string to be processed. |
Mandatory parameter. |
Number of spaces |
Positive numeric integer variable or constant. |
Number of spaces which must be placed between each word in the character string set as a parameter. |
Mandatory parameter. |
Notes: If the result field is too short, the result obtained is truncated.
When this function is used in a simple assignment, the words are spaced out in relation to the result variable. When this function is used in a concatenation expression, the spacing is performed in relation to an internal variable that is the same size as the function's String parameter.
Example
STRING = 'INDIANA PAPER DISTRIBUTION COMPANY'
SPACES = 1
NEW_STRING = &SPACE_OUT_WORDS(STRING;SPACES)
*
* The NEW_STRING is equal to: INDIANA°PAPER°DISTRIBUTION°COMPANY°°°°°°
STRING = 'INDIANA PAPER DISTRIBUTION COMPANY'
NEW_STRING = &SPACE_OUT_WORDS(STRING;2)
*
* The NEW_STRING is equal to: INDIANA°°PAPER°°DISTRIBUTION°°COMPANY°°°
List of predefined functions by topic