summaryrefslogtreecommitdiffstats
path: root/kdejava/koala/org/kde/koala/KLocale.java
blob: beaf5dc4974b30042c419dc0389ad4f02f86d3e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
//Auto-generated by kalyptus. DO NOT EDIT.
package org.kde.koala;

import org.kde.qt.Qt;
import org.kde.qt.QtSupport;
import java.util.Calendar;
import java.util.ArrayList;
import org.kde.qt.TQTextCodec;
import java.util.Date;

/**

 KLocale provides support for country specific stuff like
 the national language.
 KLocale supports translating, as well as specifying the format
 for numbers, currency, time, and date.
		@author Stephan Kulow <coolo@kde.org>, Preston Brown <pbrown@kde.org>,
 Hans Petter Bieker <bieker@kde.org>, Lukas Tinkl <lukas.tinkl@suse.cz>

		@short class for supporting locale settings and national language.

*/
public class KLocale implements QtSupport {
	private long _qt;
	private boolean _allocatedInJavaWorld = true;
	protected KLocale(Class dummy){}

	/**	
		 Various positions for where to place the positive or negative
		 sign when they are related to a monetary value.
		   		@short    Various positions for where to place the positive or negative  sign when they are related to a monetary value.
	*/
	public static final int ParensAround = 0;
	public static final int BeforeQuantityMoney = 1;
	public static final int AfterQuantityMoney = 2;
	public static final int BeforeMoney = 3;
	public static final int AfterMoney = 4;

	public static final int NormalFormat = 1;
	public static final int ShortFormat = 2;

	public static final int WithSeconds = 0;
	public static final int WithoutSeconds = 1;

	/**	
		 The Metric system will give you information in mm, while the
		 Imperial system will give you information in inches.
		   		@short    The Metric system will give you information in mm, while the  Imperial system will give you information in inches.
	*/
	public static final int Metric = 0;
	public static final int Imperial = 1;

	/**	
		 Constructs a KLocale with the given catalog name.
		 The constructor looks for an entry Locale/Language in the
		 configuration file.
		 If no config file is specified, it will also look for languages
		 using the environment variables (KDE_LANG, LC_MESSAGES, LC_ALL, LANG),
		 as well as the global configuration file. If KLocale is not able to use
		 any of the specified languages, the default language (en_US) will be
		 used.
			 If you specify a configuration file, it has to be valid until
		 the KLocale object is destroyed.
			@param catalog The name of the main language file
			@param config The configuration file to use.
		   		@short    Constructs a KLocale with the given catalog name.
	*/
	public KLocale(String catalog, KConfig config) {
		newKLocale(catalog,config);
	}
	private native void newKLocale(String catalog, KConfig config);
	public KLocale(String catalog) {
		newKLocale(catalog);
	}
	private native void newKLocale(String catalog);
	/**	
		 Copy constructor.
		   		@short    Copy constructor.
	*/
	public KLocale(KLocale rhs) {
		newKLocale(rhs);
	}
	private native void newKLocale(KLocale rhs);
	/**	
		 Translates the string into the corresponding string in
		 the national language, if available. If not, returns
		 the string itself.
		 There is a KDE wide message file that contains the most
		 often used phrases, so we can avoid duplicating the
		 translation of these phrases. If a phrase is not found
		 in the catalog given to the constructor, it will search
		 in the system catalog. This makes it possible to override
		 some phrases for your needs.
			 The argument must be an UTF-8 encoded string (If you only use
		 characters that are in US-ASCII you're on the safe side. But
		 for e.g. german umlauts or french accents should be recoded to
		 UTF-8)
			@param index The lookup text and default text, if not found.
		   		@short    Translates the string into the corresponding string in  the national language, if available.
	*/
	public native String translate(String index);
	/**	
		 Translates the string into the corresponding string in the
		 national language, if available.
			 The real contents of the string is in the argument fallback,
		 but the meaning of it is coded into the argument index.
		 In some cases you'll need this function, when english is
		 too ambiguous to express it.
			 Most of the times the translators will tell you if it can't
		 be translated as it, but think of cases as "New", where the
		 translations differs depending on what is New.
		 Or simple cases as "Open", that can be used to express something
		 is open or it can be used to express that you want something to
		 open... There are tons of such examples.
			 If translate("Open") is not enough to translate it well, use
		 translate("To Open", "Open") or translate("Is Open", "Open").
		 The english user will see "Open" in both cases, but the translated
		 version may vary. Of course you can also use i18n()
			@param comment the comment. The lookup text is made out of comment + <code>fallback</code>
			@param fallback the default text, if not found
				@return translation
   
		@short    Translates the string into the corresponding string in the  national language, if available.
	*/
	public native String translate(String comment, String fallback);
	/**	
		 Used to get the correct, translated singular or plural of a
		 word.
			@param singular the singular form of the word, for example "file".
			@param plural the plural form of the word. Must contain a "%n" that will
		               be replaced by the number <code>n</code>, for example "%n files"
			@param n the number
				@return the correct singular or plural for the selected language,
         depending on n
   
		@short    Used to get the correct, translated singular or plural of a  word.
	*/
	public native String translate(String singular, String plural, long n);
	/**	
		 Changes the current encoding.
			@param mibEnum The mib of the preferred codec
				@return True on success.
   
		@short    Changes the current encoding.
	*/
	public native boolean setEncoding(int mibEnum);
	/**	
		 Changes the current language. The current language will be left
		 unchanged if failed. It will force a reload of the country specific
		 configuration as well.
			@param language The language code.
				@return True on success.
   
		@short    Changes the current language.
	*/
	public native boolean setLanguage(String language);
	/**	
		 Changes the list of prefed languages for the locale. The first valid
		 language in the list will be used, or the default (en_US) language
		 will be used if non of the specified languages were available.
			@param languages The list of language codes.
				@return True if one of the specified languages were used.
   
		@short    Changes the list of prefed languages for the locale.
	*/
	public native boolean setLanguage(String[] languages);
	/**	
		 Changes the current country. The current country will be left
		 unchanged if failed. It will force a reload of the country specific
		 configuration.
			@param country The ISO 3166 country code.
				@return True on success.
   
		@short    Changes the current country.
	*/
	public native boolean setCountry(String country);
	/**	
		 Returns what a decimal point should look like ("." or "," etc.)
		 according to the current locale or user settings.
				@return The decimal symbol used by locale.
   
		@short    Returns what a decimal point should look like (".
	*/
	public native String decimalSymbol();
	/**	
		 Returns what the thousands separator should look
		 like ("," or "." etc.)
		 according to the current locale or user settings.
				@return The thousands separator used by locale.
   
		@short    Returns what the thousands separator should look  like ("," or ".
	*/
	public native String thousandsSeparator();
	/**	
		 Returns what the symbol denoting currency in the current locale
		 as as defined by user settings should look like.
				@return The default currency symbol used by locale.
   
		@short    Returns what the symbol denoting currency in the current locale  as as defined by user settings should look like.
	*/
	public native String currencySymbol();
	/**	
		 Returns what a decimal point should look like ("." or "," etc.)
		 for monetary values, according to the current locale or user
		 settings.
				@return The monetary decimal symbol used by locale.
   
		@short    Returns what a decimal point should look like (".
	*/
	public native String monetaryDecimalSymbol();
	/**	
		 Returns what a thousands separator for monetary values should
		 look like ("," or " " etc.) according to the current locale or
		 user settings.
				@return The monetary thousands separator used by locale.
   
		@short    Returns what a thousands separator for monetary values should  look like ("," or " " etc.
	*/
	public native String monetaryThousandsSeparator();
	/**	
		 Returns what a positive sign should look like ("+", " ", etc.)
		 according to the current locale or user settings.
				@return The positive sign used by locale.
   
		@short    Returns what a positive sign should look like ("+", " ", etc.
	*/
	public native String positiveSign();
	/**	
		 Returns what a negative sign should look like ("-", etc.)
		 according to the current locale or user settings.
				@return The negative sign used by locale.
   
		@short    Returns what a negative sign should look like ("-", etc.
	*/
	public native String negativeSign();
	/**	
		 The number of fractional digits to include in numeric/monetary
		 values (usually 2).
				@return Default number of fractional digits used by locale.
   
		@short    The number of fractional digits to include in numeric/monetary  values (usually 2).
	*/
	public native int fracDigits();
	/**	
		 If and only if the currency symbol precedes a positive value,
		 this will be true.
				@return Where to print the currency symbol for positive numbers.
   
		@short    If and only if the currency symbol precedes a positive value,  this will be true.
	*/
	public native boolean positivePrefixCurrencySymbol();
	/**	
		 If and only if the currency symbol precedes a negative value,
		 this will be true.
				@return True if the currency symbol precedes negative numbers.
   
		@short    If and only if the currency symbol precedes a negative value,  this will be true.
	*/
	public native boolean negativePrefixCurrencySymbol();
	/**	
		 Returns the position of a positive sign in relation to a
		 monetary value.
				@return Where/how to print the positive sign.

		@short    Returns the position of a positive sign in relation to a  monetary value.
		@see SignPosition
	*/
	public native int positiveMonetarySignPosition();
	/**	
		 Denotes where to place a negative sign in relation to a
		 monetary value.
				@return Where/how to print the negative sign.

		@short    Denotes where to place a negative sign in relation to a  monetary value.
		@see SignPosition
	*/
	public native int negativeMonetarySignPosition();
	/**	
		 Given a double, converts that to a numeric string containing
		 the localized monetary equivalent.
			 e.g. given 123456, return "$ 123,456.00".
			@param num The number we want to format
			@param currency The currency symbol you want.
			@param digits Number of fractional digits, or -1 for the default
		               value
				@return The number of money as a localized string

		@short    Given a double, converts that to a numeric string containing  the localized monetary equivalent.
		@see #fracDigits
	*/
	public native String formatMoney(double num, String currency, int digits);
	public native String formatMoney(double num, String currency);
	public native String formatMoney(double num);
	/**	
		 Given a double, converts that to a numeric string containing
		 the localized numeric equivalent.
			 e.g. given 123456.78F, return "123,456.78" (for some European country).
		 If precision isn't specified, 2 is used.
			 This function is a wrapper that is provided for convenience.
			@param num The number to convert
			@param precision Number of fractional digits used.
				@return The number as a localized string

		@short    Given a double, converts that to a numeric string containing  the localized numeric equivalent.
		@see #formatNumber(const
		@see #boolean
		@see #int)
	*/
	public native String formatNumber(double num, int precision);
	public native String formatNumber(double num);
	/**	
		 Given a string representing a number, converts that to a numeric
		 string containing the localized numeric equivalent.
			 e.g. given 123456.78F, return "123,456.78" (for some European country).
			@param numStr The number to convert
			@param round Round  fractional digits.
			@param precision Number of fractional digits used.
				@return The number as a localized string

		@short    Given a string representing a number, converts that to a numeric  string containing the localized numeric equivalent.
	*/
	public native String formatNumber(String numStr, boolean round, int precision);
	/**	
		 Given an integer, converts that to a numeric string containing
		 the localized numeric equivalent.
			 e.g. given 123456L, return "123,456" (for some European country).
			@param num The number to convert
				@return The number as a localized string

		@short    Given an integer, converts that to a numeric string containing  the localized numeric equivalent.
	*/
	public native String formatLong(long num);
	/**	
		 Use this to determine whether nouns are declined in
		 locale's language. This property should remain
		 read-only (no setter function)
				@return If nouns are declined

		@short    Use this to determine whether nouns are declined in  locale's language.
	*/
	public native boolean nounDeclension();
	/**	
		 Returns a string formatted to the current locale's conventions
		 regarding dates.
			@param pDate The date to be formated.
			@param shortFormat True for non text dates.
				@return The date as a string
   
		@short    Returns a string formatted to the current locale's conventions  regarding dates.
	*/
	public native String formatDate(Calendar pDate, boolean shortFormat);
	public native String formatDate(Calendar pDate);
	/**	
		 Use this to determine whether in dates a possessive form of month
		 name is preferred ("of January" rather than "January")
				@return If possessive form should be used

		@short    Use this to determine whether in dates a possessive form of month  name is preferred ("of January" rather than "January")
	*/
	public native boolean dateMonthNamePossessive();
	/**	
		 Returns a string formatted to the current locale's conventions
		 regarding times.
			@param pTime The time to be formated.
			@param includeSecs if true, seconds are included in the output,
		        otherwise only hours and minutes are formatted.
			@param isDuration if true, the given time is a duration, not a clock time.
		 This means "am/pm" shouldn't be displayed.
				@return The time as a string
   
		@short    Returns a string formatted to the current locale's conventions  regarding times.
	*/
	public native String formatTime(Date pTime, boolean includeSecs, boolean isDuration);
	/**	
		 Returns a string formatted to the current locale's conventions
		 regarding times.
			@param pTime The time to be formated.
			@param includeSecs if true, seconds are included in the output,
		        otherwise only hours and minutes are formatted.
				@return The time as a string
   
		@short    Returns a string formatted to the current locale's conventions  regarding times.
	*/
	public native String formatTime(Date pTime, boolean includeSecs);
	public native String formatTime(Date pTime);
	/**	
		 Use this to determine if the user wants a 12 hour clock.
				@return If the user wants 12h clock
   
		@short    Use this to determine if the user wants a 12 hour clock.
	*/
	public native boolean use12Clock();
	/**	
		 Use this to determine which day is the first day of the week.
				@return an integer (Monday=1..Sunday=7)

		@short    Use this to determine which day is the first day of the week.
	*/
	public native int weekStartDay();
	/**	
		 Returns a pointer to the calendar system object.
				@return the current calendar system instance

		@short    Returns a pointer to the calendar system object.
	*/
	public native KCalendarSystem calendar();
	/**	
		 Returns the name of the calendar system that is currently being
		 used by the system.
				@return the name of the calendar system

		@short    Returns the name of the calendar system that is currently being  used by the system.
	*/
	public native String calendarType();
	/**	
		 Changes the current calendar system to the calendar specified.
		 Currently "gregorian" and "hijri" are supported. If the calendar
		 system specified is not found, gregorian will be used.
			@param calendarType the name of the calendar type
				@short    Changes the current calendar system to the calendar specified.
	*/
	public native void setCalendar(String calendarType);
	/**	
		 Returns a string formated to the current locale's conventions
		 regarding both date and time.
			@param pDateTime The date and time to be formated.
			@param shortFormat using the short date format.
			@param includeSecs using the short date format.
				@return The date and time as a string
   
		@short    Returns a string formated to the current locale's conventions  regarding both date and time.
	*/
	public native String formatDateTime(Calendar pDateTime, boolean shortFormat, boolean includeSecs);
	public native String formatDateTime(Calendar pDateTime, boolean shortFormat);
	public native String formatDateTime(Calendar pDateTime);
	/**	
		 Converts a localized monetary string to a double.
			@param numStr the string we want to convert.
			@param ok the booleanean that is set to false if it's not a number.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a double
   
		@short    Converts a localized monetary string to a double.
	*/
	public native double readMoney(String numStr, boolean[] ok);
	public native double readMoney(String numStr);
	/**	
		 Converts a localized numeric string to a double.
			@param numStr the string we want to convert.
			@param ok the booleanean that is set to false if it's not a number.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a double
   
		@short    Converts a localized numeric string to a double.
	*/
	public native double readNumber(String numStr, boolean[] ok);
	public native double readNumber(String numStr);
	/**	
		 Converts a localized date string to a Calendar.
		 The boolean pointed by ok will be invalid if the date entered was not valid.
			@param str the string we want to convert.
			@param ok the booleanean that is set to false if it's not a valid date.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a TQDate
   
		@short    Converts a localized date string to a TQDate.
	*/
	public native Calendar readDate(String str, boolean[] ok);
	public native Calendar readDate(String str);
	/**	
		 Converts a localized date string to a Calendar, using the specified format.
		 You will usually not want to use this method.
		   		@short    Converts a localized date string to a TQDate, using the specified format.
	*/
	public native Calendar readDate(String intstr, String fmt, boolean[] ok);
	public native Calendar readDate(String intstr, String fmt);
	/**	
		 Converts a localized date string to a Calendar.
		 This method is stricter than readDate(str,&ok): it will either accept
		 a date in full format or a date in short format, depending on <code>flags.</code>
			@param str the string we want to convert.
			@param flags whether the date string is to be in full format or in short format.
			@param ok the booleanean that is set to false if it's not a valid date.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a TQDate

		@short    Converts a localized date string to a TQDate.
	*/
	public native Calendar readDate(String str, int flags, boolean[] ok);
	public native Calendar readDate(String str, int flags);
	/**	
		 Converts a localized time string to a Date
		 This method will try to parse it with seconds, then without seconds.
		 The boolean pointed to by <code>ok</code> will be set to false if the time entered was 
		 not valid.
			@param str the string we want to convert.
			@param ok the booleanean that is set to false if it's not a valid time.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a TQTime
   
		@short    Converts a localized time string to a TQTime.
	*/
	public native Date readTime(String str, boolean[] ok);
	public native Date readTime(String str);
	/**	
		 Converts a localized time string to a Date
		 This method is stricter than readTime(str,&ok): it will either accept
		 a time with seconds or a time without seconds.
		 Use this method when the format is known by the application.
			@param str the string we want to convert.
			@param flags whether the time string is expected to contain seconds or not.
			@param ok the booleanean that is set to false if it's not a valid time.
		           If <code>ok</code> is 0, it will be ignored
				@return The string converted to a TQTime

		@short    Converts a localized time string to a TQTime.
	*/
	public native Date readTime(String str, int flags, boolean[] ok);
	public native Date readTime(String str, int flags);
	/**	
		 Returns the language used by this object. The domain AND the
		 library translation must be available in this language.
		 defaultLanguage() is returned by default, if no other available.
				@return The currently used language.
   
		@short    Returns the language used by this object.
	*/
	public native String language();
	/**	
		 Returns the country code of the country where the user lives.
		 defaultCountry() is returned by default, if no other available.
				@return The country code for the user.
   
		@short    Returns the country code of the country where the user lives.
	*/
	public native String country();
	/**	
		 Returns the preferred languages as ISO 639-1 codes. This means
		 that information about country is removed. If the internal language
		 code might be represented by more than one 639-1 code, they will all be
		 listed (but only once).
			 If the selected languages are "nn, nb, pt_BR", you will get:
		 "nn, nb, pt".
				@return List of language codes

		@short    Returns the preferred languages as ISO 639-1 codes.
		@see #languageList
	*/
	public native ArrayList languagesTwoAlpha();
	/**	
		 Returns the languages selected by user. The codes returned here is the
		 internal language codes.
				@return List of language codes

		@short    Returns the languages selected by user.
		@see #languagesTwoAlpha
	*/
	public native ArrayList languageList();
	/**	
		 Returns the user's preferred encoding.
				@return The name of the preferred encoding

		@short    Returns the user's preferred encoding.
		@see #codecForEncoding
		@see #encodingMib
	*/
	public native String encoding();
	/**	
		 Returns the user's preferred encoding.
				@return The Mib of the preferred encoding

		@short    Returns the user's preferred encoding.
		@see #encoding
		@see #codecForEncoding
	*/
	public native int encodingMib();
	/**	
		 Returns the user's preferred encoding. Should never be NULL.
				@return The codec for the preferred encoding

		@short    Returns the user's preferred encoding.
		@see #encoding
		@see #encodingMib
	*/
	public native TQTextCodec codecForEncoding();
	/**	
		 Returns the file encoding.
				@return The Mib of the file encoding

		@short    Returns the file encoding.
		@see org.kde.qt.TQFile#encodeName
		@see org.kde.qt.TQFile#decodeName
	*/
	public native int fileEncodingMib();
	/**	
		 Changes the current date format.
			 The format of the date is a string which contains variables that will
		 be replaced:
		
			<li>
			%Y with the century (e.g. "19" for "1984")
			</li>
			
			<li>
			%y with the lower 2 digits of the year (e.g. "84" for "1984")
			</li>
			
			<li>
			%n with the month (January="1", December="12")
			</li>
			
			<li>
			%m with the month with two digits (January="01", December="12")
			</li>
			
			<li>
			%e with the day of the month (e.g. "1" on the first of march)
			</li>
			
			<li>
			%d with the day of the month with two digits(e.g. "01" on the first of march)
			</li>
			
			<li>
			%b with the short form of the month (e.g. "Jan" for January)
			</li>
			
			<li>
			%B with the long form of the month (e.g. "January")
			</li>
			
			<li>
			%a with the short form of the weekday (e.g. "Wed" for Wednesday)
			</li>
			
			<li>
			%A with the long form of the weekday (e.g. "Wednesday" for Wednesday)
			 Everything else in the format string will be taken as is.
			 For example, March 20th 1989 with the format "%y:%m:%d" results
			 in "89:03:20".
			</li>
				@param format The new date format
		   		@short    Changes the current date format.
	*/
	public native void setDateFormat(String format);
	/**	
		 Changes the current short date format.
			 The format of the date is a string which contains variables that will
		 be replaced:
		
			<li>
			%Y with the century (e.g. "19" for "1984")
			</li>
			
			<li>
			%y with the lower 2 digits of the year (e.g. "84" for "1984")
			</li>
			
			<li>
			%n with the month (January="1", December="12")
			</li>
			
			<li>
			%m with the month with two digits (January="01", December="12")
			</li>
			
			<li>
			%e with the day of the month (e.g. "1" on the first of march)
			</li>
			
			<li>
			%d with the day of the month with two digits(e.g. "01" on the first of march)
			</li>
			
			<li>
			%b with the short form of the month (e.g. "Jan" for January)
			</li>
			
			<li>
			%B with the long form of the month (e.g. "January")
			</li>
			
			<li>
			%a with the short form of the weekday (e.g. "Wed" for Wednesday)
			</li>
			
			<li>
			%A with the long form of the weekday (e.g. "Wednesday" for Wednesday)
			 Everything else in the format string will be taken as is.
			 For example, March 20th 1989 with the format "%y:%m:%d" results
			 in "89:03:20".
			</li>
				@param format The new short date format
		   		@short    Changes the current short date format.
	*/
	public native void setDateFormatShort(String format);
	/**	
		 Changes the form of month name used in dates.
			@param possessive True if possessive forms should be used
				@short    Changes the form of month name used in dates.
	*/
	public native void setDateMonthNamePossessive(boolean possessive);
	/**	
		 Changes the current time format.
			 The format of the time is string a which contains variables that will
		 be replaced:
		
			<li>
			%H with the hour in 24h format and 2 digits (e.g. 5pm is "17", 5am is "05")
			</li>
			
			<li>
			%k with the hour in 24h format and one digits (e.g. 5pm is "17", 5am is "5")
			</li>
			
			<li>
			%I with the hour in 12h format and 2 digits (e.g. 5pm is "05", 5am is "05")
			</li>
			
			<li>
			%l with the hour in 12h format and one digits (e.g. 5pm is "5", 5am is "5")
			</li>
			
			<li>
			%M with the minute with 2 digits (e.g. the minute of 07:02:09 is "02")
			</li>
			
			<li>
			%S with the seconds with 2 digits  (e.g. the minute of 07:02:09 is "09")
			</li>
			
			<li>
			%p with pm or am (e.g. 17.00 is "pm", 05.00 is "am")
			 Everything else in the format string will be taken as is.
			 For example, 5.23pm with the format "%H:%M" results
			 in "17:23".
			</li>
				@param format The new time format
		   		@short    Changes the current time format.
	*/
	public native void setTimeFormat(String format);
	/**	
		 Changes how KLocale defines the first day in week.
			@param day first day of the week (Monday=1..Sunday=7) as integer
				@short    Changes how KLocale defines the first day in week.
	*/
	public native void setWeekStartDay(int day);
	/**	
		 Returns the currently selected date format.
				@return Current date format.

		@short    Returns the currently selected date format.
		@see #setDateFormat
	*/
	public native String dateFormat();
	/**	
		 Returns the currently selected short date format.
				@return Current short date format.

		@short    Returns the currently selected short date format.
		@see #setDateFormatShort
	*/
	public native String dateFormatShort();
	/**	
		 Returns the currently selected time format.
				@return Current time format.

		@short    Returns the currently selected time format.
		@see #setTimeFormat
	*/
	public native String timeFormat();
	/**	
		 Changes the symbol used to identify the decimal pointer.
			@param symbol The new decimal symbol.
		   		@short    Changes the symbol used to identify the decimal pointer.
	*/
	public native void setDecimalSymbol(String symbol);
	/**	
		 Changes the separator used to group digits when formating numbers.
			@param separator The new thousands separator.
		   		@short    Changes the separator used to group digits when formating numbers.
	*/
	public native void setThousandsSeparator(String separator);
	/**	
		 Changes the sign used to identify a positive number. Normally this is
		 left blank.
			@param sign Sign used for positive numbers.
		   		@short    Changes the sign used to identify a positive number.
	*/
	public native void setPositiveSign(String sign);
	/**	
		 Changes the sign used to identify a negative number.
			@param sign Sign used for negative numbers.
		   		@short    Changes the sign used to identify a negative number.
	*/
	public native void setNegativeSign(String sign);
	/**	
		 Changes the sign position used for positive monetary values.
			@param signpos The new sign position
		   		@short    Changes the sign position used for positive monetary values.
	*/
	public native void setPositiveMonetarySignPosition(int signpos);
	/**	
		 Changes the sign position used for negative monetary values.
			@param signpos The new sign position
		   		@short    Changes the sign position used for negative monetary values.
	*/
	public native void setNegativeMonetarySignPosition(int signpos);
	/**	
		 Changes the position where the currency symbol should be printed for
		 positive monetary values.
			@param prefix True if the currency symbol should be prefixed instead of
		 postfixed
		   		@short    Changes the position where the currency symbol should be printed for  positive monetary values.
	*/
	public native void setPositivePrefixCurrencySymbol(boolean prefix);
	/**	
		 Changes the position where the currency symbol should be printed for
		 negative monetary values.
			@param prefix True if the currency symbol should be prefixed instead of
		 postfixed
		   		@short    Changes the position where the currency symbol should be printed for  negative monetary values.
	*/
	public native void setNegativePrefixCurrencySymbol(boolean prefix);
	/**	
		 Changes the number of digits used when formating numbers.
			@param digits The default number of digits to use.
		   		@short    Changes the number of digits used when formating numbers.
	*/
	public native void setFracDigits(int digits);
	/**	
		 Changes the separator used to group digits when formating monetary values.
			@param separator The new thousands separator.
		   		@short    Changes the separator used to group digits when formating monetary values.
	*/
	public native void setMonetaryThousandsSeparator(String separator);
	/**	
		 Changes the symbol used to identify the decimal pointer for monetary
		 values.
			@param symbol The new decimal symbol.
		   		@short    Changes the symbol used to identify the decimal pointer for monetary  values.
	*/
	public native void setMonetaryDecimalSymbol(String symbol);
	/**	
		 Changes the current currency symbol.
			@param symbol The new currency symbol
		   		@short    Changes the current currency symbol.
	*/
	public native void setCurrencySymbol(String symbol);
	/**	
		 Returns the preferred page size for printing.
				@return The preferred page size, cast it to TQPrinter.PageSize
   
		@short    Returns the preferred page size for printing.
	*/
	public native int pageSize();
	/**	
		 Changes the preferred page size when printing.
			@param paperFormat the new preferred page size in the format TQPrinter.PageSize
		   		@short    Changes the preferred page size when printing.
	*/
	public native void setPageSize(int paperFormat);
	/**	
		 Returns which measuring system we use.
				@return The preferred measuring system
   
		@short    Returns which measuring system we use.
	*/
	public native int measureSystem();
	/**	
		 Changes the preferred measuring system.
				@return value The preferred measuring system
   
		@short    Changes the preferred measuring system.
	*/
	public native void setMeasureSystem(int value);
	/**	
		 Adds another catalog to search for translation lookup.
		 This function is useful for extern libraries and/or code,
		 that provide there own messages.
			 If the catalog does not exist for the chosen language,
		 it will be ignored and en_US will be used.
			@param catalog The catalog to add.
		   		@short    Adds another catalog to search for translation lookup.
	*/
	public native void insertCatalogue(String catalog);
	/**	
		 Removes a catalog for translation lookup.
			@param catalog The catalog to remove.
				@short    Removes a catalog for translation lookup.
		@see #insertCatalogue
	*/
	public native void removeCatalogue(String catalog);
	/**	
		 Sets the active catalog for translation lookup.
			@param catalog The catalog to activate.
		   		@short    Sets the active catalog for translation lookup.
	*/
	public native void setActiveCatalogue(String catalog);
	/**	
		 Translates a message as a TQTranslator is supposed to.
		 The parameters are similar to i18n(), but the result
		 value has other semantics (it can be null)
				@short    Translates a message as a TQTranslator is supposed to.
	*/
	public native String translateQt(String context, String sourceText, String message);
	/**	
		 Returns list of all known ISO 639-1 codes.
				@return a list of all language codes

		@short    Returns list of all known ISO 639-1 codes.
	*/
	public native ArrayList allLanguagesTwoAlpha();
	/**	
		 Convert a ISO 639-1 code to a human readable form.
			@param code the language ISO 639-1 code
				@return the human readable form

		@short    Convert a ISO 639-1 code to a human readable form.
	*/
	public native String twoAlphaToLanguageName(String code);
	/**	
		 Returns list of all known country codes.
				@return a list of all country codes

		@short    Returns list of all known country codes.
	*/
	public native ArrayList allCountriesTwoAlpha();
	/**	
		 Convert a country code to a human readable form.
			@param code the country code
				@return the human readable form of the country name

		@short    Convert a country code to a human readable form.
	*/
	public native String twoAlphaToCountryName(String code);
	/**	
		 Returns the parts of the parameter str understood as language setting
		 the format is language_COUNTRY.charset
			@param str The string to split.
			@param language This will be set to the language part of the string.
			@param country This will be set to the country part of the string.
			@param charset This will be set to the charset part of the string.
		   		@short    Returns the parts of the parameter str understood as language setting  the format is language_COUNTRY.
	*/
	public static native void splitLocale(String str, StringBuffer language, StringBuffer country, StringBuffer charset);
	/**	
		 Use this as main catalog for all KLocales, if not the appname
		 will be used. This function is best to be the very first instruction
		 in your program's main function as it only has an effect before the
		 first KLocale object is created.
			@param catalog Catalogue to override all other main catalogues.
		   		@short    Use this as main catalog for  all  KLocales, if not the appname  will be used.
	*/
	public static native void setMainCatalogue(String catalog);
	/**	
		 Finds localized resource in resourceDir( rtype ) + \<lang> + fname.
			@param fname relative path to find
			@param rtype resource type to use
		   		@short    Finds localized resource in resourceDir( rtype ) + \<lang> + fname.
	*/
	public static native String langLookup(String fname, String rtype);
	public static native String langLookup(String fname);
	/**	
		 Returns the name of the internal language.
				@return Name of the default language
   
		@short    Returns the name of the internal language.
	*/
	public static native String defaultLanguage();
	/**	
		 Returns the name of the default country.
				@return Name of the default country
   
		@short    Returns the name of the default country.
	*/
	public static native String defaultCountry();
	/**	
			   		@short
	*/
	public static native String _initLanguage(KConfigBase config);
	/**	
			 pointer.
		   		@short
	*/
	protected static native void initInstance();
	/** Deletes the wrapped C++ instance */
	protected native void finalize() throws InternalError;
	/** Delete the wrapped C++ instance ahead of finalize() */
	public native void dispose();
	/** Has the wrapped C++ instance been deleted? */
	public native boolean isDisposed();
}