3.4 AutoGen Scheme Functions

AutoGen uses Guile to interpret Scheme expressions within AutoGen macros. All of the normal Guile functions are available, plus several extensions (see section 3.5 Common Scheme Functions) have been added to augment the repertoire of string manipulation functions and manage the state of AutoGen processing.

This section describes those functions that are specific to AutoGen. Please take note that these AutoGen specific functions are not loaded and thus not made available until after the command line options have been processed and the AutoGen definitions have been loaded. They may, of course, be used in Scheme functions that get defined at those times, but they cannot be invoked.

3.4.1 `ag-function?' - test for function
3.4.2 `base-name' - base output name
3.4.3 `count' - definition count
3.4.4 `def-file' - definitions file name
3.4.5 `dne' - "Do Not Edit" warning
3.4.6 `error' - display message and exit
3.4.7 `exist?' - test for value name
3.4.8 `first-for?' - detect first iteration
3.4.9 `for-by' - set iteration step
3.4.10 `for-from' - set initial index
3.4.11 `for-index' - get current loop index
3.4.12 `for-sep' - set loop separation string
3.4.13 `for-to' - set ending index
3.4.14 `get' - get named value
3.4.15 `high-lim' - get highest value index
3.4.16 `last-for?' - detect last iteration
3.4.17 `len' - get count of values
3.4.18 `low-lim' - get lowest value index
3.4.19 `match-value?' - test for matching value
3.4.20 `out-delete' - delete current output file
3.4.21 `out-depth' - output file stack depth
3.4.22 `out-move' - change name of output file
3.4.23 `out-name' - current output file name
3.4.24 `out-pop' - close current output file
3.4.25 `out-push-add' - append output to file
3.4.26 `out-push-new' - purge and create output file
3.4.27 `out-resume' - resume current output file
3.4.28 `out-suspend' - suspend current output file
3.4.29 `out-switch' - close and create new output
3.4.30 `set-writable' - Make the output file be writable
3.4.31 `stack' - make list of AutoGen values
3.4.32 `suffix' - get the current suffix
3.4.33 `tpl-file' - get the template file name
3.4.34 `tpl-file-line' - get the template file and line number