🌀Miscellaneous APIs
Other inner workings that don't fit with the inner essentials and might be useful for your mods
In addition to the essential APIs that are provided with the Nitrocid kernel that allow you to make awesome mods ranging from simple ones to the most complicated ones, Nitrocid provides some of the useful APIs that don't fit with the category but can be helpful when developing mods.
The following APIs can be used in your mods:
Integer tools
The Reflection
part of the kernel contains a class, IntegerTools
, that consists of useful integer tools from short numbers to 128-bit integer numbers to double-precision numbers, like converting literal file sizes in bytes to their human formats.
In addition to that, we've also placed useful extensions, such as converting the number of all kinds, short or long, to different number bases as strings, such as:
ToBinary()
ToOctal()
ToNumber()
ToHex()
File size conversion
SizeString()
extension functions can be used when importing the Reflection
namespace. This allows you to easily convert the file sizes from bytes to their human-readable format.
You can use these functions, once the above namespace is imported, like this:
You can't use this function for enormous sizes, like 1 zettabytes, because of the limitation of the long integers. However, you shouldn't worry about this situation, since this is used generally for file sizes, and a single file in the world hasn't reached this size yet.
Time tools
Nitrocid KS provides you with various APIs that allow you to manage time and date and their components. Here are the following tools that you can use:
Time zones
Nitrocid KS provides a built-in timezone API that allows you to get information about a timezone and convert the time to the equivalent time using the specific timezone.
This API is found in the TimeZones
class.
If the kernel-wide time zone is enabled, the current kernel time and date changes, depending on your selected kernel-wide time zone. Otherwise, the kernel uses the operating system time and date.
One of the functions that the above class implements is GetZoneTimeString()
and its sibling functions, GetZoneTimeTimeString()
and GetZoneTimeDateString()
.
The first function returns the full date and time using the specified time zone.
The second function returns the time using the specified time zone.
The third function returns the date using the specified time zone.
Calendar management API
In addition to providing the calendar command in the addon, the base Nitrocid API provides some of the calendar management APIs to make access to them easier than before. You can now get the calendar straight from the calendar type or its name using the GetCalendar()
function from the CalendarTools
class.
Additionally, the time and date renderers can be used with the base calendar class instance obtained from the above function.
While the events can be configured to be a yearly event, such as the Nitrocid KS release anniversary, such events have to be created by hand until the event commands are updated.
Date conversion API
Nitrocid API provides date conversion tools that allow you to change how the date and the time are being represented. For instance, you can translate the date and the time to UNIX time and vice versa.
As for the calendars, you can use the GetDateFromCalendar()
function, provided that you have a calendar instance from the GetCalendar()
function.
Alternatively, you can use the GetDateFromCalendarNoCulture()
function for calendars with overridden Calendar
property.
Properties and Fields
The Reflection
part of the Nitrocid API provides you with options to access public properties and fields that are declared in the public classes dynamically.
PropertyManager
manages properties, such as getting and setting property values.FieldManager
manages fields, such as getting and setting field values.
In addition to the functions available in the above two classes, you can get all fields and properties defined in all the kernel types using the following functions:
GetAllFields()
GetAllFieldsNoEvaluation()
GetAllProperties()
GetAllPropertiesNoEvaluation()
Kernel version information
You can get the kernel version information using the following properties from the KernelMain
class:
Version
: Gets the kernel version without the build specifiersVersionFull
: Gets the kernel version with the build specifiers (essentially the same as the GitHub tag for the release)ApiVersion
: Gets the kernel API version.
Writing to the console
The Writers
namespace of the Nitrocid-specific ConsoleBase
namespace contains the following three writer types:
TextWriters
: Provides you with all the normal console writers with kernel color types.TextFancyWriters
: Provides you with all the fancy writers with kernel color types.TextMiscWriters
: Provides you with all the miscellaneous writers with kernel color types.
If you want to either plainly write text or with a custom color of your choice, consult the Terminaux guide for more information:
Resetting colors
If you need to reset the colors for further text to be written to the console in its natural colors, you can use the ResetColors()
function in the ConsoleTools
class to reset the foreground and the background colors to their defaults.
Additionally, if you pass true
to the useKernelColors
parameter, the colors will be reset to the neutral text color for the foreground color and the kernel background color for the background color.
Alarms
When it comes to alarms, they are useful to alarm you for something at a specified time. This service and its tools can be accessed via the AlarmTools
class.
You can start an alarm using the StartAlarm()
function that lets you specify your alarm ID, your alarm name, and your alarm interval in seconds.
Additionally, you can stop an alarm before it's up using a function defined below:
Array tools
The array tools class provides you a wide range of tools for manipulating with arrays, such as array randomization, array sorting, and more.
To randomize arrays, the below two functions that do exactly the same thing under different implementations are available:
RandomizeArray()
: Uses the Schwartzian transform to randomly sort the array.
You can consult the Nitrocid API Reference for more array tools.
JSON Difference
The JSON difference finding tool can be accessed using the FindDifferences()
function found in the JsonTools
class. This allows you to find differences in addition and deletion of any JSON object. The difference tool returns the difference in the following format:
A JSON object with either a plus (
+
), an asterisk (*
), or a minus (-
) sign if the target object is an object.A JSON object with either a plus (
+
) or a minus (-
) sign listing differences in addition and deletion of array elements if the target object is an array.A JSON object with a plus (
+
) sign indicating the target object and a minus (-
) sign indicating the source object.
Last updated