# LGF_IsValueInLimits (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industries

## Kurzbeschreibung

Die Funktion prüft, ob ein Wert sich in einem definierten Wertebereich befindet. Der Wertebereich wird mit einer unteren und einer oberen Grenze definiert.

### Baustein Schnittstelle

| LGF_IsValueInLimits (FC) |
--- | --- | ---
LReal |  |  | value |  | Ret_Val |  |  | Bool
LReal |  |  | lowLimit |  | overHighLimit |  |  | Bool
LReal |  |  | highLimit |  | belowLowLimit |  |  | Bool
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
value | LReal | Wert, der geprüft werden soll, ob er sich im definierten Wertebereich befindet
lowLimit | LReal | Untere Grenze des Wertebereichs gegen den der Wert von Value gegen unterschreiten geprüft wird
highLimit | LReal | Obere Grenze des Wertebereichs gegen den der Wert von Value gegen überschreiten geprüft wird

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | Bool | Rückgabewert: TRUE wenn sich "value" im Wertebereich (Bereich um den Sollwert) befindet
overHighLimit | Bool | TRUE, wenn "value" größer ist als der obere Grenzwert
belowLowLimit | Bool | TRUE, wenn "value" kleiner ist als der untere Grenzwert
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)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Status: kein Fehler aufgetreten
16#8401 | ERR_RANGE_HIGH_BELOW_LOW_LIMIT Fehler: Oberer Grenzwert kleiner als unterer Grenzwert

## Funktionsbeschreibung

The variables `lowLimit` and `highLimit` define a value range.
Die Funktion prüft, ob sich der Wert `value` unter, in oder über dem Wertebereich befindet. Die Ausgänge `belowLowLimit`, `Ret_Val` oder `overHighLimit` geben aus, wo sich der Wert `value` befindet.

Abbildung: Funktionsweise

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Support
| 10.12.2019 | First released version Copied from "IsValueInRange"
| 3.0.0 | Siemens Industry Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 12.11.2020 | Insert documentation