Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter ElevenSGML Functions (continued)

HTMLTableGetCell Function

Overview

The HTMLTableGetCell function returns the raw HTML content of a cell.

Syntax/Parameters

Syntax

string = HTMLTableGetCell ( handle hTable, int row, int column );

string = HTMLTableGetCell ( handle hTable, int index );

Parameters

hTable

A handle to an HTML Table Map Object.

row

A zero-based int specifying the row position for the cell.

column

A zero-based int specifying the column position for the cell.

index

A zero-based int as an index to the map array.

Return Value

Returns a string containing the raw HTML content of the cell. The string can be empty if the cell is empty or empty on failure. Use the GetLastError function to retrieve a formatted error code.

If the map index parameter is used and the operation is successful, the high word will contain the row and the low word will contain the column. Use the GetHighWord and GetLowWord functions to retrieve the components. The size of each is limited to 0x7FFF, or 32,767.

Remarks

The cell open and close tags are not included, only the cell content. HTMLTableGetCell will not retrieve more than 2MB of text.

If the cell is not addressable, i.e., it is spanned, the return value will be an empty string.

The HTML is returned in raw form including white space and line returns. All line returns will be designated by the CR 0x0D code. Newline (0x0A) codes are not passed through. Further, since the code is raw, errors in tags and structural errors are passed to the caller.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic