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-FileGet_Buffer()
XCONTROL Utility Functions
CPX_Save()                                                         XCONTROL

Syntax

BOOLEAN (*xcpb->CPX_Save)( ptr , num );
VOIDP ptr;
LONG num;

Function      CPX_Save() writes the specified data to the CPX on disk at
              the beginning of the CPX's DATA segment.

Parameters    ptr is a pointer to the data to save.
              num specifies the length of the data in bytes.

Binding       (*xcpb->CPX_Save)( ptr, num );

Return Value  CPX_Save() returns TRUE if the operation was successful or
              FALSE if an error occurred.

Comments      CPX_Save() stores the specified data on disk in the original
              CPX file at the start of the DATA segment of the program.
              For this reason, enough space should be allocated to account
              for this data. See cpx_init() for an example method of
              accomplishing this.

See Also      Get_Buffer()

Group         XCONTROL Utility Functions