# 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

- CHARSWAP()
- CSETREF()