GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GET_CONFIG_TEXT (3)

NAME

get_config_text - Returns a string translated to the current language. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

const char *get_config_text(const char *msg);

DESCRIPTION

This function is primarily intended for use by internal library code, but it may perhaps be helpful to application programmers as well. It uses the ‘language.dat’ or ‘XXtext.cfg’ files (where XX is a language code) to look up a translated version of the parameter in the currently selected language.

This is basically the same thing as calling get_config_string() with ‘[language]’ as the section, ‘msg’ as the variable name, and ‘msg’ as the default value, but it contains some special code to handle Unicode format conversions. The ‘msg’ parameter is always given in ASCII format, but the returned string will be converted into the current text encoding, with memory being allocated as required, so you can assume that this pointer will persist without having to manually allocate storage space for each string.

Note that if you are planning on distributing your game on the Unix platform there is a special issue with how to deal with the ‘language.dat’ file. Read section "Files shared by Allegro" of the chapter "Unix specifics" to learn more about this.

RETURN VALUE

Returns a suitable translation if one can be found or a copy of the parameter if nothing else is available.

SEE ALSO

get_config_string(3), reload_config_texts(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro GET_CONFIG_TEXT (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.