Section 3: library functions
NAME get_framenum_subset64 — perform a reverse look-up on a monotonic dirfile field SYNOPSIS #define _LARGEFILE64_SOURCE #include <getdata.h> double get_framenum_subset64(DIRFILE *dirfile, const char *field_code, double value, off64_t field_start, off64_t field_end); DESCRIPTION This version of get_framenum_subset(3) uses a 64-bit offset type, even if off_t is a 32-bit type. It is only available if one defines _LARGEFILE64_SOURCE. If…
NAME get_framenum_subset, get_framenum — perform a reverse look-up on a monotonic dirfile field SYNOPSIS #include <getdata.h> double get_framenum_subset(DIRFILE *dirfile, const char *field_code, double value, off_t field_start, off_t field_end); double get_framenum(DIRFILE *dirfile, const char *field_code, double value); DESCRIPTION The get_framenum_subset() function queries a dirfile(5) database specified by dirfile and returns the fractional frame number at which…
NAME get_fragmentname — retrieve a dirfile format file fragment name SYNOPSIS #include <getdata.h> const char* get_fragmentname(const DIRFILE *dirfile, int index); DESCRIPTION The get_fragmentname() function queries a dirfile(5) database specified by dirfile and returns the filename of the format file fragment indexed by the non-negative index. The dirfile argument must point to a valid DIRFILE object…
NAME get_fragment_index — retrieve the fragment containing a dirfile field SYNOPSIS #include <getdata.h> int get_fragment_index(const DIRFILE *dirfile, const char *field_code); DESCRIPTION The get_fragment_index() function queries a dirfile(5) database specified by dirfile and returns the index number of the fragment defining the field specified by field_code. If field_code contains a representation suffix, it will be ignored….
NAME get_font_ranges – Returns the number of character ranges in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_ranges(FONT *f) DESCRIPTION Use this function to find out the number of character ranges in a font. You should query each of these ranges with get_font_range_begin() and get_font_range_end() to find out what characters are available…
NAME get_font_range_end – Returns the last character of a character range in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_range_end(FONT *f, int range) DESCRIPTION This function allows you to find out the index to the last character of a character range for a font. You can pass -1 for the range parameter…
NAME get_font_range_begin – Returns the start of a character range in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_range_begin(FONT *f, int range) DESCRIPTION This function allows you to find out the start of a specific character range for a font. You can pass -1 for the `range’ parameter if you want to…
NAME get_filename – Returns a pointer to the filename portion of a path. Allegro game programming library. SYNOPSIS #include <allegro.h> char *get_filename(const char *path); DESCRIPTION Finds out the filename portion of a completely specified file path. Both `\’ and `/’ are recognized as directory separators under DOS and Windows. However, only `/’ is recognized as…
NAME get_field_list_by_type — retrieve a list of fields in a dirfile SYNOPSIS #include <getdata.h> const char **get_field_list_by_type(DIRFILE *dirfile, gd_entype_t type); DESCRIPTION The get_field_list_by_type() function queries a dirfile(5) database specified by dirfile and returns a read-only list of names of the all fields of the indicated type which are defined in the database. Notably, this list…
NAME get_field_list — retrieve a list of fields in a dirfile SYNOPSIS #include <getdata.h> const char **get_field_list(DIRFILE *dirfile); DESCRIPTION The get_field_list() function queries a dirfile(5) database specified by dirfile and returns a read-only list of names of the all fields defined in the database. Notably, this list does not include /META subfields. The dirfile argument…
NAME get_extension – Returns a pointer to the extension of a filename. Allegro game programming library. SYNOPSIS #include <allegro.h> char *get_extension(const char *filename); DESCRIPTION Finds out the extension of the filename (with or without path information). Example: get_executable_name(name, sizeof(name)); allegro_message(“The binary has the extension `%s’ “, get_extension(name)); RETURN VALUE Returns a pointer to the portion…
NAME get_executable_name – Obtains the full path to the current executable. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_executable_name(char *buf, int size); DESCRIPTION Fills `buf’ with the full path to the current executable, writing at most `size’ bytes. This generally comes from `argv[0]’ but on Unix systems it tries to get the information from…
NAME get_error_string — report a getdata library error SYNOPSIS #include <getdata.h> char *get_error_string(const DIRFILE *dirfile, char *buffer, size_t buflen); DESCRIPTION The get_error_string() function returns a string describing the last dirfile error encountered while operating on dirfile. The string is written to the user-supplied buffer buffer. At most buflen characters will be written. This always includes…
NAME get_error — report a getdata library error SYNOPSIS #include <getdata.h> int get_error(const DIRFILE *dirfile); DESCRIPTION The get_error() function returns the numeric dirfile error associated with the dirfile dirfile which is set by many GetData library functions. The dirfile argument should point to a DIRFILE object previously created by a call to dirfile_open(3). A textual…
NAME get_entry_type — retrieve the type of a dirfile field SYNOPSIS #include <getdata.h> gd_entype_t get_entry_type(const DIRFILE *dirfile, const char *field_code); DESCRIPTION The get_entry_type() function queries a dirfile(5) database specified by dirfile and returns the field type of the field specified by field_code. If field_code contains a valid representation suffix, it will be ignored. The gd_entype_t…
NAME get_entry — retrieve a dirfile field’s metadata SYNOPSIS #include <getdata.h> int get_entry(DIRFILE *dirfile, const char *field_code, gd_entry_t *entry); DESCRIPTION The get_entry() function queries a dirfile(5) database specified by dirfile and returns the metadata associated with the field specified by field_code. If field_code contains a valid representation suffix, the suffix will be ignored. The dirfile…
NAME get_endianness — report the byte sex of fields in a dirfile SYNOPSIS #include <getdata.h> unsigned long get_endianness(DIRFILE *dirfile, int fragment_index); DESCRIPTION The get_endianness() function queries a dirfile(5) database specified by dirfile and returns the byte sex for the fragment indexed by fragment_index. The byte sex of a fragment indicate the endianness of data stored…
NAME get_encoding — report the binary encoding of data in a dirfile SYNOPSIS #include <getdata.h> unsigned long get_encoding(DIRFILE *dirfile, int fragment_index); DESCRIPTION The get_encoding() function queries a dirfile(5) database specified by dirfile and returns the binary encoding for the fragment indexed by fragment_index. The binary encoding of a fragment indicate the encoding of data stored…
NAME get_desktop_resolution – Finds out the desktop resolution. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_desktop_resolution(int *width, int *height); DESCRIPTION Finds out the currently selected desktop resolution. You can use this information to avoid creating windows bigger than the current resolution. This is especially important for some windowed drivers which are unable to create…
NAME get_ordered_context_list, get_ordered_context_list_with_level, get_default_context, get_default_context_with_level, get_default_context_with_role, get_default_context_with_rolelevel, query_user_context, manual_user_enter_context, get_default_role – determine SELinux context(s) for user sessions SYNOPSIS #include <selinux/selinux.h> #include <selinux/get_context_list.h> int get_ordered_context_list(const char *user, char *fromcon, char ***list); int get_ordered_context_list_with_level(const char *user, const char *level, char *fromcon, char ***list); int get_default_context(const char *user, char *fromcon, char **newcon); int get_default_context_with_level(const char *user, const char…