Home
Business Logic / Control
Endless possibilities in data processing for your projects.
CONTROL Functions
Functions F
fswAddPath()
The functions add a path for monitoring to the FileSystemWatcher.

Versionsinformationen
Release Notes, Update-Informationen, Zertifizierungen and häufig gestellte Fragen.
Konzepte
Ihr erster Schritt in die moderne und leistungsstarke Prozessvisualisierung.
Deployment
Topics, you need to know, before using WinCC OA.
Sicherheit
Wachsen sie in Bezug auf Cybersecurity über die Norm hinaus.
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
    - fclose()
      Closes a file.
    - folderSelector()
      Opens the folder selector dialog and writes the name of the selected folder to the string variable "path".
    - fileSelector()
      Opens the file selection dialog and returns the selected file name.
    - fscanfPL()
      Reads a file similar to fscanf() except changes to the current WinCC OA language before converting.
    - floor()
      Rounds down to an integer.
    - findExecutable()
      The function searches for the given executable and returns the full path to it or an empty string if not found.
    - fwrite()
      Writes a number of bytes from a blob variable to a file.
    - fprintfPL()
      Writes to a file similar to fprintf() except changes to the current WinCC OA language before converting.
    - fseek()
      Sets the pointer of the file f from the position whence to the position defined by the offset.
    - fontAdjust()
      This function adjusts the font attributes (specified via the mapping parameter) for the given font (specified via the font string).
    - fontToMapping()
      The function returns a mapping for a specified font string.
    - formatTimeUTC()
      Returns the UTC time in a particular format.
    - fabs()
      Returns the absolute value of x.
    - fflush()
      Writes data to a file.
    - fprintf()
      Writes to a file.
    - fswAddPath()
      The functions add a path for monitoring to the FileSystemWatcher.
    - formatDebug()
      Similar to the function Debug() but instead of writing to the log viewer returns the debug messages as string,.
    - fmod()
    - formatTime()
      Returns the time in a particular format.
    - fscanf()
      Reads a file.
    - fillSelector()
      Opens the filling pattern selector and writes the selection to a variable.
    - fileToString()
      This function loads an ASCII file and writes the contents into a string variable.
    - fontSelector()
      Opens the font type selector and writes the selection to a variable.
    - fopen()
      Opens a file.
    - feof()
      Examines whether an end of file has been noted.
    - formatSelector()
      Opens the format selector and writes the string format that has been selected on the format string variable.
    - fread()
      Reads a number of bytes from a file to a blob variable.
    - fscanfUL()
      Reads a file like fscanf(), but change to the current Windows user language before converting.
    - fileEditor()
      Opens text files such as .txt and .doc files in an editor. You can edit both plain and rich text.
    - fputs()
      Writes a string to a file.
    - fprintfUL()
      Writes to a file similar to fprintf() except changes to the current Windows user language before converting.
    - fgets()
      Returns a string from a file.
    - ftell()
      The ftell function obtains the current value of the file position indicator for the stream pointed to by f.
    - ferror()
      Examines whether a file error has been noted.
    - fswRemovePath()
      The function removes a path from the monitoring of the FileSystemWatcher.
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension
  Die CtrlExtension ermöglicht das Hinzufügen von benutzerdefiniertem C++-Code.
- CTRL-Debugger
  Der CTRL-Debugger ermöglicht ein Debuggen der Pogrammiersprache Control. Der Debugger kann über ein eigenes Panel verwendet werden, welches es auch erlaubt die Variablen zu beinflussen, Breakpoints zu setzen, usw.
- SQL in CONTROL
  Mit den Datenbankfunktionen besteht eine Möglichkeit, Werteabfragen von Datenpunkten und -elementen schnell durchzuführen.
- API Manager
  Das API von WinCC OA (Application Programming Interface) bietet eine Reihe von Funktionen, die es ermöglichen, dieses Prozessleitsystem um spezielle Manager zu erweitern.
Datenvisualisierung
User Interfaces, Trends und Reports für jeden Zweck und jedes Gerät.
Southbound Interfaces
Der Prozessanschluss zu den echten Maschinen/Sensoren.
Northbound Interfaces
Ihr Portal zur Cloud oder übergeordneten Systemen.
Konnektivität / Netzwerk Schnittstellen
Datenaustausch, APIs und moderne (Web) Technologien.
Benutzerverwaltung
Alles über Autorisierung, Authentifizierung und Login-Anpassung.
Verfügbarkeit
Wie sie maximale Systemverfügbarkeit erreichen können.
Reporting
Erstellen sie "State of the art"-Reports ohne Limits.
Erweiterungen
Nützliche Werkzeuge und Erweiterungen für spezielle Anforderungen.
Referenztabellen
Detaillierte und umfangreiche Inhalte für spezielle Projektanpassungen.
Videos & Tutorials
Erkunden Sie die Möglichkeiten von WinCC OA mit unserer sorgfältig ausgewählten Sammlung von Video-Tutorials und Anleitungen.
Dokumentation
Grundlegende Informationen über Bezeichnungen und Funktionsweisen innerhalb der Dokumentation.
Disclaimer
Erläuterungen zu Haftungsausschlüssen oder rechtlichen Hinweisen.

fswAddPath()

The functions add a path for monitoring to the FileSystemWatcher.

Synopsis

int fswAddPath(string path);

Parameters


Parameter	Description
path	Path to be monitored

Return value

Returns 0 if the path was successfully added for monitoring and .1 in case of an error.

Error

Possible errors are:

Path/file does not exist
Maximum amount of files that can be monitored was reached (OS dependent)

Description

The function adds a new path for monitoring to the FileSystemWatcher. The path is not added if it does not exist or is already part of the monitored paths.

Depending on the operating system the maximum number of simultaneously monitored paths can be limited. If a limit is reached no new paths can be added and the function returns an error.

It must be noted that the limit of the maximum number of files is also reduced by file handles opened in the background by the running process.

To react to changes to the registered paths the function sysConnect() provides the "fswPathChanged" event.

Example

main()
{
 fswAddPath("/tmp");
 fswAddPath("/someDir/someFile");
 sysConnect("pathChanged", "fswPathChanged");
}
pathChanged(string eventName, string path)
{
 DebugN(__FUNCTION__, path);
}

Assignment

Miscellaneous functions

Availability

UI, CTRL