Adds or deletes the spaces found on the right of a text item when reading it.
Caution: This function is taken into account for the data files for which "5.5-compatible mode: text items filled with spaces" was checked in the data model editor ("Details" tab of the description of the data file).
// Manage significant spaces (add spaces) for all the files
WithSpace(True)
Syntax
<Result> = WithSpace([<File name>] [, <Item name>] , <Options>)
<Result>: Boolean
Former management mode of significant spaces.
<File name>: Optional character string
Name of the data file used. If this parameter is not specified, WithSpace will handle all data files.
<Item name>: Optional character string
Name of the item used. If this parameter is not specified, WithSpace will handle all items in the specified data file.
<Options>: Boolean
- True: the content of the text items is filled with spaces on the right.
- False: the spaces found on the right of the text items are removed.
Remarks
Generalizing the management of spaces
- To apply the management mode of spaces to all the items found in a data file, the <Item name> parameter must be equal to "*".
Example:
WithSpace(<File name>, "*", <Options>)
- To apply the management mode of spaces to all the items of all the data files, the <File name> and <Item name> parameters must be equal to "*".
Example:
WithSpace("*", "*", <Options>)
In this case, WithSpace returns False if the management of spaces was different on at least one of the relevant items. - If only the <Options> parameter is specified, the specified management mode is applied to all the data files and to all the items.
Replication and WithSpace function
The replication is not compatible with WithSpace in the code of the client application. This function changes the nehavior of HFSQL. Using this function in the client application can affect the efficiency of replication.
Starting with version 21 update 3 (version 210065), the synchronization functions (programmed or assisted universal replication) return an error to the client application if WithSpace is used on at least one of the replicated files.