get_text()

Get message text

Syntax

get_text(message_ID)

Parameter

ParameterDefinition

message_ID

text string that identifies a message

Description

The get_text() function returns a message that has a text string as the message ID. The dget_text() and dcget_text() functions serve the same purpose, but you cannot use get_text() to specify the domain name or locale category. For locale category, get_text() uses the MESSAGES category as the current locale. For domain, get_text uses the domain of the current locale. You can set this domain by using the text_domain() function. See text_domain()

The domain_name and category determine the name of the catalog file and the directory path according to the following format: 

PATROL_HOME/lib/nls/locale/ locale_name/ML_ category/ domain_name.bo 

The get_text() function returns message_ID when it cannot find a message that matches the relevant message_ID, domain_name and category. It also returns message_ID when the current locale is the same as the CTYPE category.

This function provides support for internationalized PSL scripts. For more information about internationalization, see Internationalized PSL Scripts.

Example

The following is an example of the get_text() function.

function display_get_text(msg)
{
ret = get_text(msg);
printf("Message = %s \n", ret);
}
display_get_text("hello");


Was this page helpful? Yes No Submitting... Thank you

Comments