164 lines
5.1 KiB
SourcePawn
Executable File
164 lines
5.1 KiB
SourcePawn
Executable File
// vim: set ts=4 sw=4 tw=99 noet:
|
|
//
|
|
// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
|
|
// Copyright (C) The AMX Mod X Development Team.
|
|
//
|
|
// This software is licensed under the GNU General Public License, version 3 or higher.
|
|
// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
|
|
// https://alliedmods.net/amxmodx-license
|
|
|
|
//
|
|
// File Functions
|
|
//
|
|
|
|
#if defined _file_included
|
|
#endinput
|
|
#endif
|
|
#define _file_included
|
|
|
|
/* Reads content from directory.
|
|
* Returns index of next element or 0 when end of dir. is reached. */
|
|
native read_dir(const dirname[],pos,output[],len,&outlen);
|
|
|
|
/* Reads line from file. Returns index of next line or 0 when end of file is reached. */
|
|
native read_file(const file[],line,text[],len,&txtlen);
|
|
|
|
/* Writes text to file. Function returns 0 on failure.
|
|
* When line is set to -1, the text is added at the end of file. */
|
|
native write_file(const file[],const text[],line = -1);
|
|
|
|
/* Deletes file. Function returns 1 on success, 0 on failure. */
|
|
native delete_file(const file[]);
|
|
|
|
/* Checks for file. If file exists function returns 1, in other case 0. */
|
|
native file_exists(const file[]);
|
|
|
|
/* renames a file. returns 0 on failure, 1 on success.
|
|
* if relative true, rename_file will act like other natives which
|
|
* use the moddir as a base directory. otherwise, the current directory is
|
|
* undefined (but assumed to be hlds).
|
|
*/
|
|
native rename_file(const oldname[], const newname[], relative=0);
|
|
|
|
/* Checks if a directory exists */
|
|
native dir_exists(const dir[]);
|
|
|
|
/* Returns a file size in bytes if flag is set to 0.
|
|
* When flag is set to 1 returns number of lines in the file,
|
|
* and when flags is 2, function returns 1 if the file ends
|
|
* with line feed. If file doesn't exist returns -1. */
|
|
native file_size(const file[], flag=0);
|
|
|
|
#define SEEK_SET 0
|
|
#define SEEK_CUR 1
|
|
#define SEEK_END 2
|
|
|
|
//Open a file, returns a handle or 0 on failure
|
|
native fopen(const filename[],const mode[]);
|
|
|
|
//Closes a file handle
|
|
native fclose(file);
|
|
|
|
#define BLOCK_INT 4
|
|
#define BLOCK_SHORT 2
|
|
#define BLOCK_CHAR 1
|
|
#define BLOCK_BYTE 1
|
|
|
|
//The following functions work as such:
|
|
// RAW - means the array you pass is a raw bytestream, for experts only
|
|
// BLOCK - means you are passing in an array where each element will be written
|
|
// NORMAL - means you are writing only one element
|
|
// RAW and BLOCK return the number of blocks acted upon successfully
|
|
// NORMAL returns 1 on success
|
|
|
|
native fread(file, &data, mode);
|
|
native fread_blocks(file, data[], blocks, mode);
|
|
native fread_raw(file, stream[], blocksize, blocks);
|
|
native fwrite(file, data, mode);
|
|
native fwrite_blocks(file, const data[], blocks, mode);
|
|
native fwrite_raw(file, const stream[], blocksize, mode);
|
|
|
|
//Returns 1 if the file is ended, 0 otherwise
|
|
native feof(file);
|
|
|
|
//Reads a line from a text file -- includes newline!
|
|
native fgets(file, buffer[], maxlength);
|
|
|
|
//Writes a line to a text file. Returns # of characters written.
|
|
native fputs(file, const text[]);
|
|
|
|
//Writes a line to the file
|
|
native fprintf(file, const fmt[], any:...);
|
|
|
|
//Sets the current position in a file (see SEEK_ values above)
|
|
native fseek(file, position, start);
|
|
|
|
//Returns the current position in a file
|
|
native ftell(file);
|
|
|
|
//These are straight from the C standard.
|
|
native fgetc(file);
|
|
native fputc(file, data);
|
|
native fungetc(file, data);
|
|
|
|
//Return the size of a file
|
|
native filesize(const filename[], any:...);
|
|
|
|
//Attempts to remove a directory.
|
|
//Note that you cannot remove a directory that has files on most
|
|
// operating systems.
|
|
native rmdir(const path[]);
|
|
|
|
/* Returns 0 on success, like the POSIX specification */
|
|
native mkdir(const dirname[]);
|
|
|
|
|
|
//Delete a file (delete_file macro)
|
|
native unlink(const filename[]);
|
|
|
|
//Returns a handle to a directory
|
|
native open_dir(dir[], firstfile[], length);
|
|
native next_file(dirh, buffer[], length);
|
|
native close_dir(dirh);
|
|
|
|
/**
|
|
* Loads a file using the LoadFileForMe engine function.
|
|
*
|
|
* The data is truncated if there is not enough space. No null-terminator
|
|
* is applied; the data is the raw contents of the file.
|
|
*
|
|
* @param file File to load (may be a file from the GCF).
|
|
* @param buffer Buffer to store file contents.
|
|
* @param maxlength Maximum size of the file buffer.
|
|
* @param length Variable to store the file length. This may return
|
|
* a number larger than the buffer size.
|
|
* @return -1 if the file could not be loaded. Otherwise,
|
|
* the number of cells actually written to the buffer
|
|
* are returned.
|
|
*/
|
|
native LoadFileForMe(const file[], buffer[], maxlength, &length=0);
|
|
|
|
/**
|
|
* Flushes a buffered output stream.
|
|
*
|
|
* @param file File handle, or 0 for all open streams.
|
|
* @return 0 on success, -1 on failure.
|
|
*/
|
|
native fflush(file);
|
|
|
|
enum FileTimeType
|
|
{
|
|
FileTime_LastAccess, /* Last access (not available on FAT) */
|
|
FileTime_Created, /* Creation (not available on FAT) */
|
|
FileTime_LastChange, /* Last modification */
|
|
};
|
|
|
|
/**
|
|
* Returns a file timestamp as a unix timestamp.
|
|
*
|
|
* @param file File name.
|
|
* @param tmode Time mode. See FileTime_* constants.
|
|
* @return Returns a file timestamp as a unix timestamp.
|
|
*/
|
|
native GetFileTime( const file[], FileTimeType:tmode );
|