Files
harbour-core/doc/en/langall.txt
Viktor Szakats 03ac58b17b 2017-09-08 18:22 UTC Viktor Szakats (vszakats users.noreply.github.com)
* bin/commit.hb
  * config/detect.mk
  * config/detfun.mk
  * config/detplat.mk
  * config/dir.mk
  * config/dirsh.mk
  * config/global.mk
  * config/globsh.mk
  * config/instsh.mk
  * config/lang.hb
  * config/lang2po.hb
  * config/po2lang.hb
  * config/postinst.hb
  * contrib/hbexpat/tests/tohash.prg
  * contrib/hbformat/utils/hbformat.ini
  * contrib/hbmisc/hbedit.prg
  * contrib/hbmxml/tests/testmxml.prg
  * contrib/hbnetio/utils/hbnetio/_console.prg
  * contrib/hbnetio/utils/hbnetio/_winsvc.prg
  * contrib/hbnetio/utils/hbnetio/hbnetio.prg
  * contrib/hbnetio/utils/hbnetio/netiomgm.hb
  * contrib/hbwin/tests/ole.prg
  * contrib/hbwin/tests/oletst2.js
  * contrib/hbwin/tests/oletst2.vbs
  * contrib/hbxpp/doc/en/binnumx.txt
  * contrib/hbxpp/doc/en/dbcmdx.txt
  * contrib/xhb/htmutil.prg
  * contrib/xhb/tfile.prg
  * contrib/xhb/tframe.prg
  * contrib/xhb/thtm.prg
  * ChangeLog.txt
  * debian/copyright
  * doc/class_tp.txt
  * doc/hdr_tpl.txt
  * doc/xhb-diff.txt
  * LICENSE.txt
  * package/harbour-wce.spec.in
  * package/harbour-win.spec.in
  * package/harbour.spec
  * package/mpkg_rpm_wce.sh
  * package/mpkg_rpm_win.sh
  * package/mpkg_rpm.sh
  * package/mpkg_src.sh
  * package/mpkg_ver.sh
  * src/rtl/achoice.prg
  * src/rtl/getsys53.prg
  * src/rtl/tgetlist.prg
  * src/rtl/tlabel.prg
  * src/rtl/tmenusys.prg
  * tests/hbdoc.prg
  * tests/langmsg.prg
  * tests/rto_get.prg
  * tests/rto_tb.prg
  + doc/en/ati.txt
  + doc/en/dirdrive.txt
  + doc/en/hashfunc.txt
  + doc/en/hbtoken.txt
  + doc/en/left.txt
  + doc/en/proc.txt
  + doc/en/strtran.txt
  + doc/en/transfrm.txt
  + doc/en/typefile.txt
  * doc/en/*
    * more partial sync with 3.4 fork
2017-09-08 18:25:11 +00:00

406 lines
13 KiB
Plaintext

/* $DOC$
$AUTHOR$
Copyright 2004 Chen Kedem <niki@actcom.co.il>
$TEMPLATE$
Function
$NAME$
hb_langErrMsg()
$CATEGORY$
API
$SUBCATEGORY$
Language and Nation
$ONELINER$
Description of an error code using current language
$SYNTAX$
hb_langErrMsg( <nErrorCode> ) --> cErrorMessage
$ARGUMENTS$
<nErrorCode> is one of the generic error codes (`EG_...`) defined
in error.ch
$RETURNS$
hb_langErrMsg() return the error message string represented by
the code <nErrorCode>.
$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 <niki@actcom.co.il>
$TEMPLATE$
Function
$NAME$
hb_langMessage()
$CATEGORY$
API
$SUBCATEGORY$
Language and Nation
$ONELINER$
Returns international strings messages and errors
$SYNTAX$
hb_langMessage( <nMsg>[, <cLangID>] ) --> cMessage
$ARGUMENTS$
<nMsg> is the message number to get.
<cLangID> 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 <nMsg>.
$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 <nMsg>.
$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 <culik@sl.conex.net>
$TEMPLATE$
Function
$NAME$
hb_langName()
$CATEGORY$
API
$SUBCATEGORY$
Language and Nation
$ONELINER$
Return the name of the language module
$SYNTAX$
hb_langName( [<cLangID>] ) --> cLangName
$ARGUMENTS$
<cLangID> is an optional language module ID. Uses the currently
selected language module, if not specified.
$RETURNS$
<cLangName> 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( "<non-existent>" )
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 <culik@sl.conex.net>
$TEMPLATE$
Function
$NAME$
hb_langSelect()
$CATEGORY$
API
$SUBCATEGORY$
Language and Nation
$ONELINER$
Select a specific nation message module
$SYNTAX$
hb_langSelect( [<cNewLang>][, <cCodepage>] ) --> cOldLang
$ARGUMENTS$
<cNewLang> The optional ID of the language module.
Possible values for <cNewLang> are below as defined in the
Lang library, sorted by language.
<cCodepage> Optional codepage ID into which the language
module strings are automatically converted by Harbour.
<table>
Language <cNewLang>
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
</table>
$RETURNS$
<cOldLang> 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 <niki@actcom.co.il>
$TEMPLATE$
Function
$NAME$
hb_cdpSelect()
$CATEGORY$
API
$SUBCATEGORY$
Language and Nation
$ONELINER$
Select the active code page by language ID
$SYNTAX$
hb_cdpSelect( [<cNewLang>] ) --> cOldLang
$ARGUMENTS$
<cNewLang> The optional ID of the language module.
Possible values for <cNewLang> are below as defined in the
Codepage library, sorted by language.
<table>
Language Codepage <cNewLang>
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
</table>
$RETURNS$
<cOldLang> 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 <niki@actcom.co.il>
$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( <cSrcText>, [<cPageFrom>], [<cPageTo>] ) --> cDstText
$ARGUMENTS$
<cSrcText> Is the source string to translate.
<cPageFrom> Is the optional character code page ID of the source
string. If not specified, the default code page is used.
<cPageTo> 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$
*/