Clara-Doc - Method Reference

 / packages  / CTBASE  / Version 01.00.00  / CTBUFF

CTBUFF_Cat
Description
This method appends a number of bytes to the CTBUFF instance. The source buffer can be of any type (packed decimal, ALAPH, or some memory area). The number of bytes to copy from the source buffer is specified in the @Len parameter. Don't assume that the CTBUFF_Cat method will infer the size of the source buffer based on its type. CTBASE classes work with buffers, not variable types.

Prototype 

			
     DCTBUFF_Cat...
     D                 PR            10I 0
     D@This                            *   Value
     D@Str                             *   Value
     D@Len                           10I 0 Value
Parameters
@This
TypePointer (*)
Passing ModeValue
DescriptionPointer to a CTBUFF instance obtained via the CTBUFF_Constructor method.
@Str
TypePointer (*)
Passing ModeValue
DescriptionThe address of a memory buffer that will be concatenated to the CTBUFF instance buffer.
@Len
Type10I 0
Passing ModeValue
DescriptionThe size in bytes of the memory buffer to be concatenated.
Return Values


Returns the size in bytes of the resulting buffer within the CTBUFF instance.