Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_fopen_slice(3)					     al_fopen_slice(3)

NAME
       al_fopen_slice -	Allegro	5 API

SYNOPSIS
	      #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 han-
       dle must	not be used in any way.

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

       Seeking	with  ALLEGRO_SEEK_SET will be relative	to this	starting loca-
       tion.  ALLEGRO_SEEK_END will be relative	to the starting	location  plus
       the size	of the slice.

       The mode	can be any combination of:

       o r: read access

       o w: write access

       o 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.  Oth-
       erwise, 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)

Allegro	reference manual				     al_fopen_slice(3)

NAME | SYNOPSIS | DESCRIPTION | SINCE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=al_fopen_slice&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help