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="sys-stat">sys\stat.h</a> </h1> <ul> <li><a href="#_fstat">_fstat</a> <li><a href="#_stat">_stat</a> </ul> <hr> <h2><a name="_fstat">_fstat</a> </h2><dl> <dt><strong>Header</strong></dt> <dd>sys\stat.h </dd> <dt><strong>Prototype</strong></dt> <dd><tt>int _fstat(int fd, struct stat *buf); </tt></dd> <dt><strong>Description</strong></dt> <dd>The _fstat function gets information about an open file fd and stores it in the structure pointed to by buf. Some of the fields in the _stat structure are: <p> <table class="structure"><tr><th>Field</th> <th>Description</th></tr> <tr><td>st_dev</td> <td>Drive number of disk containing file fd or value of fd if fd is a device. </td></tr> <tr><td>st_mode</td> <td>Bit map containing mode information on the open file. The bits in this mask are described in the following table.</td></tr> <tr><td>st_nlink</td> <td>Number of links (always 1). </td></tr> <tr><td>st_rdev</td> <td>Same as st_dev. </td></tr> <tr><td>st_size</td> <td>Size of open file in bytes. </td></tr> <tr><td>st_mtime</td> <td>Time last modified. </td></tr> <tr><td>st_atime</td> <td>Same as st_mtime </td></tr> <tr><td>st_ctime</td> <td>Same as st_mtime<p></td></tr> </table> st_mode will be a combination of these values:<p> <table class="structure"><tr><th>Value</th> <th>Is set if fd refers to...</th></tr> <tr><td>_S_IFCHR</td> <td>a character device. </td></tr> <tr><td>_S_IFREG</td> <td>a regular file, not a device. </td></tr> <tr><td>_S_IREAD</td> <td>a readable file or device. </td></tr> <tr><td>_S_IWRITE</td> <td>a wriatable file or device. </td></tr> </table> </dd> <dt><strong>Synonym</strong></dt> <dd>Function: fstat<br> Structure: stat<br> Modes: S_IFCHR, S_IFREG, S_IREAD, S_IWRITE </dd> <dt><strong>Return Value</strong></dt> <dd>A value of 0 if file information is successfully obtained. If the return value is -1, errno is set to EBADF indicating a bad file handle. </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="#_stat">_stat</a> <br> <a href="#findfirst">findfirst</a> <br> <a href="#findnext">findnext</a> <br> <a href="#_isatty">_isatty</a> </dd> <dt><strong>Example</strong></dt> <dd><pre>/* Example of _fstat */ #include <stdio.h> #include <stdlib.h> #include <time.h> #include <string.h> #include <fcntl.h> #include <sys\stat.h> void main() { char filen[_MAX_PATH]; char *date; int res; struct _stat fstat; int fh; printf("Enter a filename: "); gets(filen); fh = _open(filen, _O_RDONLY); if (fh < 0) { perror("Error opening file"); exit(EXIT_FAILURE); } res = _fstat(fh, &fstat); if (res != 0) { perror("Failure calling _fstat"); exit(EXIT_FAILURE); } date = asctime(localtime(&fstat.st_ctime)); printf("\nDate: %s", date); printf("Mode: %d\n", fstat.st_mode); printf("Size: %ld\n", fstat.st_size); } </pre> </dd> <dt><strong>Output</strong></dt> <dd><pre>Enter a filename: _fstat.c Date: Tue Jun 28 14: 11: 56 1994 Mode: -32330 Size: 760 </pre> </dd> </dl> <hr> <h2><a name="_stat">_stat</a> </h2><dl> <dt><strong>Header</strong></dt> <dd>sys/stat.h<br> sys/types.h </dd> <dt><strong>Prototype</strong></dt> <dd><tt>int _stat(char *path, struct _stat *buf); </tt></dd> <dt><strong>Description</strong></dt> <dd>The _stat function gets information about a file or directory specified by path and store the information in the structure that buf points to. The structure contains the following fields:<p> <table class="structure"><tr><th>Field</th> <th>Description</th></tr> <tr><td>st_dev</td> <td>The drive number of the drive specified in path, or the default drive, if none is given.</td></tr> <tr><td>st_mode</td> <td>Bit map containing mode information on the open file, made up of the values below.</td></tr> <tr><td>st_nlink</td> <td>Always 1.</td></tr> <tr><td>st_rdev</td> <td>Same as st_dev.</td></tr> <tr><td>st_size</td> <td>Size of file in bytes.</td></tr> <tr><td>st_mtime</td> <td>Time last modified.</td></tr> <tr><td>st_atime</td> <td>For NT, time last accessed; or same as st_mtime.</td></tr> <tr><td>st_ctime</td> <td>For NT, time created; otherwise same as st_mtime.</td></tr> <tr><td>st_ino</td> <td>Always 0. (stat structure only)</td></tr> <tr><td>st_uid</td> <td>Always 0. (stat structure only)</td></tr> <tr><td>st_gid</td> <td>Always 0. (stat structure only)</td></tr> </table> Use the following values for st_mode:<p> <div class="naked_tr"> _S_IFREG Set if path refers to an ordinary file, not a directory.</div> <div class="naked_tr"> _S_IREAD Set if path refers to a readable file or directory.</div> <div class="naked_tr"> _S_IWRITE Set if path refers to a writable file or directory.</div> <div class="naked_tr"> _S_IFDIR Set if path refers to a directory.</div> <div class="naked_tr"> _S_IEXEC Set if path refers to an executable file or a directory.</div> </dd> <dt><strong>Synonym</strong></dt> <dd>Function: stat<br> Values: S_IFREG, S_IREAD, S_IWRITE, S_IFDIR, S_IEXEC </dd> <dt><strong>Return Value</strong></dt> <dd>stat returns 0 if the status information is retrieved. On error the function returns -1 and errno is set. </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="#_fstat">_fstat</a> </dd> <dt><strong>Example</strong></dt> <dd><pre>/* Example of _stat */ #include <stdio.h> #include <stdlib.h> #include <time.h> #include <string.h> #include <sys\stat.h> void main() { char filen[_MAX_PATH]; char *date; int res; struct _stat fstat; printf("Enter a filename: "); gets(filen); res = _stat(filen, &fstat); if (res != 0) { perror("Failure calling _stat"); exit(EXIT_FAILURE); } date = asctime(localtime(&fstat.st_ctime)); printf("\nDate: %s", date); printf("Mode: %d\n", fstat. st_mode); printf("Size: %ld\n", fstat. st_size); } </pre> </dd> <dt><strong>Output</strong></dt> <dd><pre>Enter a filename: _stat.c Date: Thu Jun 23 09:42:04 1994 Mode: -32330 Size: 585 </pre> </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/sys-stat.html">(->オリジナル)</a> / <label>アドレス: <input type="text" name="naked_post_url" value="https://digitalmars.com/rtl/sys-stat.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>