heitml std library

	Documentation
	Getting Started
	New Features
	Component Guide

	Programming
	Language Guide
	Language Ref.
	Component Ref.
	Class Library
	Library Files
	Std Library
	Ses Library
	Component Library
	Outline Library
	HTML Extensions
	Date/Time Library
	Math Library
	User Components
	Tryout Form
	Tutorial
	heitml 1

	User Guide
	Registration


	Frame

std Library

The std library contains basic functions, that will be used by nearly every page. You need to insert

< include std.hei >

into the beginning of your page to use the following functions.

< stdinit > ... </stdinit>

The heitml code inside <stdinit> is executed at initialization time before any other code on the page is executed. This is useful to perform initializations before any other code is executed.

It is also useful to call the heitml header manipulation functions inside <stdinit>. Note that it is required to call up these functions at initialization time.

The code inside <stdinit> has an own set of local variables. All output produced by this code will be ignored. Usually session mode is not yet initialized when the code is executed, so se. and page. variables cannot be accessed.

Note: The code inside stdinit is always executed once at initialization time, regardless of where the stdinit is used (even if used inside an if or while!)

< stdloc name >

Defines a location with a given name. Using the <stdins> environment it is possible to insert code at this location.

The <stdloc> tag will execute the code assigned to the location by previous calls of <stdins>. In case of multiple <stdins> calls the new code is appended.

Page layouts usually use <stdloc "bgbody"> and <stdloc "endbody"> at the begin and end of the page body, <stdloc "head"> in the HTML page header, and <stdloc "onload"> in a JavaScript page onload routine, so that any included libraries can use <stdins> to insert code into any of these places.

< stdins name > ... </stdins>

The code inside the <stdins> is not executed but suspended until a <stdloc> with the same name is executed. The code inside <stdins> has an own set of local variables (this will probably change in future versions) but the value of this stays the same.

sa, sarea, sessionUrl, sessionHidden, sessionActive

are defined in the std library, although these tags belong to the session mode and are documented there. These tags can be used on pages that do not use session mode themselves but want to pass on the session information to other pages using session mode.

is a function that creates a page wide unique identifier based on name. Actually a counter is incremented and its value is appended to the name. In HTML and JavaScript often names are used for identification. A component or user-defined tag can use this function to generate unique names that work, even if the tag is used several times on the same page.