Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filescrp_read()
Scrap Library
scrp_write()                                                            AES

Syntax

WORD scrp_write( cpath )
char *cpath;

Function       scrp_write() sets the location of the clipboard directory.

Opcode         81 (0x51)

Availability   All AES versions.

Parameters     cpath points to a NULL-terminated path string containing
               a valid drive and path specification with a closing
               backslash. The following is an example of a correctly
               formatted cpath argument:
                    C:\CLIPBRD\

Binding        addrin[0] = cpath;

               return crys_if(0x51);

Return Value   scrp_write() returns 0 if an error occurred or non-zero
               otherwise.

Comments       The scrap directory is a global resource. This call should
               only be used in two circumstances as follows: when used to
               set the default location of the scrap directory using a CPX
               or accessory at bootup or by the user's request.
               when scrp_read() returns an error value and you need to
               create the clipboard to write information to it. The
               clipboard data exchange protocol is discussed in greater
               detail earlier in this chapter.

See Also       scrp_read()

Group          Scrap Library