gettaglocation
gettaglocation
PAGE
,
PREFIX
,
SUFFIX
,
START
,
LENGTH

The gettaglocation statement locates the first matching tag within some text.

Parameters

This statement has five parameters:

page – text that may contain tag.

prefix – opening tag.

suffix – closing tag.

start – field or variable that will contain the position of start of tag (or 0 if tag not found).

length – field or variable that will contain the position of length of tag (or 0 if tag not found)

Description

This statement locates the first matching tag within some text. This example assumes the current database has a field named Page that contains HTML.

    local tableStart,tableLen
    gettaglocation Page,"<table","</table>",tableStart,tableLen

If the Page field contains one or more tables, the tableStart and tableLen variables will be set with the position and length of the first table in the text.

See Also

- gettaglocations -- locates all matching tags within some text.
- settagdata -- changes the contents of a tag.
- setxtagvalue -- changes the contents of a tag.
- tagarray( -- builds an array (see Text Arrays) containing the body of all the specified tags (usually HTML tags) in the text.
- tagcount( -- counts the number of times a specified tag (usually an HTML tag) appears in the text. See Tag Parsing for more information on HTML tags.
- tagdata( -- extracts the body of the specified tag (usually an HTML tag) in the text. See Tag Parsing for more information on HTML tags.
- tagend( -- returns the ending position of the specified tag (usually an HTML tag) in the text.
- tagnumber( -- checks to see if a specified position is inside of a tag (usually an HTML tag).
- tagparameter( -- extracts the value of a tag parameter embedded in some text, where the tag parameter takes the form *name=value*.
- tagstart( -- returns the starting position of the specified tag (usually an HTML tag) in the text.
- tagstrip( -- removes tags (usually HTML tags) from within a piece of text.
- xtag( -- generates an HTML/XML tag.
- xtagvalue( -- extracts the text from the first matching HTML or XML tag.

History

Version | Status | Notes
10.0 | No Change | Carried over from Panorama 6.0.