fwrite_stringT_fwrite_stringFwriteStringFwriteStringfwrite_string (Operator)

Name

fwrite_stringT_fwrite_stringFwriteStringFwriteStringfwrite_string — Ausgabe von Zeichenketten und Zahlen in eine Textdatei.

Signatur

fwrite_string( : : FileHandle, String : )

Beschreibung

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

Die Werte, die in der Datei ausgegeben werden sollen, werden mit dem Parameter StringStringStringStringstringValstring übergeben. Der Parameter StringStringStringStringstringValstring 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_stringFwriteStringFwriteStringFwriteStringfwrite_string 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""locale_encoding" ist und das aktuelle Encoding der HALCON-Bibliothek 'utf8'"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")set_system("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>)set_system("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""flush_file" auf 'false'"false""false""false""false""false" gesetzt, dann erfolgt die Ausgabe (insbesondere bei Bildschirmausgabe) erst nach dem Aufruf von fnew_linefnew_lineFnewLineFnewLineFnewLinefnew_line.

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

FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (input_control) file → (handle)

Datei-Handle.

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

Werte, die in der Datei ausgegeben werden sollen.

Defaultwert: 'hallo' "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_stringFwriteStringFwriteStringFwriteStringfwrite_string 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_fileOpenFileOpenFileOpenFileopen_file

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFileclose_file

Alternativen

write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string

Siehe auch

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, close_fileclose_fileCloseFileCloseFileCloseFileclose_file, set_systemset_systemSetSystemSetSystemSetSystemset_system

Modul

Foundation

Operatoren