fwrite_stringT_fwrite_stringFwriteStringFwriteString (Operator)

Name

fwrite_stringT_fwrite_stringFwriteStringFwriteString — Ausgabe von Zeichenketten und Zahlen in eine Textdatei.

Signatur

fwrite_string( : : FileHandle, String : )

Beschreibung

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString schreibt Zeichenketten und Zahlen in die Ausgabedatei, die durch das Handle FileHandleFileHandleFileHandleFileHandlefileHandle definiert ist und mit dem Operator open_fileopen_fileOpenFileOpenFileOpenFile im Textformat geöffnet worden sein muss.

Die Werte, die in der Datei ausgegeben werden sollen, werden mit dem Parameter StringStringStringStringstringVal übergeben. Der Parameter StringStringStringStringstringVal akzeptiert auch Tupel, in denen beliebige Zahlen und Zeichenketten gemischt vorkommen können. Alle Elemente eines Tupels werden direkt hintereinander geschrieben, ohne Leer- oder andere Trennzeichen dazwischen. Zahlen werden vor der Ausgabe in eine Zeichenkette umgewandelt.

Der Operator fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString erzeugt einen Low-Level-Fehler wenn der String nicht verlustfrei in das angegebene Datei-Encoding umgewandelt werden kann. Dies kann vorkommen, wenn das Datei-Encoding 'locale_encoding'"locale_encoding""locale_encoding""locale_encoding""locale_encoding" ist und das aktuelle Encoding der HALCON-Bibliothek 'utf8'"utf8""utf8""utf8""utf8" (s.a. set_system(::'filename_encoding','utf8':)set_system("filename_encoding","utf8")SetSystem("filename_encoding","utf8")SetSystem("filename_encoding","utf8")SetSystem("filename_encoding","utf8")).

Mit dem Aufruf set_system(::'flush_file', <Wahrheitswert>:)set_system("flush_file", <Wahrheitswert>)SetSystem("flush_file", <Wahrheitswert>)SetSystem("flush_file", <Wahrheitswert>)SetSystem("flush_file", <Wahrheitswert>) wird festgelegt, ob die Ausgabezeichen direkt oder verzögert in die Ausgabedatei geschrieben werden sollen. Ist 'flush_file'"flush_file""flush_file""flush_file""flush_file" auf 'false'"false""false""false""false" gesetzt, dann erfolgt die Ausgabe (insbesondere bei Bildschirmausgabe) erst nach dem Aufruf von fnew_linefnew_lineFnewLineFnewLineFnewLine.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

FileHandleFileHandleFileHandleFileHandlefileHandle (input_control) file → (handle)

Datei-Handle.

StringStringStringStringstringVal (input_control) string(-array) → (string / integer / real)

Werte, die in der Datei ausgegeben werden sollen.

Defaultwert: 'hallo' "hallo" "hallo" "hallo" "hallo"

Beispiel (HDevelop)

fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'

Beispiel (C)

   fwrite_string(FileHandle,"text with numbers: ");
   fwrite_string(FileHandle,"5");
   fwrite_string(FileHandle," and ");
   fwrite_string(FileHandle,"1.0");
/* results in the following output:       */
/*    'text with numbers: 5 and 1.00000'   */

/* Tupel Version */
  int  i;
  double d;
  Htuple Tuple;

  create_tuple(&Tuple,4);
  i = 5;
  d = 10.0;
  set_s(Tuple,"text with numbers: ",0);
  set_i(Tuple,i,1);
  set_s(Tuple," and ",2);
  set_d(Tuple,d,3);
  T_fwrite_string(FileHandle,HilfsTuple);

Beispiel (HDevelop)

fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'

Beispiel (HDevelop)

fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'

Beispiel (HDevelop)

fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'

Ergebnis

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString liefert den Wert 2 (H_MSG_TRUE), falls der Schreibvorgang erfolgreich abgeschlossen wird. Ansonsten wird eine Fehlerbehandlung durchgeführt. Encodingfehler haben keinen Einfluss auf den Rückgabewert.

Vorgänger

open_fileopen_fileOpenFileOpenFileOpenFile

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFile

Alternativen

write_stringwrite_stringWriteStringWriteStringWriteString

Siehe auch

open_fileopen_fileOpenFileOpenFileOpenFile, close_fileclose_fileCloseFileCloseFileCloseFile, set_systemset_systemSetSystemSetSystemSetSystem

Modul

Foundation

Operatoren