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

 SWPADDSTR() / SWPADDSTRBAS()
------------------------------------------------------------------------------
 Purpose:
 Return a string to a previous parent program.

 Syntax:
 nlValue = SWPADDSTR(cPID, cString)

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

 Returns:
 A logical value.

 Description:
 SWPADDSTR() can be used to add to the string of up to 127 bytes to be
 returned from a 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 initial string to be returned should be set using SWPSETSTR(), then
 SWPADDSTR() should be used to add characters to the end of that string
 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","Two")                                          
 success := SWPADDSTR("TEST"," parts")                                       

 returns the string "Two parts" to the program that has set a program ID of
 "TEST".

 Notes:
 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