globalmapper.malloc_void
========================

.. currentmodule:: globalmapper
.. py:function:: malloc_void (uint32 nbytes) -> int

    Allocates *nbytes* worth of memory for use in the same way as calling malloc() in C/C++. The returned integer is a
    pointer to the start of the memory that was allocated. Any memory allocated this way needs to be freed with
    :doc:`free_void<globalmapper.free_void>` after it is done being used. Since Python manages its memory usage
    automatically, this function should generally only be used for other SDK functions which require a memory buffer as
    a parameter (e.g. :doc:`DrawLayerListToMemory<../display/globalmapper.DrawLayerListToMemory>`. This function is
    likely to become deprecated in a future release.

    :param uint32 nbytes: The amount of memory to allocate, measured in bytes
    :returns: The address of the start of the allocated space in memory
    :rtype: int