Esta função troca o valor das variáveis, diferentes operações são tratadas com base na definição de Mode. Os endereços de Source e Destination pode coincidir, tornando possível swap na própria variável.
Função
CoDeSys: Indisponível
Laboratório de lógica: eLLabCommonLib
descrição
Destination (PVOID) Endereço de destino variável.
Source (PVOID) Endereço da variável de origem.
Type (VR_TYPE) Tipo de variável (Veja a definição).
Mode (SWAP_MODE) Modo de troca (Veja a definição).
A função retorna uma variável BOOL com o status de conversão, FALSE: Erro de execução, TRUE: Troca realizada
Exemplos
Como usar os exemplos.
No exemplo são realizadas algumas operações de swap em variáveis.
LogicLab (Ptp201, ST_SwapData)
PROGRAM ST_SwapData
VAR
i : BOOL; (* Auxiliary variable *)
BYData : ARRAY[0..5] OF BYTE; (* Byte data example *)
WDData : ARRAY[0..5] OF WORD; (* Word data example *)
DWData : ARRAY[0..5] OF DWORD; (* DWord data example *)
LWData : ARRAY[0..5] OF LWORD; (* LWord data example *)
END_VAR
// *****************************************************************************
// PROGRAM "ST_SwapData"
// *****************************************************************************
// This program shows the use of SwapData function.
// -----------------------------------------------------------------------------
// -------------------------------------------------------------------------
// SOME VARIABLE COPY
// -------------------------------------------------------------------------
// Copy BYTE, Source:=16#12, Destination:=16#12.
BYData[1]:=16#12; //Byte data example
i:=SwapData(ADR(BYData[0]), ADR(BYData[1]), BYTE_TYPE, SWAP_COPY);
// -------------------------------------------------------------------------
// SOME HALF VARIABLE SWAPS
// -------------------------------------------------------------------------
// Swap BYTE, Source:=16#12, Destination:=16#21.
BYData[0]:=16#12; //Byte data example
i:=SwapData(ADR(BYData[1]), ADR(BYData[0]), BYTE_TYPE, SWAP_HALF);
// Swap WORD, Source:=16#1234, Destination:=16#3412.
WDData[0]:=16#1234; //Word data example
i:=SwapData(ADR(WDData[1]), ADR(WDData[0]), WORD_TYPE, SWAP_HALF);
// Swap DWORD, Source:=16#12345678, Destination:=16#56781234.
DWData[0]:=16#12345678; //DWord data example
i:=SwapData(ADR(DWData[1]), ADR(DWData[0]), DWORD_TYPE, SWAP_HALF);
// Swap LWORD, Source:=16#0123456789ABCDEF, Destination:=16#89ABCDEF01234567.
LWData[0]:=16#0123456789ABCDEF; //LWord data example
i:=SwapData(ADR(LWData[1]), ADR(LWData[0]), LWORD_TYPE, SWAP_HALF);
// -------------------------------------------------------------------------
// SOME VARIABLE SWAPS
// -------------------------------------------------------------------------
// Swap BYTE, values of source and destination are swapped.
BYData[2]:=16#34; //Byte data example
BYData[3]:=16#12; //Byte data example
i:=SwapData(ADR(BYData[3]), ADR(BYData[2]), BYTE_TYPE, SWAP_VARS);
// Swap WORD, values of source and destination are swapped.
WDData[2]:=16#5678; //Word data example
WDData[3]:=16#1234; //Word data example
i:=SwapData(ADR(WDData[3]), ADR(WDData[2]), WORD_TYPE, SWAP_VARS);
// Swap DWORD, Source:=16#12345678, Destination:=16#56781234.
DWData[2]:=16#89ABCDEF; //DWord data example
DWData[3]:=16#01234567; //DWord data example
i:=SwapData(ADR(DWData[3]), ADR(DWData[2]), DWORD_TYPE, SWAP_VARS);
// Swap LWORD, Source:=16#12345678, Destination:=16#56781234.
LWData[2]:=16#FEDCBA9801234567; //DWord data example
LWData[3]:=16#0123456789ABCDEF; //DWord data example
i:=SwapData(ADR(LWData[3]), ADR(LWData[2]), LWORD_TYPE, SWAP_VARS);
// -------------------------------------------------------------------------
// SOME ENDIANNESS SWAPS
// -------------------------------------------------------------------------
// Swap BYTE, Source:=16#12, Destination:=16#12.
BYData[4]:=16#12; //Byte data example
i:=SwapData(ADR(BYData[5]), ADR(BYData[4]), BYTE_TYPE, SWAP_ENDIAN);
// Swap WORD, Source:=16#1234, Destination:=16#3412.
WDData[4]:=16#1234; //Word data example
i:=SwapData(ADR(WDData[5]), ADR(WDData[4]), WORD_TYPE, SWAP_ENDIAN);
// Swap DWORD, Source:=16#12345678, Destination:=16#78563412.
DWData[4]:=16#12345678; //DWord data example
i:=SwapData(ADR(DWData[5]), ADR(DWData[4]), DWORD_TYPE, SWAP_ENDIAN);
// Swap LWORD, Source:=16#0123456789ABCDEF, Destination:=16#EFCDAB8967452301;
LWData[4]:=16#0123456789ABCDEF; //LWord data example
i:=SwapData(ADR(LWData[5]), ADR(LWData[4]), LWORD_TYPE, SWAP_ENDIAN);
// [End of file]