5 This file is part of the Public Domain C Library (PDCLib).
6 Permission is granted to use, modify, and / or redistribute at will.
14 long int ftell( struct _PDCLIB_file_t * stream )
16 /* ftell() must take into account:
17 - the actual *physical* offset of the file, i.e. the offset as recognized
18 by the operating system (and stored in stream->pos.offset); and
19 - any buffers held by PDCLib, which
20 - in case of unwritten buffers, count in *addition* to the offset; or
21 - in case of unprocessed pre-read buffers, count in *substraction* to
22 the offset. (Remember to count ungetidx into this number.)
23 Conveniently, the calculation ( ( bufend - bufidx ) + ungetidx ) results
24 in just the right number in both cases:
25 - in case of unwritten buffers, ( ( 0 - unwritten ) + 0 )
26 i.e. unwritten bytes as negative number
27 - in case of unprocessed pre-read, ( ( preread - processed ) + unget )
28 i.e. unprocessed bytes as positive number.
29 That is how the somewhat obscure return-value calculation works.
31 /* If offset is too large for return type, report error instead of wrong
34 /* TODO: Check what happens when ungetc() is called on a stream at offset 0 */
35 if ( ( stream->pos.offset - stream->bufend ) > ( LONG_MAX - ( stream->bufidx - stream->ungetidx ) ) )
37 /* integer overflow */
38 _PDCLIB_errno = _PDCLIB_ERANGE;
41 return (long int)( stream->pos.offset - ( ( (int)stream->bufend - (int)stream->bufidx ) + stream->ungetidx ) );
47 #include <_PDCLIB_test.h>
53 /* Testing all the basic I/O functions individually would result in lots
54 of duplicated code, so I took the liberty of lumping it all together
57 /* The following functions delegate their tests to here:
58 fgetc fflush rewind fputc ungetc fseek
59 flushbuffer seek fillbuffer prepread prepwrite
61 char * buffer = (char*)malloc( 4 );
63 TESTCASE( ( fh = tmpfile() ) != NULL );
64 TESTCASE( setvbuf( fh, buffer, _IOLBF, 4 ) == 0 );
65 /* Testing ungetc() at offset 0 */
67 TESTCASE( ungetc( 'x', fh ) == 'x' );
68 TESTCASE( ftell( fh ) == -1l );
70 TESTCASE( ftell( fh ) == 0l );
71 /* Commence "normal" tests */
72 TESTCASE( fputc( '1', fh ) == '1' );
73 TESTCASE( fputc( '2', fh ) == '2' );
74 TESTCASE( fputc( '3', fh ) == '3' );
75 /* Positions incrementing as expected? */
76 TESTCASE( ftell( fh ) == 3l );
77 TESTCASE_NOREG( fh->pos.offset == 0l );
78 TESTCASE_NOREG( fh->bufidx == 3l );
79 /* Buffer properly flushed when full? */
80 TESTCASE( fputc( '4', fh ) == '4' );
81 TESTCASE_NOREG( fh->pos.offset == 4l );
82 TESTCASE_NOREG( fh->bufidx == 0 );
83 /* fflush() resetting positions as expected? */
84 TESTCASE( fputc( '5', fh ) == '5' );
85 TESTCASE( fflush( fh ) == 0 );
86 TESTCASE( ftell( fh ) == 5l );
87 TESTCASE_NOREG( fh->pos.offset == 5l );
88 TESTCASE_NOREG( fh->bufidx == 0l );
89 /* rewind() resetting positions as expected? */
91 TESTCASE( ftell( fh ) == 0l );
92 TESTCASE_NOREG( fh->pos.offset == 0 );
93 TESTCASE_NOREG( fh->bufidx == 0 );
94 /* Reading back first character after rewind for basic read check */
95 TESTCASE( fgetc( fh ) == '1' );
97 TESTCASE( fclose( fh ) == 0 );