diff -r c7b4237fff50 -r 03a67e41afbc plugins/include/files.inc --- a/plugins/include/files.inc Fri Mar 28 06:21:34 2008 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,259 +0,0 @@ -/** - * vim: set ts=4 : - * ============================================================================= - * SourceMod (C)2004-2007 AlliedModders LLC. All rights reserved. - * ============================================================================= - * - * This file is part of the SourceMod/SourcePawn SDK. - * - * This program is free software; you can redistribute it and/or modify it under - * the terms of the GNU General Public License, version 3.0, as published by the - * Free Software Foundation. - * - * This program is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS - * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more - * details. - * - * You should have received a copy of the GNU General Public License along with - * this program. If not, see . - * - * As a special exception, AlliedModders LLC gives you permission to link the - * code of this program (as well as its derivative works) to "Half-Life 2," the - * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software - * by the Valve Corporation. You must obey the GNU General Public License in - * all respects for all other code used. Additionally, AlliedModders LLC grants - * this exception to all derivative works. AlliedModders LLC defines further - * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007), - * or . - * - * Version: $Id$ - */ - -#if defined _files_included - #endinput -#endif -#define _files_included - -/* @global All paths in SourceMod natives are relative to the mod folder unless otherwise noted. */ - -/** - * File inode types. - */ -enum FileType -{ - FileType_Unknown = 0, /* Unknown file type (device/socket) */ - FileType_Directory = 1, /* File is a directory */ - FileType_File = 2, /* File is a file */ -}; - -/** - * File time modes. - */ -enum FileTimeMode -{ - FileTime_LastAccess = 0, /* Last access (does not work on FAT) */ - FileTime_Created = 1, /* Creation (does not work on FAT) */ - FileTime_LastChange = 2, /* Last modification */ -}; - -#define PLATFORM_MAX_PATH 256 /**< Maximum path length. */ - -#define SEEK_SET 0 /**< Seek from start. */ -#define SEEK_CUR 1 /**< Seek from current position. */ -#define SEEK_END 2 /**< Seek from end position. */ - -/** - * Path types. - */ -enum PathType -{ - Path_SM, /**< SourceMod root folder */ -}; - -/** - * Builds a path relative to the SourceMod folder. - * - * @param type Type of path to build as the base. - * @param buffer Buffer to store the path. - * @param maxlength Maximum length of buffer. - * @param fmt Format string. - * @param ... Format arguments. - * @return Number of bytes written to buffer (not including null terminator). - */ -native BuildPath(PathType:type, String:buffer[], maxlength, const String:fmt[], any:...); - -/** - * Opens a directory/folder for contents enumeration. - * @note Directories are closed with CloseHandle(). - * @note Directories Handles can be cloned. - * - * @param path Path to open. - * @return A Handle to the directory, INVALID_HANDLE on open error. - */ -native Handle:OpenDirectory(const String:path[]); - -/** - * Reads the current directory entry as a local filename, then moves to the next file. - * @note Contents of buffers are undefined when returning false. - * @note Both the '.' and '..' automatic directory entries will be retrieved for Windows and Linux. - * - * @param dir Handle to a directory. - * @param buffer String buffer to hold directory name. - * @param maxlength Maximum size of string buffer. - * @param type Optional variable to store the file type. - * @return True on success, false if there are no more files to read. - * @error Invalid or corrupt Handle. - */ -native bool:ReadDirEntry(Handle:dir, String:buffer[], maxlength, &FileType:type=FileType_Unknown); - -/** - * Opens a file. - * @note Files are closed with CloseHandle(). - * @note File Handles can be cloned. - * - * @param file File to open. - * @param mode Open mode. - * @return A Handle to the file, INVALID_HANDLE on open error. - */ -native Handle:OpenFile(const String:file[], const String:mode[]); - -/** - * Deletes a file. - * - * @param path Path of the file to delete. - * @return True on success, false otherwise. - */ -native bool:DeleteFile(const String:path[]); - -/** - * Reads a line from a text file. - * - * @param hndl Handle to the file. - * @param buffer String buffer to hold the line. - * @param maxlength Maximum size of string buffer. - * @return True on success, false otherwise. - */ -native bool:ReadFileLine(Handle:hndl, String:buffer[], maxlength); - -/** - * Tests if the end of file has been reached. - * - * @param file Handle to the file. - * @return True if end of file has been reached, false otherwise. - */ -native bool:IsEndOfFile(Handle:file); - -/** - * Sets the file position indicator. - * - * @param file Handle to the file. - * @param position Position relative to what is specified in whence. - * @param whence Look at the SEEK_* definitions. - * @return True on success, false otherwise. - */ -native bool:FileSeek(Handle:file, position, whence); - -/** - * Get current position in the file. - * - * @param file Handle to the file. - * @return Value for the file position indicator. - */ -native FilePosition(Handle:file); - -/** - * Checks if a file exists. - * - * @param path Path to the file. - * @return True if the file exists, false otherwise. - */ -native bool:FileExists(const String:path[]); - -/** - * Renames a file. - * - * @param newpath New path to the file. - * @param oldpath Path to the existing file. - * @return True on success, false otherwise. - */ -native bool:RenameFile(const String:newpath[], const String:oldpath[]); - -/** - * Checks if a directory exists. - * - * @param path Path to the directory. - * @return True if the directory exists, false otherwise. - */ -native bool:DirExists(const String:path[]); - -/** - * Get the file size in bytes. - * - * @param path Path to the file. - * @return File size in bytes, -1 if file not found. - */ -native FileSize(const String:path[]); - -/** - * Flushes a file's buffered output; any buffered output - * is immediately written to the file. - * - * @param file Handle to the file. - * @return True on success, false on failure. - */ -native FlushFile(Handle:file); - -/** - * Removes a directory. - * @note On most Operating Systems you cannot remove a directory which has files inside it. - * - * @param path Path to the directory. - * @return True on success, false otherwise. - */ -native bool:RemoveDir(const String:path[]); - -/** - * Writes a line of text in a file. - * @note This native will append the newline character. - * - * @param hndl Handle to the file. - * @param format Formatting rules. - * @param ... Variable number of format parameters. - * @return True on success, false otherwise. - */ -native bool:WriteFileLine(Handle:hndl, const String:format[], any:...); - -/** - * Returns a file timestamp as a unix timestamp. - * - * @param file File name. - * @param tmode Time mode. - * @return Time value, or -1 on failure. - */ -native GetFileTime(const String:file[], FileTimeMode:tmode); - -/** - * Same as LogToFile(), except uses an open file Handle. The file must - * be opened in text appending mode. - * - * @param hndl Handle to the file. - * @param message Message format. - * @param ... Message format parameters. - * @noreturn - * @error Invalid Handle. - */ -native LogToOpenFile(Handle:hndl, const String:message[], any:...); - -/** - * Same as LogToFileEx(), except uses an open file Handle. The file must - * be opened in text appending mode. - * - * @param hndl Handle to the file. - * @param message Message format. - * @param ... Message format parameters. - * @noreturn - * @error Invalid Handle. - */ -native LogToOpenFileEx(Handle:hndl, const String:message[], any:...); -