# CSETREF()

Determine return value of reference sensitive CT3 string functions

Syntax

  CSETREF ([<lNewSwitch>]) -> lOldSwitch

Arguments

  [<lNewSwitch>] .T. -> suppress return value .F. -> do not suppress return value

Returns

  lOldSwitch old (if lNewSwitch is a logical value) or current state of the switch

Description

  Within the CT3 functions, the following functions do not change the length of a string passed as parameter while transforming this string:
  ADDASCII() BLANK() CHARADD() CHARAND() CHARMIRR() CHARNOT() CHAROR() CHARRELREP() CHARREPL() CHARSORT() CHARSWAP() CHARXOR() CRYPT() JUSTLEFT() JUSTRIGHT() POSCHAR() POSREPL() RANGEREPL() REPLALL() REPLLEFT() REPLRIGHT() TOKENLOWER() TOKENUPPER() WORDREPL() WORDSWAP()
  Thus, these functions allow to pass the string by reference [@] to the function so that it may not be necessary to return the transformed string. By calling CSETREF (.T.), the above mentioned functions return the value .F. instead of the transformed string if the string is passed by reference to the function. The switch is turned off (.F.) by default.

Status

  Ready

Compliance

  This function is fully CT3 compatible.

Platforms

  All

Files

  Source is ctstr.c, library is ct3.

See Also

- WORDSWAP()