WORDSWAP()

Swap neighbouring double characters in a string

Syntax

WORDSWAP (<[@]cString> [, <lSwapCharacters>]) -> cSwappedString

Arguments

<[@]cString> is the string that should be processed [<lSwapCharacters>] specifies whether an additional swap should be done within the double characters Default: .F., no additional swap

Returns

<cSwappedString> a string where neighbouring double characters are swapped

Description

The WORDSWAP() function loops through <cString> in steps of four characters and exchanges the double characters from the first and second position with the one from the third and forth position. Additionally the function can perform a swap of the both char of each double character. By setting the CSETREF() switch to .T., one can omit the return value of this functin, but one must then pass <cString> by reference.
Examples
      ? WORDSWAP("1234567890")        // "3412785690"
      ? WORDSWAP("1234567890", .t.)   // "4321876590"
Tests
      WORDSWAP("1234567890")      == "3412785690"
      WORDSWAP("1234567890", .t.) == "4321876590"
Status

Ready

Compliance

WORDSWAP() is compatible with CT3's WORDSWAP().

Platforms

All

Files

Source is charswap.c, library is libct.

See Also