Click above to get retro games delivered to your door ever month!

 SWPSETSTR() / SWPSETSTRBAS()
------------------------------------------------------------------------------
 Purpose:
 Set a string to return to the parent process.

 Syntax:
 lValue = SWPSETSTR(cPID, cString)

 Parameters:
 cPID     Parent program ID.
 cString  String to return to parent.

 Returns:
 A logical value.

 Description:
 SWPSETSTR() can be used to return a string of up to 127 bytes from the child
 program to a parent. The string to be returned may not contain any NULLs, -
 the first NULL will be interpreted as a string terminator.

 The parent to receive the string is identified using the program ID of the
 parent program (set in the parent using SWPSETPID()). The string may be
 retrieved by the parent program using SWPGETSTR().

 Example:
 success := SWPSETSTR("TEST","OK")                                           

 returns the string "OK" to the program that has set a program ID of "TEST".
 The return value is a logical indicating success or failure. There are three
 possible reasons for failure:
 1 - the named parent program kernel is not currently in memory
 2 - the string to be returned is longer than 127 bytes
 3 - the parent was linked with a version of Blinker prior to 2.10