[File_Read]
[File_Read] reads the contents of a file. Accepts one parameter, the name of the file to be read. Two optional parameters -FileStartPos and -FileEndPos define the range of characters which should be read from the file.
The position in a file is specified starting from 0. -FileStartPos=0 will read from the first character in a file. (This is different from most indices in Lasso which identify the first character in a string as 1.)
The file tags are protected by four different permissions. The user must have permission for all of the following in order to use this tag:
- Permission to use the tag itself.
- Permission to perform the file operation.
- Permission to work in the directory which contains the files.
- The filename extensions of the files which are being worked with must be allowed in Lasso Administration.
- Syntax
- Parameters
[File_Read: File Name]
[File_Read: File Name,
-FileStartPos=Start Position,
-FileEndPos=End Position]Examples
To read the contents of a file:
Use the [File_Read] tag. The following example reads the entire contents of a file named myfile.txt into a variable.
<?LassoScript
Variable: 'theFileContents' = (File_Read: '/myfile.txt');
Output: (File_CurrentError: -ErrorCode) + ': ' + (File_CurrentError);
?>Result:
0: No Error
| Tag Link | [File_Read] | Category | File |
|---|---|---|---|
| Type | Substitution | Data Source | Any |
| Support | Preferred | Version | 3.0 |
| Output Type | Bytes | Security | Tag,File |
| Implementation | LCAPI | Sets | Lasso 7.0, Lasso 6.0, Lasso 5.0,LDML3x |
Please note that periodically LassoSoft will go through the notes and may incorporate information from them into the documentation. Any submission here gives LassoSoft a non-exclusive license and will be made available in various formats to the Lasso community.
LassoSoft Inc. > Home
©LassoSoft Inc 2015 | Web Development by Treefrog Inc | Privacy | Legal terms and Shipping | Contact LassoSoft