totalcross.sys
Settings
This class provides some preferences from the device configuration and other VM settings. All settings are read-only, unless otherwise specified. Changing their values may cause the VM to crash. Look at its JavaDoc for more details.
VM
Vm contains various system-level methods. This class contains methods to copy arrays, obtain a timestamp, sleep, and get platform and version information, among many other things. Look at its JavaDoc for more details.
Time
The Time class stores a specific a date and time.
The year must have 4 digits
The hour is numbered in 24-hour notation, which is the international standard notation of time, and may also be referred as military time or astronomical time.
For performance reasons, the Time fields have public access. So you can directly access the field day to get or set its value, instead of calling a method. However, that makes the Time objects unsafe because the fields’ values are not checked when they are set, and may not be within the field valid range.
Since the fields can be set without any kind of validation, it would be pointless to add validation to the other methods, therefore, the Time fields’ values are never validated by any method or constructor. So you must know and always respect the fields’ range, and never set a field with a variable without first checking if the value is withing range (for instance, let the user type the hour in an edit and simply convert it to int and set the hour field, without checking if its value is between 0 and 23).
The Time fields with their respective range:
year: The year in 4 digits;
month: The month in the range of 1 to 12;
day: The day in the range of 1 to the last day of the specified month;
hour: The hour in the range of 0 to 23;
minute: The minute in the range of 0 to 59;
second: The second in the range of 0 to 59;
millis: Milliseconds in the range of 0 to 999;
Time has a constant called SECONDS_PER_DAY, which obviously represents the number of seconds in a day, being equal to 24 * 3600.
Constructors
Time has six constructors:
Time(): Default constructor, creates a Time object set with the device’s current date and time. Most devices do not keep track of the milliseconds, therefore, the field millis of the new object will always have the default value 0 on them.
Time(int year, int month, int day, int hour, int minute, int second, int millis): Creates a Time object with the given values.
Time(long t): Creates a Time object from the given value, which must be in the format YYYYMMDDHHMMSS.
Time(int yyyymmdd, int hhmmssmmm): Constructs a Time object from the given date and time values.
Time(String iso8601): Creates a Time object using the given string, which must be in the ISO8601 format: YYYYMMDDTHH:MM:SS.
Please notice the last three constructors do not include the milliseconds, so the field millis will keep its default value 0.
Time(String time, boolean hasYear, boolean hasMonth, boolean hasDay, boolean hasHour, boolean hasMinute, boolean hasSeconds): Constructs a Time object, parsing the string and placing the fields depending on the flags that were set, using Settings.timeSeparator as spliter. The number of parts must match the number of true flags, or an
ArrayIndexOutOfBoundsException
will be thrown. AM/PM is supported.
Remember: no kind of validation is done on the Time fields values, not even on the constructors. However, the default constructor will never initialize an object with invalid values, and the last two constructors may throw an InvalidNumberException if it fails to parse the given string.
Methods
Finally, Time has the following methods:
update()
: Updates the internal fields with the current timestamp.quals(Object o)
: Compares two Time objects for equality. The result is true if and only if the argument is not null and it’s a Time object that represents the same point in time, from year to millisecond, as this object.getTimeLong()
: Converts this Time object to a long value in the format YYYYMMDDHHMMSS. Milliseconds is not included.YYYYMMDDHHMMSS. Milliseconds is not included.toIso8601()
: Converts this Time object to a string in the ISO8601 format: YYYYMMDDTHH:MM:SS. Milliseconds is not included.toString()
: Returns the time in format specified in totalcross.sys.Settings (does NOT include the date neither the milliseconds). To return the date, use the class totalcross.util.Date. So, to get a string with the date and time, use:Time t = new Time();
String dateAndTime = new Date(t) + " " + t;
toString(String timeSeparator)
: Similar to the above method except that it uses the specified separator.dump(StringBuffer sb, String timeSeparator, boolean includeMillis)
: Dumps the time into the given StringBuffer, using the given separator and including the millileconds if asked by the user.isValid()
: Returns true if the time is valid. Note that the date part is NOT checked; only hour, minute, second, and millis are checked against valid ranges.inc(int hours, int minutes, int seconds)
: Increments or decrements the fields below. Note that this method does NOT update the day/month/year fields. The parameters can be positive (to increment), zero (to keep it), or negative (to decrement).
CharacterConvert
This class is used to correctly handle international character conversions. The default character scheme converter is the 8859-1 (ISO Latin 1).
If you want to use a different one, you must extend this class, implementing the bytes2chars()
and chars2bytes()
methods, and then assign the public member of Convert.charConverter
to use your class instead of this default one. You can also use the method Convert.setDefaultConverter()
to change it, passing, as parameter, the prefix of your CharacterConverter class (better look at the implementation to know what to pass on).
For example, if you created a class named Iso88592CharacterConverter, call
To find out which sun.io.CharacterEncoder
you’re using on JDK to implement an equivalent version for TotalCross, use:
UTF8CharacterConvert
This class extends the CharacterConvert class, and implements the UTF8 byte to UCS-2 character conversion. To use this class, you can call:
Convert
Convert basically provides methods that allows object and basic type conversion. Furthermore, it also provides handy methods for common operations that should be used for a better performance.
This class is final and cannot be instantiated – its methods and fields are static.
To give you a better view of this class, its documentation was split into sub-sections:
Changing the default character converter
The field charConverter keeps a reference to a character converter that will be used by default. You may change it by setting another character converter of your choice.
You may also use the method setDefaultConverter(String name)
, which searches for a character converter by its name, and makes it the default by changing the charConverter field. Use like
to change all bytes_to_char and char_to_bytes
operations to use UTF8 instead. Issuing
sets back the default encoder. The method returns true if the given encoder was found; false, otherwise. If not found, the encoder is reseted to the default one (ISO 8859-1).
Conversion between String and basic types
Character, String and StringBuffer utilities
The class StringBuffer does not have a method that returns its hash code, so you would have to first create a String from the StringBuffer to get its hash code, like this:
int hashCode = sb.toString.hashCode();
Use the previous method instead for better performance:
toLowerCase(char c)
: Converts the given char to lower case.toUpperCase(char c)
: Converts the given char to upper case.zeroPad(String s, int size)
: Pads the string, adding zeros at left.zeroUnpad(String s)
: Removes left zeros of the string.
Arrays
Convert provides the quick sort algorithm for array sorting.
Constants
SORT_AUTODETECT - Chooses between one of the sort types below based on the first element of the array.
SORT_OBJECT - The objects are compared by their string representation.
SORT_STRING - The array contains String objects, and the sort is case sensitive.
SORT_INT - The array contains String objects that represents integer values.
SORT_DOUBLE - The array contains String objects that represents double values.
SORT_DATE - The array contains String objects that represents a Date object with day, month, and year.
SORT_COMPARABLE - The array contains comparable objects (objects that implements the Comparable interface).
SORT_STRING_NOCASE - The array contains String objects, and the sort is case insensitive, which is slower than case sensitive sorting.
Methods
qsort(Object[] items, int first, int last) - Applies the quick sort algorithm to the elements of the given array, sorting in ascending order and sort type equals to SORT_AUTODETECT.
qsort(Object[] items, int first, int last, int sortType) - Same as the above method, but you can specify the sort type.
qsort(Object[] items, int first, int last, int sortType, boolean ascending) - Same as the above, but you can also choose between sorting in ascending or descending order.
Other Conversions and Methods
chars2int(String fourChars) - Converts a creator id or type to int.
int2chars(int i) - Converts an int to a creator id or type.
doubleToIntBits(double f) - Converts the given double to its bit representation in IEEE 754 format, using 4 bytes instead of 8 (a conversion to float is applied).
intBitsToDouble(int i) - Converts the given IEEE 754 bit representation of a float to a double.
doubleToLongBits(double value) - Returns a representation of the specified floating-point value according to the IEEE 754 floating-point "double format" bit layout.
longBitsToDouble(long bits) - Converts the given bit representation to a double.
rol(long i, int n, int bits) - Does a rol of n bits in the given long. n must be < bits. Unlike the shift left operator (<<), bits that would have been lost are reinserted in order at the right.
ror(long i, int n, int bits) - Does a ror of n bits in the given long. n must be < bits. Unlike the shift right operator (>>), bits that would have been lost are reinserted in order at the left.
Another Useful Constants
Last updated