GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_FOPEN_SLICE (3)

NAME

al_fopen_slice - Allegro 5 API

CONTENTS

Synopsis
Description
Since
See Also

SYNOPSIS

C]
#include <allegro5/allegro.h>

ALLEGRO_FILE *al_fopen_slice(ALLEGRO_FILE *fp, size_t initial_size, const char *mode) ]

DESCRIPTION

Opens a slice (subset) of an already open random access file as if it were a stand alone file. While the slice is open, the parent file handle must not be used in any way.

The slice is opened at the current location of the parent file, up through C]initial_size] bytes. The C]initial_size] may be any non-negative integer that will not exceed the bounds of the parent file.

Seeking with C]ALLEGRO_SEEK_SET] will be relative to this starting location. C]ALLEGRO_SEEK_END] will be relative to the starting location plus the size of the slice.

The mode can be any combination of:
[bu] r: read access
[bu] w: write access
[bu] e: expandable
For example, a mode of "rw" indicates the file can be read and written. (Note that this is slightly different from the stdio modes.) Keep in mind that the parent file must support random access and be open in normal write mode (not append) for the slice to work in a well defined way.

If the slice is marked as expandable, then reads and writes can happen after the initial end point, and the slice will grow accordingly. Otherwise, all activity is restricted to the initial size of the slice.

A slice must be closed with al_fclose(3). The parent file will then be positioned immediately after the end of the slice.

SINCE

5.0.6, 5.1.0

SEE ALSO

al_fopen(3)

Search for    or go to Top of page |  Section 3 |  Main Index


Allegro reference manual AL_FOPEN_SLICE (3)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.