FC_SetBitTo

FC_SetBitTo - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab:	V1.0.3.0
Versionen:	Aktuelle Version

Aufgabe

Ein einzelnes Bit sollte gemäß einem BOOL-Wert gesetzt werden.

Beschreibung

Die Funktion setzt das in der Variablen i_iConversionBit angegebene Bit des DWORD i_dwInput auf 0, wenn i_xSet = FALSE ist, oder auf 1, wenn i_xSet = TRUE ist. Die Bits werden von nieder- zu hochwertig durchgezählt und liegen im Bereich 0 bis 31.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_dwInput	DWORD	Das zu manipulierende DWORD
i_iConversionBit	INT	Nummer des zu manipulierenden Bits. 0 = niedrigstwertiges Bit, 31 = höchstwertiges Bit
i_xSet	BOOL	TRUE : Das Bit wird gesetzt. FALSE : Das Bit wird zurückgesetzt.

Eingang

Datentyp

Beschreibung

i_dwInput

DWORD

Das zu manipulierende DWORD

i_iConversionBit

INT

Nummer des zu manipulierenden Bits. 0 = niedrigstwertiges Bit, 31 = höchstwertiges Bit

i_xSet

BOOL

TRUE : Das Bit wird gesetzt.

FALSE : Das Bit wird zurückgesetzt.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer, diagnosebezogener Ausgang. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer, diagnosebezogener Ausgang.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Rückgabewert

Datentyp	Beschreibung
DWORD	Der in i_dwInput übergebene Wert, jedoch mit geändertem Bit an der Stelle i_iConversionBit, entsprechend dem Parameter i_xSet.

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	Ok	0	OK

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	OK

Das Bit wurde erfolgreich gesetzt.