ftf_open

ftf_open reads text files (ASCII) containing rows and columns of text, numbers and empty fields. The function can be used instead of FileToField. ftf_open can read large data files with hundreds of Megabytes.

context = ftf_open(ssName, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, bQuotedNumberConversion)
context = ftf_open(ssName, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, bQuotedNumberConversion, iStartPos)
context = ftf_open(ssName, options)

Return Value

context.

Parameters

See FileToField.

context

Object with parametern. Default parameters are:

options = [.  ssFieldSep = ";",
              ssDecimalSep = ".",
              ssRecordSep = "\n",
              hStatusWnd = AppGetStatusBarHandle(),
              bQuotedNumberConversion = FALSE,
              iStart = 0];

Example

def test()
{
    ssDecimalSep = ",";
    ssFieldSep = ";";
    ssRecordSep = "\n";
    hStatusWnd = AppGetStatusBarHandle();
    bQuotedNumberConversion = FALSE;
    ssName = "Z:\\UniPlot-TestData\\ABS_00001.dat.utx";
//    <rmMat, smMat, smType> = FileToField(ssName, ssFieldSep, ssDecimalSep, ..
//            ssRecordSep, hStatusWnd, bQuotedNumberConversion);
    o = ftf_open(ssName, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, ..
                 bQuotedNumberConversion);
    rvSize = ftf_get_size(o);
    while (1) {
        nRead = ftf_get_rows(o, 100);
        if (nRead == 0) {
            break;
        }
        print t = ftf_get_row_type(o);
        print v = ftf_get_row_num(o);
        print s = ftf_get_row_str(o);
    }
    ftf_close(o);
}
test()

History

Version Description
R2013.11 New parameter iStartPos und Übergabe der Parameter als Objekt.
5.9.0 New

id-79884