file.h File Reference

#include <stdint.h>
#include <a_util/filesystem.h>
#include <a_util/datetime.h>
#include <a_util/memory.h>
#include <system_error>

Include dependency graph for file.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	utils5ext::exceptions::EndOfFile
	Exception to indicate the end of file was reached. More...
class	utils5ext::exceptions::ErrorFileAccess
	Indicates a file access error. platform dependent errors can be obtained via code(). More...
class	utils5ext::exceptions::ErrorFileAlreadyExists
	Indicates a file access error while creating a file that already exists and File::om_no_overwrite was set. More...
class	utils5ext::File

Namespaces
namespace	utils5ext
namespace	utils5ext::exceptions
	namespace to collect special exceptions for file operations.

Typedefs
using	utils5ext::FilePos = int64_t
	Type for a file position.
using	utils5ext::FileSize = FilePos
	Type for the file size.
typedef int	utils5ext::FileHandle
	The type FileHandle is used internally only.

Functions
a_util::datetime::DateTime	utils5ext::getTimeAccess (const a_util::filesystem::Path filename)
	This function returns the last access time of the file.
a_util::datetime::DateTime	utils5ext::getTimeCreation (const a_util::filesystem::Path filename)
	This function returns the creation time of the file.
a_util::datetime::DateTime	utils5ext::getTimeChange (const a_util::filesystem::Path filename)
	This function returns the last change (write) time of the file.
size_t	utils5ext::getDefaultSectorSize () noexcept
	Get the Default Sector Size.
void *	utils5ext::allocPageAlignedMemory (size_t size, size_t page_size)
	allocates a memory buffer for the size of size (in bytes), page aligned in size to page_size
void	utils5ext::freePageAlignedMemory (void *memory)
	frees the memory buffer allocated with utils5ext::allocPageAlignedMemory
size_t	utils5ext::getSectorSizeFor (const a_util::filesystem::Path &filename) noexcept
	Get the sector size of a file within windows file system.
void	utils5ext::memZero (void *data, size_t bytes)
	Helper function to set a memory buffer to zero.
void	utils5ext::fileRename (const a_util::filesystem::Path &from, const a_util::filesystem::Path &to)
	Renames or moves a file.

Detailed Description

Copyright 2025 Digitalwerk GmbH.

This Source Code Form is subject to the terms of the Mozilla
Public License, v. 2.0. If a copy of the MPL was not distributed
with this file, You can obtain one at https://mozilla.org/MPL/2.0/.

If it is not possible or desirable to put the notice in a particular file, then You may include the notice in a location (such as a LICENSE file in a relevant directory) where a recipient would be likely to look for such a notice.

You may add additional accurate notices of copyright ownership.