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_stringFwriteStringFwriteStringfwrite_string schreibt Zeichenketten und Zahlen in die Ausgabedatei, die durch das Handle FileHandleFileHandleFileHandlefileHandlefile_handle definiert ist und mit dem Operator open_fileopen_fileOpenFileOpenFileopen_file im Textformat geöffnet worden sein muss.

Die Werte, die in der Datei ausgegeben werden sollen, werden mit dem Parameter StringStringStringstringValstring übergeben. Der Parameter StringStringStringstringValstring 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_stringFwriteStringFwriteStringfwrite_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" 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")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>)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" auf 'false'"false""false""false""false" gesetzt, dann erfolgt die Ausgabe (insbesondere bei Bildschirmausgabe) erst nach dem Aufruf von fnew_linefnew_lineFnewLineFnewLinefnew_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

FileHandleFileHandleFileHandlefileHandlefile_handle (input_control) file → (handle)

Datei-Handle.

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

Werte, die in der Datei ausgegeben werden sollen.

Default: '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'

Ergebnis

fwrite_stringfwrite_stringFwriteStringFwriteStringfwrite_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_fileOpenFileOpenFileopen_file

Nachfolger

close_fileclose_fileCloseFileCloseFileclose_file

Alternativen

write_stringwrite_stringWriteStringWriteStringwrite_string

Siehe auch

open_fileopen_fileOpenFileOpenFileopen_file, close_fileclose_fileCloseFileCloseFileclose_file, set_systemset_systemSetSystemSetSystemset_system

Modul

Foundation

Operatoren