123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657 |
- <html>
- <head>
- <title>malloc</title>
- <body bgcolor=#ffffff>
- <h2 align=center>malloc</h2>
- <h4 align=center>OS/161 Reference Manual</h4>
- <h3>Name</h3>
- malloc - allocate memory
- <h3>Library</h3>
- Standard C Library (libc, -lc)
- <h3>Synopsis</h3>
- #include <stdlib.h><br>
- <br>
- void *<br>
- malloc(size_t <em>size</em>);
- <h3>Description</h3>
- malloc allocates <em>size</em> bytes of memory and returns a pointer
- to it. The memory is not necessarily zero-filled. (To get zero-filled
- memory, call <A HREF=bzero.html>bzero</A> or
- <A HREF=memset.html>memset</A>, or use
- <A HREF=calloc.html>calloc</A>.)
- <p>
- The pointer returned must be suitably aligned for use with any data
- type.
- <p>
- When asked to allocate zero bytes, malloc may either always return
- NULL, or may return distinct non-null pointers that do not point to
- any storage.
- <p>
- While malloc may at its option allocate more than <em>size</em> bytes
- to fill a request, code that calls malloc may not depend on such
- behavior and must not perform any accesses outside of the bounds
- defined by <em>size</em>.
- <p>
- It is legitimate for memory returned by malloc to not actually be
- physically mapped until it is used.
- <h3>Return Values</h3>
- malloc returns a pointer to the memory allocated. If memory cannot be
- obtained, NULL is returned.
- <h3>See Also</h3>
- <A HREF=calloc.html>calloc</A>,
- <A HREF=realloc.html>realloc</A>,
- <A HREF=free.html>free</A>
- </body>
- </html>
|