/* $DOC$ $AUTHOR$ Copyright 2004 Chen Kedem $TEMPLATE$ Function $NAME$ hb_langErrMsg() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Description of an error code using current language $SYNTAX$ hb_langErrMsg( ) --> cErrorMessage $ARGUMENTS$ is one of the generic error codes (`EG_...`) defined in error.ch $RETURNS$ hb_langErrMsg() return the error message string represented by the code . $DESCRIPTION$ This function return the error message associated with an error code using the current language selected. $EXAMPLES$ #include "error.ch" REQUEST HB_LANG_ES ? "English:", hb_langErrMsg( EG_ARG ) // --> English: Argument error hb_langSelect( "es" ) ? "Spanish:", hb_langErrMsg( EG_ARG ) // --> Spanish: Error de argumento $STATUS$ R $COMPLIANCE$ H $PLATFORMS$ All $FILES$ Header is error.ch $SEEALSO$ hb_langSelect(), NationMsg() $END$ */ /* $DOC$ $AUTHOR$ Copyright 2004 Chen Kedem $TEMPLATE$ Function $NAME$ hb_langMessage() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Returns international strings messages and errors $SYNTAX$ hb_langMessage( [, ] ) --> cMessage $ARGUMENTS$ is the message number to get. is an optional language module ID. Uses the currently selected language module, if not specified. $RETURNS$ hb_langMessage() return the text associated with the code . $DESCRIPTION$ hb_langMessage() is similar to NationMsg() but give access to the whole list of language messages: Day and month names, generic error messages, internal errors, and others... Use the header file hblang.ch for a list of base values for . $EXAMPLES$ #include "hblang.ch" REQUEST HB_LANG_ES ? "English:", hb_langMessage( HB_LANG_ITEM_BASE_DAY + 1 ) // --> English: Monday hb_langSelect( "es" ) ? "Spanish:", hb_langMessage( HB_LANG_ITEM_BASE_DAY + 1 ) // --> Spanish: Lunes ? "English:", hb_langMessage( HB_LANG_ITEM_BASE_DAY + 1, "en" ) $STATUS$ R $COMPLIANCE$ H $PLATFORMS$ All $FILES$ Header is hblang.ch $SEEALSO$ hb_langSelect(), NationMsg(), REQUEST $END$ */ /* $DOC$ $AUTHOR$ Copyright 2000 Luiz Rafael Culik $TEMPLATE$ Function $NAME$ hb_langName() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Return the name of the language module $SYNTAX$ hb_langName( [] ) --> cLangName $ARGUMENTS$ is an optional language module ID. Uses the currently selected language module, if not specified. $RETURNS$ Name of the language module $DESCRIPTION$ This function return the name of the language module in use or specified. $EXAMPLES$ REQUEST HB_LANG_PT REQUEST HB_LANG_RO REQUEST HB_LANG_ES REQUEST HB_LANG_PL ? hb_langName( "pl" ) ? hb_langName( "" ) hb_langSelect( "pt" ) // Default language is now Portuguese ? CDoW( Date() ) // --> Segunda-feira ? "Current language is", hb_langName() // --> Portuguese ? "Old language id selected is", hb_langSelect() // --> pt hb_langSelect( "ro" ) // Default language is now Romanian ? CMonth( Date() ) // --> Mai ? "Old language id selected is", hb_langSelect() // --> ro hb_langSelect( "es" ) // Default language is now Spanish ? "Current language is", hb_langName() // --> Spanish ? CMonth( Date() ) // --> Mayo ? CDoW( Date() ) // --> Lunes $STATUS$ R $COMPLIANCE$ H $PLATFORMS$ All $FILES$ $SEEALSO$ hb_langSelect(), NationMsg() $END$ */ /* $DOC$ $AUTHOR$ Copyright 2000 Luiz Rafael Culik $TEMPLATE$ Function $NAME$ hb_langSelect() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Select a specific nation message module $SYNTAX$ hb_langSelect( [][, ] ) --> cOldLang $ARGUMENTS$ The optional ID of the language module. Possible values for are below as defined in the Lang library, sorted by language. Optional codepage ID into which the language module strings are automatically converted by Harbour. Language Basque eu Belorussian be Bulgarian bg Catalan ca Chinese Traditional zh Chinese Simplified zh_sim Croatian hr Czech cs Dutch nl Esperanto eo French fr Galician gl German de Greek el Hebrew he Hungarian hu Icelandic is Indonesian id Italian it Korean ko Lithuanian lt Polish pl Portuguese pt Romanian ro Russian ru Serbian (cyrillic) sr_cyr Serbian (latin) sr_lat Slovak sk Slovenian sl Spanish es Swedish sv Turkish tr Ukrainian uk
$RETURNS$ The old language identifier $DESCRIPTION$ This function set a default language module for date/month names, internal warnings, NatMsg messages and internal errors. When a Lang ID is selected all messages will be output with the current language selected until another one is selected or the program ends. The default language is English (cLang == "EN"). NOTE: You must REQUEST every language module you intend to use. For example: to use the Portuguese language you must add the following to your program: `REQUEST HB_LANG_PT` $EXAMPLES$ REQUEST HB_LANG_PT REQUEST HB_LANG_RO REQUEST HB_LANG_ES hb_langSelect( "pt" ) // Default language is now Portuguese ? CDoW( Date() ) // --> Segunda-feira ? "Old language id selected is", hb_langSelect() // --> pt hb_langSelect( "ro" ) // Default language is now Romanian ? CMonth( Date() ) // --> Mai ? "Old language id selected is", hb_langSelect() // --> ro hb_langSelect( "es" ) // Default language is now Spanish ? CMonth( Date() ) // --> Mayo ? CDoW( Date() ) // --> Lunes $STATUS$ R $COMPLIANCE$ H $PLATFORMS$ All $FILES$ $SEEALSO$ hb_langName(), hb_cdpSelect(), NationMsg(), REQUEST $END$ */ /* $DOC$ $AUTHOR$ Copyright 2004 Chen Kedem $TEMPLATE$ Function $NAME$ hb_cdpSelect() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Select the active code page by language ID $SYNTAX$ hb_cdpSelect( [] ) --> cOldLang $ARGUMENTS$ The optional ID of the language module. Possible values for are below as defined in the Codepage library, sorted by language. Language Codepage Bulgarian 866 BG866 Bulgarian ISO-8859-5 BGISO Bulgarian MIK BGMIK Bulgarian Windows-1251 BGWIN Croatian 437 HR437 Croatian 852 HR852 Croatian Windows-1250 HRWIN Czech 852 CS852 Czech ISO-8859-2 CSISO Czech KAM CSKAM Czech Windoes-1250 CSWIN English 437 EN French 850 FR850 German 850 DE850 German ISO-8859-1 DEWIN Greek 737 EL737 Greek Windows-1253 ELWIN Hungarian (ntxhu852) 852 HU852C Hungarian (sixhu852) 852 HU852 Hungarian (sixhu852) CWI-2 HUCWI Hungarian ISO-8859-2 HUISO Hungarian Windows-1250 HUWIN Italian 437 IT437 Italian 850 IT850 Italian ISO-8859-1b ITISB Italian ISO-8859-1 ITISO Lithuanian Windows-1257 LTWIN Polish 852 PL852 Polish ISO-8859-2 PLISO Polish Mazowia PLMAZ Polish Windows-1250 PLWIN Portuguese 850 PT850 Portuguese ISO-8859-1 PTISO Russian 866 RU866 Russian KOI-8 RUKOI8 Russian Windows-1251 RU1251 Serbian Windows-1251 SRWIN Slovak 852 SK852 Slovak ISO-8859-2 SKISO Slovak Kamenicky SKKAM Slovak Windows-1250 SKWIN Slovenian 437 SL437 Slovenian 852 SL852 Slovenian ISO-8859-2 SLISO Slovenian Windows-1250 SLWIN Spanish 850 ES850 Spanish ISO-8859-1 ESWIN Spanish Modern ISO-8859-1 ESMWIN Swedish 850 SV850 Swedish (Clipper) 437 SV437C Swedish ISO-8859-1 SVWIN Turkish 857 TR857 Turkish Windows-1254 TRWIN Ukrainian 866 UA866 Ukrainian KOI-8U UAKOI8 Ukrainian Windows-1251 UA1251
$RETURNS$ The old language identifier $DESCRIPTION$ hb_cdpSelect() set the active code page use by Harbour for sorting and comparing strings. The default code page use ASCII order (cLang == "EN"). NOTE: You must REQUEST every code page module you intend to use. For example: to use the French 850 code page you must add the following to your program: `REQUEST HB_CODEPAGE_FR850` $EXAMPLES$ REQUEST HB_CODEPAGE_FR850 hb_cdpSelect( "EN" ) ? hb_cdpSelect() ? hb_UTF8ToStr( "É < G is" ), hb_BChar( 144 ) < "G" // --> É < G is .F. hb_cdpSelect( "FR850" ) ? hb_cdpSelect() ? hb_UTF8ToStr( "É < G is" ), hb_BChar( 144 ) < "G" // --> É < G is .T. $STATUS$ R $COMPLIANCE$ This function is a Harbour Extension. $PLATFORMS$ All $FILES$ $SEEALSO$ hb_langName(), hb_langSelect(), hb_Translate(), NationMsg(), REQUEST $END$ */ /* $DOC$ $AUTHOR$ Copyright 2004 Chen Kedem $TEMPLATE$ Function $NAME$ hb_Translate() $CATEGORY$ API $SUBCATEGORY$ Language and Nation $ONELINER$ Translate a string from one code page to the other $SYNTAX$ hb_Translate( , [], [] ) --> cDstText $ARGUMENTS$ Is the source string to translate. Is the optional character code page ID of the source string. If not specified, the default code page is used. Is the optional character code page ID of the destination string. If not specified, the default code page is used. $RETURNS$ hb_Translate() return destination string converted from the source string. $DESCRIPTION$ hb_Translate() try to convert a source string from one code page into the other. If a code page ID is not recognized, or not linked in, the default code page is used. hb_Translate() is used usually to convert between the MS-DOS and the Windows code pages of the same language. NOTE: If the source code page and target code page does not have the same number of characters, a translation cannot be done and the destination string is a copy of the source string. NOTE: You must REQUEST every code page module you intend to use. For example: to use the CP-850 code page you must add the following to your program: `#include "hbextcdp.ch"` $EXAMPLES$ #include "hbextcdp.ch" LOCAL cTxt := "A" + hb_BChar( 142 ) + "BC" ? "CP-850 text:", hb_StrToHex( cTxt ) ? "UTF-8 text:", hb_Translate( cTxt, "cp850", "UTF8" ) $STATUS$ R $COMPLIANCE$ This function is a Harbour Extension. $PLATFORMS$ All $FILES$ $SEEALSO$ hb_langSelect(), hb_cdpSelect(), NationMsg(), REQUEST $END$ */