.\" Generated by the Allegro makedoc utility
.TH find_datafile_object 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
find_datafile_object \- Searches a datafile for an object with a name. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B DATAFILE *find_datafile_object(const DATAFILE *dat, const char *objectname);
.SH DESCRIPTION
Searches an already loaded datafile for an object with the specified 
name. In the name you can use `/' and `#' separators for nested datafile
paths. Example:

.nf
   char level_name[10];
   DATAFILE *dat, *level;
   ...
   uszprintf(level_name, sizeof(buffer),
             "LEVEL_%02d", level_number);
   level = find_datafile_object(dat, level_name);
   if (!level)
      abort_on_error("That level doesn't exist!");
.fi
.SH "RETURN VALUE"
Returns a pointer to a single DATAFILE element whose `dat' member points to
the object, or NULL if the object could not be found.

.SH SEE ALSO
.BR load_datafile (3alleg4),
.BR load_datafile_object (3alleg4)