get_datafile_property(3alleg)

get_datafile_property3alleg

Returns the property string for the object. allegro game programming library.

Usage

#include <allegro.h>

const char *get_datafile_property(const DATAFILE *dat, int type);

Overview

Finds the property type of a DATAFILE object. The type parameter must be a value created with the DAT_ID() macro. Example:

   const char *name;
   ...
   name = get_datafile_property(game_data,
                                DAT_ID('N','A','M','E'));
   if (name == empty_string)
      abort_on_error("Object doesn't have a name!");

Return value

Returns a pointer to the text string for the object, or a pointer to the variable empty_string if the property isn't present.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.