.. highlightlang:: us

.. index:: ftf_open

.. _ftf_open:

ftf_open
========

.. us.tag  ftf_open NOTREADYGERMAN ftf New590 Changed5511

:ref:`ftf_open` liest Text-Dateien (ASCII-Dateien) die in Zeilen und Spalten 
angeordnete Text-, Zahlen- oder Leerfelder enthalten. Die Funktion entspricht der 
Funktion :ref:`FileToField`, :ref:`ftf_open` kann jedoch mehrere hundert
Megabytes große Dateien laden.

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

.. us.return

**Returnwert**

Ein Objekt *context*, dass an die Funktionen :ref:`ftf_close`, :ref:`ftf_get_size`,
:ref:`ftf_get_rows` usw. übergeben wird. 

.. us.params

**Parameter**

Siehe :ref:`FileToField`.

.. uparam:: context

   Objekt mit Parametern. Default-Parameter sind::
 
      options = [.  ssFieldSep = ";", 
                    ssDecimalSep = ".",
                    ssRecordSep = "\n",
                    hStatusWnd = AppGetStatusBarHandle(), 
                    bQuotedNumberConversion = FALSE,
                    iStart = 0];

.. us.example

**Beispiel**

::

   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()

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2013.11
     - Neuer Parameter *iStartPos* und Übergabe der Parameter als Objekt.
   * - 5.9.0
     - Neu.

.. seealso::
   :ref:`uberblick-binar--und-text-dateien`,
   :ref:`FileToField`,
   :ref:`ftf_open`,
   :ref:`ftf_close`,
   :ref:`ftf_get_size`,
   :ref:`ftf_get_rows`,
   :ref:`ftf_get_row_type`,
   :ref:`ftf_get_row_num`,
   :ref:`ftf_get_row_str`,
   :ref:`ftf_rewind`

:sub:`id-79884`