Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 8

AlGetEntry()

Get an entry from a language or message database

Synopsis:

#include <photon/Al.h>

const AlTextEntry_t *AlGetEntry(
                         AlDataBase_t const *db,
                         unsigned n );

Arguments:

db
A pointer to a AlDataBase_t structure for the database, returned by AlOpenDBase().
n
The number of the record to return.

Library:

phexlib

Description:

AlGetEntry() returns the nth record from the language or message database specified by db.

The AlTextEntry_t structure contains at least the following members:

unsigned long res_flags
Bits include:
const char *wgt_name
The widget name or message tag.
unsigned long res_value
The resource (0 for messages).
const char *res_descr
A description of the resource or message.
unsigned long res_index
For list items, it's the index (starting from 0); otherwise, 0.
const char *str_original
The original message/resource.
const char *str_translated
The translated message/resource (initially NULL).

Returns:

A pointer to the record retrieved, or NULL if there isn't a record corresponding to n.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

AlClearTranslation(), AlCloseDBase(), AlGetSize(), AlOpenDBase(), AlReadTranslation(), AlSaveTranslation(), AlSetEntry(), ApCloseMessageDB(), ApGetMessage(), ApLoadMessageDB()

International Language Support chapter of the Photon Programmer's Guide


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 178

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/al/algetentry.html on line 178