# LGF_Random_DInt (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industries

## Kurzbeschreibung

Diese Funktion generiert bei jedem Aufruf einen zufälligen Wert.
Die Zufallszahl hat den Datentyp DInt.

### Baustein Schnittstelle

| LGF_Random_DInt (FC) |
--- | --- | ---
|  |  |  |  | Ret_Val |  |  | DInt
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word
|  |  |  |  | subfunctionStatus |  |  | Word

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | DInt | Zufallszahl vom Datentyp DInt
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
subfunctionStatus | Word | Status oder Rückgabewert von aufgerufenen FB's / FC's und Systemfunktionen

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_FINISHED_NO_ERROR Abarbeitung ohne Fehler beendet
16#8600 | ERR_RD_SYS_T Fehler in Anweisung `RD_SYS_T` - weitere infos in `subFunctionStatus`

## Funktionsbeschreibung

Hinweis
  In `subFunctionStatus` wird der Status von aufgerufenen Anweisungen ausgegeben. Der Ausgangswert in `status` gibt in diesem Fall an, welche Anweisung den Fehler verursacht hat. Holen Sie sich in diesem Fall die Informationen aus der TIA Portal Online Hilfe zu den jeweiligen Anweisungen.

Die Funktion generiert zufällige Werte im Bereich:
-2147483648 ≤ ReturnVal ≤ 2147483647.

Der Zufallswert wird aus den Nanosekunden der aktuellen Systemzeit der CPU gebildet. Dabei wird die Bytereihenfolge dieses Wertes invertiert und anschließend in DInt ungewandelt.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Presales Support
| 13.11.2019 | First release copied from "LGF_Random_Real"
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 04.02.2021 | Insert documentation