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

FreeBSD Manual Pages

  
 
  

home | help 
al_android_open_fd(3)	    Library Functions Manual	   al_android_open_fd(3)

NAME
     al_android_open_fd - Allegro 5 API

SYNOPSIS
	    #include <allegro5/allegro_android.h>

	    int al_android_open_fd(const char *uri, const char *mode)

DESCRIPTION
     Opens  a  file descriptor to access data under a Universal Resource Identi-
     fier (URI).  This function accepts content:// and file:// URI schemes.  You
     are responsible for closing the returned file descriptor.

     The file mode can be "r", "w", "rw", "wt", "wa" or "rwt".	The exact imple-
     mentation of  these  modes  differ  depending  on	the  underlying  content
     provider.	For example, "w" may or may not truncate.

     Returns  a  file descriptor on success or a negative value on an error.  On
     an error, the Allegro errno is set.

	    Note: Remember to add to your manifest file the relevant permissions
	    to your app.

     Example:

	    const char *content_uri = "content://...";
	    int fd = al_android_open_fd(content_uri, "r");

	    if (fd >= 0) {
		ALLEGRO_FILE *f = al_fopen_fd(fd, "r");

		if (f != NULL) {
		    do_something_with(f);
		    al_fclose(f);
		}
		else {
		    handle_error(al_get_errno());
		    close(fd);
		}
	    }
	    else {
		handle_error(al_get_errno());
	    }

SINCE
     5.2.10

SEE ALSO
     al_fopen_fd(3), al_get_errno(3)

	    [Unstable API]: This API is new and subject to refinement.

Allegro reference manual				   al_android_open_fd(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_android_open_fd&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help