Documentation of SFML 2.5.1

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
sf::FileInputStream Class Reference

Implementation of input stream based on a file. More...

#include <FileInputStream.hpp>

Inheritance diagram for sf::FileInputStream:
sf::InputStream sf::NonCopyable

Public Member Functions

 FileInputStream ()
 Default constructor. More...
virtual ~FileInputStream ()
 Default destructor. More...
bool open (const std::string &filename)
 Open the stream from a file path. More...
virtual Int64 read (void *data, Int64 size)
 Read data from the stream. More...
virtual Int64 seek (Int64 position)
 Change the current reading position. More...
virtual Int64 tell ()
 Get the current reading position in the stream. More...
virtual Int64 getSize ()
 Return the size of the stream. More...

Detailed Description

Implementation of input stream based on a file.

This class is a specialization of InputStream that reads from a file on disk.

It wraps a file in the common InputStream interface and therefore allows to use generic classes or functions that accept such a stream, with a file on disk as the data source.

In addition to the virtual functions inherited from InputStream, FileInputStream adds a function to specify the file to open.

SFML resource classes can usually be loaded directly from a filename, so this class shouldn't be useful to you unless you create your own algorithms that operate on an InputStream.

Usage example:

void process(InputStream& stream);
if ("some_file.dat"))

InputStream, MemoryInputStream

Definition at line 55 of file FileInputStream.hpp.

Constructor & Destructor Documentation

◆ FileInputStream()

sf::FileInputStream::FileInputStream ( )

Default constructor.

◆ ~FileInputStream()

virtual sf::FileInputStream::~FileInputStream ( )

Default destructor.

Member Function Documentation

◆ getSize()

virtual Int64 sf::FileInputStream::getSize ( )

Return the size of the stream.

The total number of bytes available in the stream, or -1 on error

Implements sf::InputStream.

◆ open()

bool sf::FileInputStream::open ( const std::string &  filename)

Open the stream from a file path.

filenameName of the file to open
True on success, false on error

◆ read()

virtual Int64 sf::FileInputStream::read ( void *  data,
Int64  size 

Read data from the stream.

After reading, the stream's reading position must be advanced by the amount of bytes read.

dataBuffer where to copy the read data
sizeDesired number of bytes to read
The number of bytes actually read, or -1 on error

Implements sf::InputStream.

◆ seek()

virtual Int64 sf::FileInputStream::seek ( Int64  position)

Change the current reading position.

positionThe position to seek to, from the beginning
The position actually sought to, or -1 on error

Implements sf::InputStream.

◆ tell()

virtual Int64 sf::FileInputStream::tell ( )

Get the current reading position in the stream.

The current position, or -1 on error.

Implements sf::InputStream.

The documentation for this class was generated from the following file: