rtlib: FileSetEof, rename truncate internals to seteof

Author: jayrm

Diff for: inc/file.bi

@@ -39,6 +39,6 @@ declare function FileDateTime alias "fb_FileDateTime" ( byval filename as zstrin
 #endif
 
 declare function FileFlush alias "fb_FileFlush" ( byval filenumber as long = -1, byval systembuffer as long = 0 ) as long
-declare function FileTruncate alias "fb_FileTruncate" ( byval filenumber as long ) as long
+declare function FileSetEof alias "fb_FileSetEof" ( byval filenumber as long ) as long
 
 #endif

Diff for: src/rtlib/dos/file_hseteof.c

@@ -1,9 +1,9 @@
-/* low-level truncate file */
+/* low-level truncate / set end of file */
 
 #include "../fb.h"
 #include <unistd.h>
 
-int fb_hFileTruncateEx( FILE *f )
+int fb_hFileSetEofEx( FILE *f )
 {
 	fb_off_t pos;
 

Diff for: src/rtlib/fb_file.h

@@ -247,9 +247,9 @@ FBCALL int          fb_FileGetArrayLargeIOB( int fnum, long long pos, FBARRAY *d
 
 FBCALL int          fb_FileEof          ( int fnum );
        int          fb_FileEofEx        ( FB_FILE *handle );
-FBCALL int          fb_FileTruncate     ( int fnum );
-       int          fb_FileTruncateEx   ( FB_FILE *handle );
-       int          fb_hFileTruncateEx  ( FILE *f );
+FBCALL int          fb_FileSetEof       ( int fnum );
+       int          fb_FileSetEofEx     ( FB_FILE *handle );
+       int          fb_hFileSetEofEx    ( FILE *f );
 FBCALL int          fb_FileFlush        ( int fnum, int systembuffers );
        int          fb_FileFlushEx      ( FB_FILE *handle, int systembuffers );
 FBCALL void         fb_FileFlushAll     ( int systembuffers );

Diff for: src/rtlib/file_seteof.c

@@ -1,4 +1,4 @@
-/* truncate file */
+/* truncate / set end of file */
 
 #include "fb.h"
 
@@ -15,9 +15,13 @@
     For BINARY, OUTPUT, and APPEND files the current position is the byte.
 
     For RANDOM files, the current position is the record.
+
+	If the position less than current length of file, then the file is
+	shortened.  If the position is after the current length of file, then
+	the file is lengthened.
 */
 
-int fb_FileTruncateEx( FB_FILE *handle )
+int fb_FileSetEofEx( FB_FILE *handle )
 {
     int res;
 
@@ -47,15 +51,15 @@ int fb_FileTruncateEx( FB_FILE *handle )
 
     /* call the platform specifc implementation */
     if( res == FB_RTERROR_OK )
-        res = fb_hFileTruncateEx( (FILE*)handle->opaque );
+        res = fb_hFileSetEofEx( (FILE*)handle->opaque );
 
     FB_UNLOCK();
 
     return res;
 }
 
 /*:::::*/
-FBCALL int fb_FileTruncate( int fnum )
+FBCALL int fb_FileSetEof( int fnum )
 {
-    return fb_FileTruncateEx(FB_FILE_TO_HANDLE(fnum));
+    return fb_FileSetEofEx(FB_FILE_TO_HANDLE(fnum));
 }

Diff for: src/rtlib/unix/file_hseteof.c

@@ -1,9 +1,9 @@
-/* low-level truncate file */
+/* low-level truncate / set end of file */
 
 #include "../fb.h"
 #include <unistd.h>
 
-int fb_hFileTruncateEx( FILE *f )
+int fb_hFileSetEofEx( FILE *f )
 {
 	fb_off_t pos;
 

Diff for: src/rtlib/win32/file_hseteof.c

@@ -1,4 +1,4 @@
-/* low-level truncate file */
+/* low-level truncate / set end of file */
 
 #include "../fb.h"
 #include <unistd.h>
@@ -17,7 +17,7 @@
     our current setup
 */
 
-int fb_hFileTruncateEx( FILE *f )
+int fb_hFileSetEofEx( FILE *f )
 {
 
 #if defined( FTRUNCATE_DEFINED )

Diff for: tests/file/file-seteof.bas

@@ -2,16 +2,16 @@
 
 #include "file.bi"
 
-SUITE( fbc_tests.file_.file_truncate )
+SUITE( fbc_tests.file_.file_seteof )
 
-	const filename = "./file/truncate.tmp"
+	const filename = "./file/seteof.tmp"
 
-	TEST( truncatebinary )
+	TEST( seteofbinary )
 
-		#macro chkTruncate( i )
+		#macro chkSetEof( i )
 			seek #1, i+1
 			CU_ASSERT( seek(1) = (i+1) )
-			FileTruncate( 1 )
+			FileSetEof( 1 )
 			CU_ASSERT( lof(1) = i )
 			CU_ASSERT( seek(1) = (i+1) )
 		#endmacro
@@ -20,24 +20,24 @@ SUITE( fbc_tests.file_.file_truncate )
 			close #1
 			if( open( filename for binary as #1 ) = 0 ) then
 
-				'' truncate can be used to increase file size
+				'' FileSetEof can be used to increase file size
 				for i as integer = 0 to 10000 step 1000
-					chkTruncate( 1 )
+					chkSetEof( 1 )
 				next
 
 				'' or decrease file size
 				for i as integer = 10000 to 0 step -1000
-					chkTruncate( 1 )
+					chkSetEof( 1 )
 				next
 
 				close #1
 
 				kill filename
 			else
-				CU_FAIL( "truncatebinary: failed" )
+				CU_FAIL( "seteofbinary: failed" )
 			end if
 		else
-			CU_FAIL( "truncatebinary: failed" )
+			CU_FAIL( "seteofbinary: failed" )
 		end if
 	END_TEST