libraryjs

About

A lightweight JavaScript and TypeScript utility library - just import and use. No configuration required.

LibraryJS provides many built-in utility functions for common development tasks. If you need additional functionality, feel free to open an issue or submit a feature request.

Installation & Requirements

Requirements

• Node.js 18 or higher
• TypeScript 5 or higher (only required if you use TypeScript)

Install

$ npm install @uoctamika/libraryjs

Or install a specific version:

$ npm install @uoctamika/libraryjs@latest

or

$ npm install @uoctamika/libraryjs@1.0.0

Documentation

For the best experience, please read the documentation before using this library.

If you come from a high-level development background, some parts of the API may feel unusual at first. However, if you have experience with C or C++, many design choices should feel familiar.

namespace

stdio - standard input output, provide a function for I/O things

Input Output (stdio)

printf

NAME

stdio.printf — formatted output function.

SYNOPSIS

import { stdio } from '@uoctamika/libraryjs';

const {stdio } = require('@uoctamika/libraryjs');

stdio.printf(format: string, ...args: any[]): void;

DESCRIPTION

The "printf()" function writes formatted output to "stdout" (standard output).

The format string consists of ordinary characters and conversion specifiers. Ordinary characters are copied directly to the output stream, while conversion specifiers begin with "%" and are replaced with formatted argument values.

Supported conversion specifiers:

Specifier	Description	Example Input	Output
%s	String value	"world"	"world"
%d	Decimal integer	42	"42"
%i	Integer (parsed from input)	"42px"	"42"
%f	Floating-point number (6 decimal places)	3.14159	"3.141590"
%c	Character (first character of string)	"ABC"	"A"
%o	Object (default string representation)	{a:1}	"[object Object]"
%O	Object (full inspection, unlimited depth)	{a:{b:2}}	"{ a: { b: 2 } }"
%x	Hexadecimal (lowercase)	255	"ff"
%X	Hexadecimal (uppercase)	255	"FF"
%b	Binary	5	"101"
%j	JSON stringify	{name:"Uoc"}	"{\"name\":\"Uoc\"}"
%%	Literal percent sign	-	"%"

Behavior for invalid arguments:

Specifier	Invalid Input Behavior
%d	Returns "NaN" when the value is not a valid integer
%i	Returns "NaN" when no integer can be parsed from the input
%f	Returns "NaN" when the value is not a valid number
%c	Returns an empty string ("") when the input string is empty
%o	Returns "[object Object]" for non-null values using default object conversion
%O	Returns a string representation of the value, including nested structures
%x	Returns "NaN" when the value cannot be converted to an integer
%X	Returns "NaN" when the value cannot be converted to an integer
%b	Returns "NaN" when the value cannot be converted to an integer
%j	Returns "undefined" when JSON serialization fails or the value cannot be serialized

RETURN VALUE

This function returns no value ("void").

Output is written directly to "stdout" using "process.stdout.write()".

Unlike "console.log()", "printf()" does not automatically append a newline character. To print a new line, explicitly include "\n" in the format string.

EXAMPLE

stdio.printf("Hello %s!\n", "World");
stdio.printf("Age: %d\n", 18);
stdio.printf("PI: %f\n", 3.14159);
stdio.printf("Grade: %c\n", "A");

Contributing

Contributions are welcome.

Before contributing, please read the following documents:

• "README.md"
• "SECURITY.md"
• "CODE_OF_CONDUCT.md"

We appreciate all bug reports, feature requests, documentation improvements, and pull requests.