func_system_memextend.rst 869 B

12345678910111213141516171819202122232425262728293031323334353637
  1. .. _func_system_memextend:
  2. =========
  3. MemExtend
  4. =========
  5. MemExtend - Extend a block of memory
  6. Description
  7. ===========
  8. .. code-block:: blitzmax
  9. MemExtend:Byte Ptr( mem:Byte Ptr, size:Size_T, new_size:Size_T )
  10. Copies an existing block of memory specified by ``mem`` and ``size`` into a new block
  11. of memory ``new_size`` bytes long. The existing block is released and the new block is returned.
  12. Parameters
  13. ==========
  14. * ``mem`` - A pointer to the source data to be copied.
  15. * ``size`` - The number of bytes to copy to the new block.
  16. * ``new_size`` - The total number of bytes to allocate to the new block.
  17. Return Values
  18. =============
  19. A new block of memory ``new_size`` bytes long.
  20. Examples
  21. ========
  22. See Also
  23. ========
  24. :ref:`func_system_memalloc`, :ref:`func_system_memmove`, :ref:`func_system_memcopy`, :ref:`func_system_memfree`, :ref:`func_system_memclear`