Datei lesen

Mit diesem Tool können Sie Text aus einer Datei lesen.

Geben Sie den Pfad der Datei, die gelesen werden soll, im Parameter Dateiname ein. Öffnen Sie die Datei zum Lesen, indem Sie den Parameter „Verbinden“ auf 1 setzen. Mit der Schaltfläche zum einmaligen Ausführen von MERLIC können Sie dieses Tool in einzelnen Schritten ausführen. Dies ermöglicht es Ihnen, den Text Schritt für Schritt zu lesen. Schließen Sie die Datei, indem Sie den Parameter „Verbinden“ auf 0 festlegen und MERLIC einmal ausführen. Andere Prozesse können auf die Datei zugreifen, während sie von der MVApp geöffnet ist.

Parameter

Standardparameter

Dateiname:

Dieser Parameter definiert den Namen und den Pfad der Datei, aus der der Text gelesen wird. Die Standardeinstellung ist „Me_log.txt“ im Verzeichnis „%USERPROFILE%\Documents“. Sie können den gewünschten Dateinamen und Pfad über die zugehörige Verbindungsstelle ändern oder auswählen. Wenn Sie einen relativen Dateipfad definieren, erfolgt die Dateisuche relativ zum Standardverzeichnis „%USERPROFILE%\Documents“. Wurde die MVApp jedoch bereits gespeichert, wenn Sie einen relativen Dateipfad definieren, erfolgt die Dateisuche relativ zu dem Verzeichnis, in dem sich die MVApp befindet.

Verbinden:

Dieser Parameter legt fest, ob die Verbindung zur Datei aktiviert oder deaktiviert ist. Der Parameter ist standardmäßig auf 0 festgelegt. Das bedeutet, dass die Verbindung zur Datei nicht aktiv ist und die Datei daher nicht zum Lesen geöffnet wird. Wenn Sie die ausgewählte Datei lesen möchten, müssen Sie den Parameter auf 1 setzen, um die Datei zu öffnen.

Es wird empfohlen, den Parameter „Verbinden“ auf „0“ festzulegen, bis das Tool vollständig konfiguriert wurde, da es andernfalls bei jeder Werteänderung erneut ausgeführt wird.

Lesemodus:

Dieser Parameter definiert den Lesemodus. Die Standardeinstellung ist „Wort“. Sie können den Parameter „Lesemodus“ über die zugehörige Verbindungsstelle ändern.

Wert	Beschreibung
Zeichen	Der Text wird zeichenweise gelesen.
Wort	Der Text wird wortweise gelesen.
Zeile	Der Text wird zeilenweise gelesen.

Lesezugriffe pro Zyklus:

Dieser Parameter definiert, wie viele Lesezugriffe zulässig sind, wenn die MERLIC-Vision-App ein Mal ausgeführt wird. Der Parameter ist standardmäßig auf 1 festgelegt. Das heißt, dass bei der Einstellung „Wort“ für den „Lesemodus“ pro Durchgang genau 1 Wort gelesen wird.

Zusätzliche Parameter

Datei-Handle:

Mit diesem Parameter wird das Handle der Datei angegeben, aus dem die Daten gelesen werden, d. h. aus einem vorherigen Tool, in dem bereits ein „Datei-Handle“ definiert ist. Bei Einstellung dieses Parameters wird der Parameter „Dateiname“ ignoriert und es wird stattdessen die Datei verwendet, für die das „Datei-Handle“ definiert ist.

Ergebnisse

Standardergebnisse

Text:

Dieses Ergebnis enthält den Text, der aus der Datei gelesen wurde, als Zeichenfolge.

Dateiende erreicht:

Dieses Ergebnis gibt an, ob das Ende der Datei erreicht ist. Die Ausgabe erfolgt als boolescher Wert. Bei dem Wert 1 ist das Ende der Datei erreicht.

Aktueller Dateiname:

Dieses Ergebnis enthält den Namen und absoluten Dateipfad der Datei, die in der letzten Iteration gelesen wurde, z. B. „C:\Users\Public\Documents\MVTec\MERLIC\Me_log.txt“.

Toolstatus:

„Toolstatus“ gibt Informationen zum Status des Tools aus und kann daher für die Fehlerbehandlung verwendet werden. Weitere Informationen zu den verschiedenen Toolstatus-Ergebnissen finden Sie unter Toolstatus-Ergebnis.

Zusätzliche Ergebnisse

Verwendetes Datei-Handle:

Dieses Ergebnis stellt das Handle der Datei dar, aus der der Text gelesen wurde. Es kann von einem nachfolgenden Tool zum Schreiben oder Lesen verwendet werden. Es sollte vermieden werden, dass mehrere Tools dasselbe Handle zum Lesen aus derselben Datei oder Schreiben in dieselbe Datei verwenden, da dies zu unerwarteten Effekten führen könnte.

Verarbeitungszeit:

Dieses Ergebnis gibt die Dauer der letzten Ausführung des Tools in Millisekunden aus. Das Ergebnis wird als zusätzliches Ergebnis bereitgestellt. Es ist daher standardmäßig ausgeblendet, kann aber über die Schaltfläche neben den Toolergebnissen angezeigt werden. Weitere Informationen finden Sie im Abschnitt Verarbeitungszeit in der Tool-Referenz-Übersicht.