VCTRLsetTitle(3DTM)

NAME
VCTRLsetTitle, VCTRLgetTitle - View control matrix title manipulation macros.

SYNOPSIS
#include <sdl.h>

VCTRLsetTitle(char *header, char *title)

VCTRLgetTitle(char *header, char *title, int title_length)

DESCRIPTION
VCTRLsetTitle inserts the DTM title tag followed by the null-terminated character string title into the character string header. The title is surrounded by single quotation marks so that it's contents will not affect the interpretation of the header.

VCTRLgetTitle examines the character string header and determines the title string that is contained. Memory for the title string must be allocated by the user before attempting to extract the title from the header. If there is insufficient memory allocated to store the entire title as contained in the header, the title string is truncated.

SEE ALSO
DTM, VCTRLclass

DIAGNOSTICS
VCTRLgetTitle returns the error DTMERROR if the DTM title tag is not contained within the header, or if following the tag there is no delimited title string. Otherwise, VCTRLgetTitle returns a 0 value.

BUGS
VCTRLsetTitle has no way of determining if the header contains sufficient space to hold the DTM title tag and the title string itself. The results of attempting to store this information beyond the end of the allocated space are undefined.