# LGF_IsValueInRange (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 einem Sollwert und einem Bereich um diesen Sollwert definiert. Die Funktion berechnet die untere und obere Grenze des Wertebereichs.

### Baustein Schnittstelle

| LGF_IsValueInRange (FC) |
--- | --- | ---
LReal |  |  | value |  | Ret_Val |  |  | Bool
LReal |  |  | setpoint |  | overHighLimit |  |  | Bool
LReal |  |  | range |  | 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
setpoint | LReal | Sollwert
range | LReal | Bereich in dem der Sollwert im Wertebereich liegt

### 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_LIMIT_VALUES Error: Fehler bei der Berechnung der Grenzwerte

## Funktionsbeschreibung

Die Variable `setpoint` und `range` definieren einen Wertebereich.
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 Online Support
| 30.01.2017 | First released version
| 1.0.1 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 1.0.2 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 1.1.0 | Simatic Systems Support
| 13.11.2019 | renamed from "LGF_HighLowLimit" to "LGF_IsValueInRange" Code refactoring error values changed, regions, comments and constant’s are added
| 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
| 12.11.2020 | Insert documentation