Open

<< Click to Display Table of Contents >>

Manual > Control Reference > Other > Text dump control > Method >

Open

 

Open a file.

 

syntax

Open(

         dest,

         fileName

         [,bNewfile = F]

         [,bDoubleQuotation = F]

         [,sepeartor = ","]

         [,flushCount = 1]

         )

 

Parameters

 

dest

Type:

character

"client" fixed.

 

fileName

Type:

character

File path. The file name can include date and time format. You can also specify a folder. See explanation for details.

 

bNewfile

Type:

Boolean

TRUE - Create a new file and overwrite it

FALSE - Append to the file

 

bDoubleQuotation

Type:

Boolean

TRUE - Include double quotes around the data

FALSE - Do not use double quotes

 

sepeartor

Type:

character

The data separator used when calling Write.

 

flushCount

Type:

Number

When the specified number of records have been saved, a command is sent to physically write the data from the cache memory to the HDD.

When it is 0, no flushing is performed.

When the value is 1, a write command is issued for each record.

If the number is more than this, flushing will occur when the specified number of records have been written.

If you want to extend the life of your HDD, increase this number (especially when writing at high speeds).

If you increase this value, it will take longer for data to be confirmed from the cache memory to the HDD, and you will not be able to view text files in real time.

 

Return Value

Type:

Number

Returns the file handle.

If the value is 0, the file could not be opened.

 

Opens a file. The file handle is used when calling methods such as Write and Flush.

You can call the Open method multiple times to open multiple files at the same time (the file handle returned will be a different value for each file).

 

By specifying FileName as follows, you can add the date to the file name or specify multiple folder levels.

For information on date and time formats, please refer to Appendix "Date and Time Formats".

 

 

Example 1) "c:\log.txt"

Create log.txt directly under the C drive and write to it.

 

Example 2) "log%Y%m%d.txt"

A dated file (log20050101.txt) is created in the current folder and writing is performed.

 

Example 3) "log%Y%m\log%Y%m%d.txt"

A folder (log200501) is automatically created for each month in the current folder, and data is written to a dated file (log20050101.txt).

 

Example 4) "%Y\%m\log%d.txt"

A folder for each year (2005) and a folder for each month (01) are automatically created in the current folder, and data is written to a dated file (log01.txt).

 

 

reference

 

Open

Close

CloseAll

Write

Flush