PUT$ writes data to a file
Syntax
PUT$(FileName$, Contents$, [InpVar])
Arguments
- FileName$ is a string expression containing the name of a file to which the contents of string Contents$ has to be written. If FileName$ does not contain a path, the file is assumed to be present on the current Quaestor Report directory.
- Contents$ is a string or document that has to be written to file FileName$. For Contents$, the TEMPLATE$ function can be used to create an arbitrarily formatted set of data, i.e. non-Telitab input files.
- InpVar is an optional list of parameters or functions. The list has to contain the parameters, used by the function TEMPLATE$() if that is used as Contents$.
- The PUT$ function can be used to export data from a string into an input file for a satellite program. This can be used, in combination with TEMPLATE$() and the GET$() function, to run a satellite program.
Examples
Example 1: Exporting data
Using the function:
A$ = UT$("INPUT.EPI",INPUT$)
If the string INPUT$ contains the TeLiTab:
The string A$ will return the name of the input file:
And the file INPUT.EPI will contain the TeLiTab:
Example 2: Running a satellite program
PUT$(), in combination with GET$(), is an alternative for FUNCTION as GET$() returns ALL output in file FileName$ in the form of a single string on the basis of input files.
An example can be found in the description of the function GET$().
Example 3: Saving an embedded file
The syntax
PUT$("File.ext", "NullString")
saves an object embedded in the relation containing this function to a file in the current knowledge base project directory (if no path information is included in the file name).
Quick links: Functions overview | Attribute overview | Constants overview | Dimensions overview