mclGetProgramLine

mclGetProgramLine

void mclGetProgramLine(UINT pIndex,
LPCTSTR pLine,
UINT pLineLength);

Parameters

pIndex

The write buffer line index. The number of program lines in the write buffer can be obtained with a call to mclGetProgramLineCount. The write buffer program code values range from 0 to mclGetProgramLineCount - 1.

pLine

Points to a character buffer that receives the code line. Refer to the remarks section for format details.

pLineLength

The length of the character buffer. It is recommended that the character buffer does not use a value of less than 60. For example,

char line[60]

Return Value

None

Remarks

Use a call to mclGetProgramLine to read a single line of program code contained in the loader write buffer. The number of program lines in the write buffer can be obtained with a call to mclGetProgramLineCount. The write buffer program code values range from 0 to mclGetProgramLineCount - 1. The line returned has the format

$00004 - $00A0 $397F $1B20 $3C80 $200C $1BA0 $3C00 $0008

where the first hexadecimal value indicates the starting address of the code line. The remainder of the line contains multiple program words. The write buffer can be initialised with a call to either mclLoadHexFile or mclRead. The write buffer may also be initialised with a call to mclAddHexLine and cleared with a call to mclClear