Lasso Soft Inc. > Home

[File_ReadLine]

[File_ReadLine] reads a single line from a file. Accepts two parameters, the name of the file to be read and -FileLineNumber specifying which line of the file to read.

An optional keyword/value parameter -FileEndOfLine specifies what character represents the end of lines within the file. It is important to use the same end of line character that was used when the file was created. The following are the defaults for platforms which Lasso has supported.
- Mac OS X: '\n'
- Windows: '\r\n'
- Mac OS 9 or Earlier: '\r'

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_ReadLine: File Name,
  -FileLineNumber=Line Number]

[File_ReadLine: File Name
  -FileLineNumber=Line Number
  -FileEndOfLine=End of Line Character]
Required Parameters
File Name The name of the file to be read.
-FileLineNumber The line which should be read from the file.
Optional Parameters
-FileEndOfLine The delimiter to be used to determine the end of each line. Defaults to carriage return.
Examples

To read a line from a file:

Use the [File_ReadLine] tag. The following example reads the first line from a file named myfile.txt from the root of the Web serving folder.

The [File_Control] ... [/File_Control] tags are essential so the success of the file operation can be determined using the [File_CurrentError] tag.

<?LassoScript
  File_Control;
    Variable: 'theLine' = (File_ReadLine:  '/myfile.txt', -FileLineNumber=1);
    Output: (File_CurrentError: -ErrorCode) + ': ' + (File_CurrentError);
  /File_Control;
?>
Result:
0: No Error
Tag Link [File_ReadLine] Category File
Type Substitution Data Source Any
Support Preferred Version 3.0
Output Type String Security Tag,File
Implementation Internal Sets 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 | PrivacyLegal terms and Shipping | Contact LassoSoft