NAME
	allocate - allocate an array

SYNOPSIS
	mixed *allocate(int size)

CONFIG.H - MUDOS_ALLOCATE_FILLWITH
	varargs mixed *allocate(int size, mixed fillwith)


DESCRIPTION
	Allocate an array with size elements.  All elements are initialized
	to zero.  The new array is returned.

	If config.h defines MUDOS_ALLOCATE_FILLWITH, an optional second
        argument will set all elements in the returned array to its value.

ERRORS
	If the specified array size is smaller than zero or larger than
	status()[ST_ARRAYSIZE], with ST_ARRAYSIZE defined in the include file
	<status.h>, an error will result.

SEE ALSO
	kfun/sizeof
