2019-07-08 17:15:34 -07:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2024-06-04 14:37:16 -07:00
< html xmlns = "http://www.w3.org/1999/xhtml" lang = "en-US" >
2019-06-22 10:30:09 -07:00
< head >
< meta http-equiv = "Content-Type" content = "text/xhtml;charset=UTF-8" / >
2024-06-04 14:37:16 -07:00
< meta http-equiv = "X-UA-Compatible" content = "IE=11" / >
2025-01-03 17:56:15 -08:00
< meta name = "generator" content = "Doxygen 1.13.1" / >
2019-06-22 10:30:09 -07:00
< meta name = "viewport" content = "width=device-width, initial-scale=1" / >
< title > mi-malloc: Basic Allocation< / title >
< link href = "tabs.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "jquery.js" > < / script >
< script type = "text/javascript" src = "dynsections.js" > < / script >
2024-06-04 14:37:16 -07:00
< script type = "text/javascript" src = "clipboard.js" > < / script >
2019-06-22 10:30:09 -07:00
< link href = "navtree.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "navtreedata.js" > < / script >
< script type = "text/javascript" src = "navtree.js" > < / script >
2024-06-04 14:37:16 -07:00
< script type = "text/javascript" src = "resize.js" > < / script >
< script type = "text/javascript" src = "cookie.js" > < / script >
2019-06-22 10:30:09 -07:00
< link href = "search/search.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "search/searchdata.js" > < / script >
< script type = "text/javascript" src = "search/search.js" > < / script >
< script type = "text/javascript" >
2024-06-04 14:37:16 -07:00
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$ ( function ( ) { init _search ( ) ; } ) ;
2019-06-22 10:30:09 -07:00
/* @license-end */
< / script >
< link href = "doxygen.css" rel = "stylesheet" type = "text/css" / >
< link href = "mimalloc-doxygen.css" rel = "stylesheet" type = "text/css" / >
< / head >
< body >
< div id = "top" > <!-- do not remove this div, it is closed by doxygen! -->
< div id = "titlearea" >
< table cellspacing = "0" cellpadding = "0" >
< tbody >
2024-06-04 14:37:16 -07:00
< tr id = "projectrow" >
2019-06-22 10:30:09 -07:00
< td id = "projectlogo" > < img alt = "Logo" src = "mimalloc-logo.svg" / > < / td >
2024-06-04 14:37:16 -07:00
< td id = "projectalign" >
< div id = "projectname" > mi-malloc< span id = "projectnumber" >   1.8/2.1< / span >
2019-06-22 10:30:09 -07:00
< / div >
< / td >
2024-06-04 14:37:16 -07:00
< td > < div id = "MSearchBox" class = "MSearchBoxInactive" >
2019-06-22 10:30:09 -07:00
< span class = "left" >
2024-06-04 14:37:16 -07:00
< span id = "MSearchSelect" onmouseover = "return searchBox.OnSearchSelectShow()" onmouseout = "return searchBox.OnSearchSelectHide()" >   < / span >
< input type = "text" id = "MSearchField" value = "" placeholder = "Search" accesskey = "S"
onfocus = "searchBox.OnSearchFieldFocus(true)"
onblur = "searchBox.OnSearchFieldFocus(false)"
2019-06-22 10:30:09 -07:00
onkeyup = "searchBox.OnSearchFieldChange(event)" / >
< / span > < span class = "right" >
2021-12-18 16:36:37 -08:00
< a id = "MSearchClose" href = "javascript:searchBox.CloseResultsWindow()" > < img id = "MSearchCloseImg" border = "0" src = "search/close.svg" alt = "" / > < / a >
2019-06-22 10:30:09 -07:00
< / span >
< / div >
< / td >
< / tr >
< / tbody >
< / table >
< / div >
<!-- end header part -->
2025-01-03 17:56:15 -08:00
<!-- Generated by Doxygen 1.13.1 -->
2019-06-22 10:30:09 -07:00
< script type = "text/javascript" >
2024-06-04 14:37:16 -07:00
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
var searchBox = new SearchBox ( "searchBox" , "search/" , '.html' ) ;
/* @license-end */
< / script >
< script type = "text/javascript" >
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$ ( function ( ) { codefold . init ( 0 ) ; } ) ;
2019-06-22 10:30:09 -07:00
/* @license-end */
< / script >
< / div > <!-- top -->
< div id = "side-nav" class = "ui-resizable side-nav-resizable" >
< div id = "nav-tree" >
< div id = "nav-tree-contents" >
< div id = "nav-sync" class = "sync" > < / div >
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< div id = "splitbar" style = "-moz-user-select:none;"
2019-06-22 10:30:09 -07:00
class = "ui-resizable-handle" >
< / div >
< / div >
< script type = "text/javascript" >
2024-06-04 14:37:16 -07:00
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$ ( function ( ) { initNavTree ( 'group__malloc.html' , '' ) ; initResizable ( true ) ; } ) ;
2019-06-22 10:30:09 -07:00
/* @license-end */
< / script >
< div id = "doc-content" >
<!-- window showing the filter options -->
< div id = "MSearchSelectWindow"
onmouseover = "return searchBox.OnSearchSelectShow()"
onmouseout = "return searchBox.OnSearchSelectHide()"
onkeydown = "return searchBox.OnSearchSelectKey(event)" >
< / div >
<!-- iframe showing the search results (closed by default) -->
< div id = "MSearchResultsWindow" >
2024-06-04 14:37:16 -07:00
< div id = "MSearchResults" >
< div class = "SRPage" >
< div id = "SRIndex" >
< div id = "SRResults" > < / div >
< div class = "SRStatus" id = "Loading" > Loading...< / div >
< div class = "SRStatus" id = "Searching" > Searching...< / div >
< div class = "SRStatus" id = "NoMatches" > No Matches< / div >
< / div >
< / div >
< / div >
2019-06-22 10:30:09 -07:00
< / div >
< div class = "header" >
< div class = "summary" >
< a href = "#func-members" > Functions< / a > < / div >
2024-06-04 14:37:16 -07:00
< div class = "headertitle" > < div class = "title" > Basic Allocation< / div > < / div >
2019-06-22 10:30:09 -07:00
< / div > <!-- header -->
< div class = "contents" >
2024-06-04 14:37:16 -07:00
< p > The basic allocation interface.
2019-06-22 10:30:09 -07:00
< a href = "#details" > More...< / a > < / p >
< table class = "memberdecls" >
2024-06-04 14:37:16 -07:00
< tr class = "heading" > < td colspan = "2" > < h2 class = "groupheader" > < a id = "func-members" name = "func-members" > < / a >
2019-06-22 10:30:09 -07:00
Functions< / h2 > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "memitem:gaf2c7b89c327d1f60f59e68b9ea644d95" id = "r_gaf2c7b89c327d1f60f59e68b9ea644d95" > < td class = "memItemLeft" align = "right" valign = "top" > void  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" > mi_free< / a > (void *p)< / td > < / tr >
< tr class = "memdesc:gaf2c7b89c327d1f60f59e68b9ea644d95" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Free previously allocated memory. < br / > < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr class = "separator:gaf2c7b89c327d1f60f59e68b9ea644d95" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "memitem:gae1dd97b542420c87ae085e822b1229e8" id = "r_gae1dd97b542420c87ae085e822b1229e8" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#gae1dd97b542420c87ae085e822b1229e8" > mi_malloc< / a > (size_t size)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:gae1dd97b542420c87ae085e822b1229e8" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate < em class = "arg" > size< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:gae1dd97b542420c87ae085e822b1229e8" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:gae6e38c4403247a7b40d80419e093bfb8" id = "r_gae6e38c4403247a7b40d80419e093bfb8" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#gae6e38c4403247a7b40d80419e093bfb8" > mi_zalloc< / a > (size_t size)< / td > < / tr >
< tr class = "memdesc:gae6e38c4403247a7b40d80419e093bfb8" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate zero-initialized < code > size< / code > bytes. < br / > < / td > < / tr >
< tr class = "separator:gae6e38c4403247a7b40d80419e093bfb8" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga6686568014b54d1e6c7ac64a076e4f56" id = "r_ga6686568014b54d1e6c7ac64a076e4f56" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga6686568014b54d1e6c7ac64a076e4f56" > mi_calloc< / a > (size_t count, size_t size)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga6686568014b54d1e6c7ac64a076e4f56" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate zero-initialized < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga6686568014b54d1e6c7ac64a076e4f56" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga0621af6a5e3aa384e6a1b548958bf583" id = "r_ga0621af6a5e3aa384e6a1b548958bf583" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga0621af6a5e3aa384e6a1b548958bf583" > mi_realloc< / a > (void *p, size_t newsize)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga0621af6a5e3aa384e6a1b548958bf583" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Re-allocate memory to < em class = "arg" > newsize< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga0621af6a5e3aa384e6a1b548958bf583" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga23a0fbb452b5dce8e31fab1a1958cacc" id = "r_ga23a0fbb452b5dce8e31fab1a1958cacc" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga23a0fbb452b5dce8e31fab1a1958cacc" > mi_recalloc< / a > (void *p, size_t count, size_t size)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga23a0fbb452b5dce8e31fab1a1958cacc" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Re-allocate memory to < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes, with extra memory initialized to zero. < br / > < / td > < / tr >
2019-07-08 17:15:34 -07:00
< tr class = "separator:ga23a0fbb452b5dce8e31fab1a1958cacc" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "memitem:ga19299856216cfbb08e2628593654dfb0" id = "r_ga19299856216cfbb08e2628593654dfb0" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga19299856216cfbb08e2628593654dfb0" > mi_expand< / a > (void *p, size_t newsize)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga19299856216cfbb08e2628593654dfb0" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Try to re-allocate memory to < em class = "arg" > newsize< / em > bytes < em > in place< / em > . < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga19299856216cfbb08e2628593654dfb0" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga61f46bade3db76ca24aaafedc40de7b6" id = "r_ga61f46bade3db76ca24aaafedc40de7b6" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga61f46bade3db76ca24aaafedc40de7b6" > mi_mallocn< / a > (size_t count, size_t size)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga61f46bade3db76ca24aaafedc40de7b6" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga61f46bade3db76ca24aaafedc40de7b6" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga8bddfb4a1270a0854bbcf44cb3980467" id = "r_ga8bddfb4a1270a0854bbcf44cb3980467" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga8bddfb4a1270a0854bbcf44cb3980467" > mi_reallocn< / a > (void *p, size_t count, size_t size)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga8bddfb4a1270a0854bbcf44cb3980467" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Re-allocate memory to < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga8bddfb4a1270a0854bbcf44cb3980467" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga4dc3a4067037b151a64629fe8a332641" id = "r_ga4dc3a4067037b151a64629fe8a332641" > < td class = "memItemLeft" align = "right" valign = "top" > void *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga4dc3a4067037b151a64629fe8a332641" > mi_reallocf< / a > (void *p, size_t newsize)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga4dc3a4067037b151a64629fe8a332641" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Re-allocate memory to < em class = "arg" > newsize< / em > bytes,. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga4dc3a4067037b151a64629fe8a332641" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga245ac90ebc2cfdd17de599e5fea59889" id = "r_ga245ac90ebc2cfdd17de599e5fea59889" > < td class = "memItemLeft" align = "right" valign = "top" > char *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga245ac90ebc2cfdd17de599e5fea59889" > mi_strdup< / a > (const char *s)< / td > < / tr >
< tr class = "memdesc:ga245ac90ebc2cfdd17de599e5fea59889" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate and duplicate a string. < br / > < / td > < / tr >
< tr class = "separator:ga245ac90ebc2cfdd17de599e5fea59889" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga486d0d26b3b3794f6d1cdb41a9aed92d" id = "r_ga486d0d26b3b3794f6d1cdb41a9aed92d" > < td class = "memItemLeft" align = "right" valign = "top" > char *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga486d0d26b3b3794f6d1cdb41a9aed92d" > mi_strndup< / a > (const char *s, size_t n)< / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr class = "memdesc:ga486d0d26b3b3794f6d1cdb41a9aed92d" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Allocate and duplicate a string up to < em class = "arg" > n< / em > bytes. < br / > < / td > < / tr >
2024-06-04 14:37:16 -07:00
< tr class = "separator:ga486d0d26b3b3794f6d1cdb41a9aed92d" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
< tr class = "memitem:ga94c3afcc086e85d75a57e9f76b9b71dd" id = "r_ga94c3afcc086e85d75a57e9f76b9b71dd" > < td class = "memItemLeft" align = "right" valign = "top" > char *  < / td > < td class = "memItemRight" valign = "bottom" > < a class = "el" href = "#ga94c3afcc086e85d75a57e9f76b9b71dd" > mi_realpath< / a > (const char *fname, char *resolved_name)< / td > < / tr >
< tr class = "memdesc:ga94c3afcc086e85d75a57e9f76b9b71dd" > < td class = "mdescLeft" >   < / td > < td class = "mdescRight" > Resolve a file path name. < br / > < / td > < / tr >
< tr class = "separator:ga94c3afcc086e85d75a57e9f76b9b71dd" > < td class = "memSeparator" colspan = "2" >   < / td > < / tr >
2019-06-22 10:30:09 -07:00
< / table >
< a name = "details" id = "details" > < / a > < h2 class = "groupheader" > Detailed Description< / h2 >
< p > The basic allocation interface. < / p >
< h2 class = "groupheader" > Function Documentation< / h2 >
2024-06-04 14:37:16 -07:00
< a id = "ga6686568014b54d1e6c7ac64a076e4f56" name = "ga6686568014b54d1e6c7ac64a076e4f56" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga6686568014b54d1e6c7ac64a076e4f56" > ◆   < / a > < / span > mi_calloc()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_calloc < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > count< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Allocate zero-initialized < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
< tr > < td class = "paramname" > count< / td > < td > number of elements. < / td > < / tr >
< tr > < td class = "paramname" > size< / td > < td > size of each element. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > pointer to the allocated memory of < em class = "arg" > size*< em class = "arg" > count< / em > bytes< / em > , or < em class = "arg" > NULL< / em > if either out of memory or when < code > count*size< / code > overflows.< / dd > < / dl >
< p > Returns a unique pointer if called with either < em class = "arg" > size< / em > or < em class = "arg" > count< / em > of 0. < / p > < dl class = "section see" > < dt > See also< / dt > < dd > < a class = "el" href = "#gae6e38c4403247a7b40d80419e093bfb8" title = "Allocate zero-initialized size bytes." > mi_zalloc()< / a > < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga19299856216cfbb08e2628593654dfb0" name = "ga19299856216cfbb08e2628593654dfb0" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga19299856216cfbb08e2628593654dfb0" > ◆   < / a > < / span > mi_expand()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_expand < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > newsize< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Try to re-allocate memory to < em class = "arg" > newsize< / em > bytes < em > in place< / em > . < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > pointer to previously allocated memory (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > newsize< / td > < td > the new required size in bytes. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > pointer to the re-allocated memory of < em class = "arg" > newsize< / em > bytes (always equal to < em class = "arg" > p< / em > ), or < em class = "arg" > NULL< / em > if either out of memory or if the memory could not be expanded in place. If < em class = "arg" > NULL< / em > is returned, the pointer < em class = "arg" > p< / em > is not freed. Otherwise the original pointer is returned as the reallocated result since it fits in-place with the new size. If < em class = "arg" > newsize< / em > is larger than the original < em class = "arg" > size< / em > allocated for < em class = "arg" > p< / em > , the bytes after < em class = "arg" > size< / em > are uninitialized. < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "gaf2c7b89c327d1f60f59e68b9ea644d95" name = "gaf2c7b89c327d1f60f59e68b9ea644d95" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" > ◆   < / a > < / span > mi_free()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
< td class = "memname" > void mi_free < / td >
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > < / td > < td > )< / td >
2019-06-22 10:30:09 -07:00
< td > < / td >
< / tr >
< / table >
< / div > < div class = "memdoc" >
< p > Free previously allocated memory. < / p >
2025-01-03 17:56:15 -08:00
< p > The pointer < code > p< / code > must have been allocated before (or be < em class = "arg" > NULL< / em > ). < / p > < dl class = "params" > < dt > Parameters< / dt > < dd >
2019-06-22 10:30:09 -07:00
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > pointer to free, or < em class = "arg" > NULL< / em > . < / td > < / tr >
2019-06-22 10:30:09 -07:00
< / table >
< / dd >
< / dl >
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "gae1dd97b542420c87ae085e822b1229e8" name = "gae1dd97b542420c87ae085e822b1229e8" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#gae1dd97b542420c87ae085e822b1229e8" > ◆   < / a > < / span > mi_malloc()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_malloc < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span > < / td > < td > )< / td >
2019-06-22 10:30:09 -07:00
< td > < / td >
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Allocate < em class = "arg" > size< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
< tr > < td class = "paramname" > size< / td > < td > number of bytes to allocate. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > pointer to the allocated memory or < em class = "arg" > NULL< / em > if out of memory. Returns a unique pointer if called with < em class = "arg" > size< / em > 0. < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga61f46bade3db76ca24aaafedc40de7b6" name = "ga61f46bade3db76ca24aaafedc40de7b6" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga61f46bade3db76ca24aaafedc40de7b6" > ◆   < / a > < / span > mi_mallocn()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_mallocn < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > count< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Allocate < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
< tr > < td class = "paramname" > count< / td > < td > The number of elements. < / td > < / tr >
< tr > < td class = "paramname" > size< / td > < td > The size of each element. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > A pointer to a block of < em class = "arg" > count< / em > * < em class = "arg" > size< / em > bytes, or < em class = "arg" > NULL< / em > if out of memory or if < em class = "arg" > count< / em > * < em class = "arg" > size< / em > overflows.< / dd > < / dl >
2024-06-04 14:37:16 -07:00
< p > If there is no overflow, it behaves exactly like < code > mi_malloc(count*size)< / code > . < / p > < dl class = "section see" > < dt > See also< / dt > < dd > < a class = "el" href = "#ga6686568014b54d1e6c7ac64a076e4f56" title = "Allocate zero-initialized count elements of size bytes." > mi_calloc()< / a > < / dd >
2019-06-22 10:30:09 -07:00
< dd >
mi_zallocn() < / dd > < / dl >
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga0621af6a5e3aa384e6a1b548958bf583" name = "ga0621af6a5e3aa384e6a1b548958bf583" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga0621af6a5e3aa384e6a1b548958bf583" > ◆   < / a > < / span > mi_realloc()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_realloc < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > newsize< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Re-allocate memory to < em class = "arg" > newsize< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > pointer to previously allocated memory (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > newsize< / td > < td > the new required size in bytes. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > pointer to the re-allocated memory of < em class = "arg" > newsize< / em > bytes, or < em class = "arg" > NULL< / em > if out of memory. If < em class = "arg" > NULL< / em > is returned, the pointer < em class = "arg" > p< / em > is not freed. Otherwise the original pointer is either freed or returned as the reallocated result (in case it fits in-place with the new size). If the pointer < em class = "arg" > p< / em > is < em class = "arg" > NULL< / em > , it behaves as < em class = "arg" > mi_malloc< / em > (< em class = "arg" > newsize< / em > ). If < em class = "arg" > newsize< / em > is larger than the original < em class = "arg" > size< / em > allocated for < em class = "arg" > p< / em > , the bytes after < em class = "arg" > size< / em > are uninitialized. < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga4dc3a4067037b151a64629fe8a332641" name = "ga4dc3a4067037b151a64629fe8a332641" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga4dc3a4067037b151a64629fe8a332641" > ◆   < / a > < / span > mi_reallocf()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_reallocf < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > newsize< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Re-allocate memory to < em class = "arg" > newsize< / em > bytes,. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > pointer to previously allocated memory (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > newsize< / td > < td > the new required size in bytes. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > pointer to the re-allocated memory of < em class = "arg" > newsize< / em > bytes, or < em class = "arg" > NULL< / em > if out of memory.< / dd > < / dl >
< p > In contrast to < a class = "el" href = "#ga0621af6a5e3aa384e6a1b548958bf583" title = "Re-allocate memory to newsize bytes." > mi_realloc()< / a > , if < em class = "arg" > NULL< / em > is returned, the original pointer < em class = "arg" > p< / em > is freed (if it was not < em class = "arg" > NULL< / em > itself). Otherwise the original pointer is either freed or returned as the reallocated result (in case it fits in-place with the new size). If the pointer < em class = "arg" > p< / em > is < em class = "arg" > NULL< / em > , it behaves as < em class = "arg" > mi_malloc< / em > (< em class = "arg" > newsize< / em > ). If < em class = "arg" > newsize< / em > is larger than the original < em class = "arg" > size< / em > allocated for < em class = "arg" > p< / em > , the bytes after < em class = "arg" > size< / em > are uninitialized.< / p >
2019-06-22 10:30:09 -07:00
< dl class = "section see" > < dt > See also< / dt > < dd > < a href = "https://www.freebsd.org/cgi/man.cgi?query=reallocf" > reallocf< / a > (on BSD) < / dd > < / dl >
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga8bddfb4a1270a0854bbcf44cb3980467" name = "ga8bddfb4a1270a0854bbcf44cb3980467" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga8bddfb4a1270a0854bbcf44cb3980467" > ◆   < / a > < / span > mi_reallocn()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_reallocn < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > count< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Re-allocate memory to < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > Pointer to a previously allocated block (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > count< / td > < td > The number of elements. < / td > < / tr >
< tr > < td class = "paramname" > size< / td > < td > The size of each element. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > A pointer to a re-allocated block of < em class = "arg" > count< / em > * < em class = "arg" > size< / em > bytes, or < em class = "arg" > NULL< / em > if out of memory or if < em class = "arg" > count< / em > * < em class = "arg" > size< / em > overflows.< / dd > < / dl >
2019-07-08 17:15:34 -07:00
< p > If there is no overflow, it behaves exactly like < code > mi_realloc(p,count*size)< / code > . < / p > < dl class = "section see" > < dt > See also< / dt > < dd > < a href = "http://man.openbsd.org/reallocarray" > reallocarray()< / a > (on BSD) < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga94c3afcc086e85d75a57e9f76b9b71dd" name = "ga94c3afcc086e85d75a57e9f76b9b71dd" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga94c3afcc086e85d75a57e9f76b9b71dd" > ◆   < / a > < / span > mi_realpath()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > char * mi_realpath < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > const char *< / td > < td class = "paramname" > < span class = "paramname" > < em > fname< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > char *< / td > < td class = "paramname" > < span class = "paramname" > < em > resolved_name< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
< p > Resolve a file path name. < / p >
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
< tr > < td class = "paramname" > fname< / td > < td > File name. < / td > < / tr >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > resolved_name< / td > < td > Should be < em class = "arg" > NULL< / em > (but can also point to a buffer of at least < em class = "arg" > PATH_MAX< / em > bytes). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > If successful a pointer to the resolved absolute file name, or < em class = "arg" > NULL< / em > on failure (with < em class = "arg" > errno< / em > set to the error code).< / dd > < / dl >
< p > If < em class = "arg" > resolved_name< / em > was < em class = "arg" > NULL< / em > , the returned result should be freed with < a class = "el" href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" title = "Free previously allocated memory." > mi_free()< / a > .< / p >
< p > Replacement for the standard < a href = "http://pubs.opengroup.org/onlinepubs/9699919799/functions/realpath.html" > realpath()< / a > such that < a class = "el" href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" title = "Free previously allocated memory." > mi_free()< / a > can be used on the returned result (if < em class = "arg" > resolved_name< / em > was < em class = "arg" > NULL< / em > ). < / p >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga23a0fbb452b5dce8e31fab1a1958cacc" name = "ga23a0fbb452b5dce8e31fab1a1958cacc" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga23a0fbb452b5dce8e31fab1a1958cacc" > ◆   < / a > < / span > mi_recalloc()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2019-07-08 17:15:34 -07:00
< td class = "memname" > void * mi_recalloc < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > void *< / td > < td class = "paramname" > < span class = "paramname" > < em > p< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > count< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Re-allocate memory to < em class = "arg" > count< / em > elements of < em class = "arg" > size< / em > bytes, with extra memory initialized to zero. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > p< / td > < td > Pointer to a previously allocated block (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > count< / td > < td > The number of elements. < / td > < / tr >
< tr > < td class = "paramname" > size< / td > < td > The size of each element. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > A pointer to a re-allocated block of < em class = "arg" > count< / em > * < em class = "arg" > size< / em > bytes, or < em class = "arg" > NULL< / em > if out of memory or if < em class = "arg" > count< / em > * < em class = "arg" > size< / em > overflows.< / dd > < / dl >
2024-06-04 14:37:16 -07:00
< p > If there is no overflow, it behaves exactly like < code > mi_rezalloc(p,count*size)< / code > . < / p > < dl class = "section see" > < dt > See also< / dt > < dd > < a class = "el" href = "#ga8bddfb4a1270a0854bbcf44cb3980467" title = "Re-allocate memory to count elements of size bytes." > mi_reallocn()< / a > < / dd >
2019-06-22 10:30:09 -07:00
< dd >
< a href = "http://man.openbsd.org/reallocarray" > recallocarray()< / a > (on BSD). < / dd > < / dl >
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga245ac90ebc2cfdd17de599e5fea59889" name = "ga245ac90ebc2cfdd17de599e5fea59889" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga245ac90ebc2cfdd17de599e5fea59889" > ◆   < / a > < / span > mi_strdup()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > char * mi_strdup < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > const char *< / td > < td class = "paramname" > < span class = "paramname" > < em > s< / em > < / span > < / td > < td > )< / td >
2019-06-22 10:30:09 -07:00
< td > < / td >
< / tr >
< / table >
< / div > < div class = "memdoc" >
< p > Allocate and duplicate a string. < / p >
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > s< / td > < td > string to duplicate (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > a pointer to newly allocated memory initialized to string < em class = "arg" > s< / em > , or < em class = "arg" > NULL< / em > if either out of memory or if < em class = "arg" > s< / em > is < em class = "arg" > NULL< / em > .< / dd > < / dl >
2024-06-04 14:37:16 -07:00
< p > Replacement for the standard < a href = "http://pubs.opengroup.org/onlinepubs/9699919799/functions/strdup.html" > strdup()< / a > such that < a class = "el" href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" title = "Free previously allocated memory." > mi_free()< / a > can be used on the returned result. < / p >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "ga486d0d26b3b3794f6d1cdb41a9aed92d" name = "ga486d0d26b3b3794f6d1cdb41a9aed92d" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#ga486d0d26b3b3794f6d1cdb41a9aed92d" > ◆   < / a > < / span > mi_strndup()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > char * mi_strndup < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > const char *< / td > < td class = "paramname" > < span class = "paramname" > < em > s< / em > < / span > , < / td >
2019-06-22 10:30:09 -07:00
< / tr >
< tr >
< td class = "paramkey" > < / td >
< td > < / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > n< / em > < / span >   )< / td >
2019-06-22 10:30:09 -07:00
< / tr >
< / table >
< / div > < div class = "memdoc" >
2025-01-03 17:56:15 -08:00
< p > Allocate and duplicate a string up to < em class = "arg" > n< / em > bytes. < / p >
2019-06-22 10:30:09 -07:00
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2025-01-03 17:56:15 -08:00
< tr > < td class = "paramname" > s< / td > < td > string to duplicate (or < em class = "arg" > NULL< / em > ). < / td > < / tr >
2019-06-22 10:30:09 -07:00
< tr > < td class = "paramname" > n< / td > < td > maximum number of bytes to copy (excluding the terminating zero). < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > a pointer to newly allocated memory initialized to string < em class = "arg" > s< / em > up to the first < em class = "arg" > n< / em > bytes (and always zero terminated), or < em class = "arg" > NULL< / em > if either out of memory or if < em class = "arg" > s< / em > is < em class = "arg" > NULL< / em > .< / dd > < / dl >
2024-06-04 14:37:16 -07:00
< p > Replacement for the standard < a href = "http://pubs.opengroup.org/onlinepubs/9699919799/functions/strndup.html" > strndup()< / a > such that < a class = "el" href = "#gaf2c7b89c327d1f60f59e68b9ea644d95" title = "Free previously allocated memory." > mi_free()< / a > can be used on the returned result. < / p >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
2024-06-04 14:37:16 -07:00
< a id = "gae6e38c4403247a7b40d80419e093bfb8" name = "gae6e38c4403247a7b40d80419e093bfb8" > < / a >
< h2 class = "memtitle" > < span class = "permalink" > < a href = "#gae6e38c4403247a7b40d80419e093bfb8" > ◆   < / a > < / span > mi_zalloc()< / h2 >
2019-06-22 10:30:09 -07:00
< div class = "memitem" >
< div class = "memproto" >
< table class = "memname" >
< tr >
2024-06-04 14:37:16 -07:00
< td class = "memname" > void * mi_zalloc < / td >
2019-06-22 10:30:09 -07:00
< td > (< / td >
2024-06-04 14:37:16 -07:00
< td class = "paramtype" > size_t< / td > < td class = "paramname" > < span class = "paramname" > < em > size< / em > < / span > < / td > < td > )< / td >
2019-06-22 10:30:09 -07:00
< td > < / td >
< / tr >
< / table >
< / div > < div class = "memdoc" >
< p > Allocate zero-initialized < code > size< / code > bytes. < / p >
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
< tr > < td class = "paramname" > size< / td > < td > The size in bytes. < / td > < / tr >
< / table >
< / dd >
< / dl >
2025-01-03 17:56:15 -08:00
< dl class = "section return" > < dt > Returns< / dt > < dd > Pointer to newly allocated zero initialized memory, or < em class = "arg" > NULL< / em > if out of memory. < / dd > < / dl >
2019-06-22 10:30:09 -07:00
< / div >
< / div >
< / div > <!-- contents -->
< / div > <!-- doc - content -->
<!-- start footer part -->
< div id = "nav-path" class = "navpath" > <!-- id is needed for treeview function! -->
< ul >
2025-01-03 17:56:15 -08:00
< li class = "footer" > Generated by < a href = "https://www.doxygen.org/index.html" > < img class = "footer" src = "doxygen.svg" width = "104" height = "31" alt = "doxygen" / > < / a > 1.13.1 < / li >
2019-06-22 10:30:09 -07:00
< / ul >
< / div >
< / body >
< / html >
