digitalmars.com
Last update Sun Mar 4 12:00:59 2018
Runtime Library
Constants
Data types
Standard C
assert.h
complex.h
ctype.h
fenv.h
float.h
locale.h
math.h
setjmp.h
signal.h
stdarg.h
stddef.h
stdio.h
stdlib.h
string.h
time.h
Standard C++
IOstream
IOstream Classes
new
Win32
gc.h
DOS, DOS32, Win16
bios.h
cerror.h
disp.h
dos.h
dos.h part 2
emm.h
handle.h
int.h
msmouse.h
sound.h
swap.h
tsr.h
winio.h
Other C
bitops.h
conio.h
controlc.h
direct.h
fltpnt.h
io.h
page.h
process.h
search.h
sys\stat.h
tabsize.h
trace.h
utime.h
unmangle.h
util.h
Other C++
regexp.h
class complex
<h1><a name="util">util.h</a> </h1> These are very useful utility functions. They aren't part of any standard, but ought to be. <ul> <li><a href="#file_append">file_append</a> <li><a href="#file_read">file_read</a> <li><a href="#file_write">file_write</a> </ul> <hr> <h2><a name="file_append">file_append</a> </h2><dl> <dt><strong>Header</strong></dt> <dd>util.h </dd> <dt><strong>Prototype</strong></dt> <dd><tt> int file_append(const char *name, void *buffer, size_t size); </tt></dd> <dt><strong>Description</strong></dt> <dd> Takes the number of bytes specified by <em>size</em> pointed to by <em>buffer</em> and appends it to the file specified by <em>name</em>. If the file does not exist, it is created. The append is always done in binary mode; no CR-LF translation is done. <p> <tt>file_append()</tt> is very useful for maintaining log files. </dd> <dt><strong>Return Value</strong></dt> <dd> 0 if successful. Otherwise, returns the error code. </dd> <dt><strong>Compatibility</strong></dt> <dd> DOS Windows 3.x Phar Lap DOSX Win32 </dd> <dt><strong>See Also</strong></dt> <dd> <a href="#file_read">file_read</a> <a href="#file_write">file_write</a> </dd> </dl> <hr> <h2><a name="file_read">file_read</a> </h2><dl> <dt><strong>Header</strong></dt> <dd>util.h </dd> <dt><strong>Prototype</strong></dt> <dd><tt>int file_read(const char *name, void **pbuffer, size_t *psize); </tt></dd> <dt><strong>Description</strong></dt> <dd>Reads the contents of the file specified by <em>name</em> into a buffer. The buffer is allocated by <tt>malloc()</tt>, and a pointer to it is returned in <em>*pbuffer</em>. <em>*psize</em> is set to the length of the file. <p> The read is always done in binary mode; no CR-LF translation is done. <p> In 16 bit memory models, an extra byte is always stored at <em>buffer[size]</em>. This makes it safe to use functions on it that rely on 0 terminated strings. 32 bit memory models have three 0 bytes after the end, this insures that not only will char string scans terminate, but wide character scanning functions as well. Having a guaranteed 0 at the end makes for faster scans of the data because a length check is not needed unless a zero is encountered. </dd> <dt><strong>Return Value</strong></dt> <dd>0 if successful. Otherwise, returns the error code. </dd> <dt><strong>Compatibility</strong></dt> <dd>DOS Windows 3.x Phar Lap DOSX Win32 </dd> <dt><strong>See Also</strong></dt> <dd><a href="#file_append">file_read</a> <a href="#file_write">file_write</a> </dd> </dl> <hr> <h2><a name="file_write">file_write</a> </h2><dl> <dt><strong>Header</strong></dt> <dd>util.h </dd> <dt><strong>Prototype</strong></dt> <dd><tt>int file_write(const char *name, void *buffer, size_t size); </tt></dd> <dt><strong>Description</strong></dt> <dd>Takes the number of bytes specified by <em>size</em> pointed to by <em>buffer</em> and writes it to the file specified by <em>name</em>. The write is always done in binary mode; no CR-LF translation is done. </dd> <dt><strong>Return Value</strong></dt> <dd>0 if successful. Otherwise, returns the error code. </dd> <dt><strong>Compatibility</strong></dt> <dd>DOS Windows 3.x Phar Lap DOSX Win32 </dd> <dt><strong>See Also</strong></dt> <dd><a href="#file_append">file_append</a> <a href="#file_read">file_read</a> </dd> </dl> </div> <div id="footernav"> <a href="https://www.digitalmars.com/" title="digitalmars.com">Home</a> | <a href="/index.cgi/speech/https://digitalmars.com/rtl/../ctg/ctg.html" title="Compiler and Tools Guide">Compiler & Tools</a> | <a href="/index.cgi/speech/https://digitalmars.com/rtl/../ugr/ugr.html" title="IDDE Reference">IDDE Reference</a> | <a href="/index.cgi/speech/https://digitalmars.com/rtl/../stl/index.html" title="Standard Template Library">STL</a> | <a href="https://www.digitalmars.com/advancedsearch.html" title="Search Digital Mars web site">Search</a> | <a href="https://www.digitalmars.com//download/freecompiler.html" title="download C++">Download</a> | <a href="https://www.digitalmars.com/NewsGroup.html" title="Forums">Forums</a> </div> <div id="copyright"> Copyright © 1999-2018 by Digital Mars ®, All Rights Reserved | Page generated by <a href="https://dlang.org/spec/ddoc.html">Ddoc</a>. </div> </div><div class="naked_ctrl"> <form action="/index.cgi/speech" method="get" name="gate"> <p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://digitalmars.com/rtl/util.html">(->オリジナル)</a> / <label>アドレス: <input type="text" name="naked_post_url" value="https://digitalmars.com/rtl/util.html" size="22" /></label> <label>モード: <select name="naked_post_mode"> <option value="default">デフォルト</option> <option value="speech" selected="selected">音声ブラウザ</option> <option value="ruby">ルビ付き</option> <option value="contrast">配色反転</option> <option value="larger-text">文字拡大</option> <option value="mobile">モバイル</option> </select> <input type="submit" value="表示" /> </p> </form> </div> </body> </html>