From ef7f9bead82e73ff3efd4577a20e5170b017a859 Mon Sep 17 00:00:00 2001 From: Amlal El Mahrouss Date: Mon, 12 Jan 2026 20:54:09 +0100 Subject: chore: Nectar Generics Library improvements. Signed-off-by: Amlal El Mahrouss --- include/LibNectarCore/.gitignore | 1 + include/LibNectarCore/__abi.h | 24 +++++++++ include/LibNectarCore/__power64.inc | 40 ++++++++++++++ include/LibNectarCore/base_alloc.h | 43 +++++++++++++++ include/LibNectarCore/base_exception.h | 35 ++++++++++++ include/LibNectarCore/base_math.h | 98 ++++++++++++++++++++++++++++++++++ include/LibNectarCore/base_process.h | 44 +++++++++++++++ include/LibNectarCore/defines.h | 80 +++++++++++++++++++++++++++ include/LibNectarCore/filesystem.h | 18 +++++++ include/LibNectarCore/mkhdrs.sh | 15 ++++++ include/LibNectarCore/new.h | 65 ++++++++++++++++++++++ include/LibNectarCore/utility.h | 27 ++++++++++ 12 files changed, 490 insertions(+) create mode 100644 include/LibNectarCore/.gitignore create mode 100644 include/LibNectarCore/__abi.h create mode 100644 include/LibNectarCore/__power64.inc create mode 100644 include/LibNectarCore/base_alloc.h create mode 100644 include/LibNectarCore/base_exception.h create mode 100644 include/LibNectarCore/base_math.h create mode 100644 include/LibNectarCore/base_process.h create mode 100644 include/LibNectarCore/defines.h create mode 100644 include/LibNectarCore/filesystem.h create mode 100755 include/LibNectarCore/mkhdrs.sh create mode 100644 include/LibNectarCore/new.h create mode 100644 include/LibNectarCore/utility.h (limited to 'include/LibNectarCore') diff --git a/include/LibNectarCore/.gitignore b/include/LibNectarCore/.gitignore new file mode 100644 index 0000000..e3f10ea --- /dev/null +++ b/include/LibNectarCore/.gitignore @@ -0,0 +1 @@ +libc++/ diff --git a/include/LibNectarCore/__abi.h b/include/LibNectarCore/__abi.h new file mode 100644 index 0000000..802bd1c --- /dev/null +++ b/include/LibNectarCore/__abi.h @@ -0,0 +1,24 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBNECTAR_ABI_H +#define NECTAR_LIBNECTAR_ABI_H + +#include +#include + +__init_decl() + +static constexpr int32_t __unreachable_code = 34; + +inline void __compilerkit_unreachable(void) { + signal(__unreachable_code); + + while (1); +} + +__fini_decl() + +#endif // NECTAR_LIBNECTAR_ABI_H diff --git a/include/LibNectarCore/__power64.inc b/include/LibNectarCore/__power64.inc new file mode 100644 index 0000000..8b65ad7 --- /dev/null +++ b/include/LibNectarCore/__power64.inc @@ -0,0 +1,40 @@ +# Path: LibC++/__power64.inc +# Language: CompilerKit POWER Assembly support for GNU. +# Build Date: 2024-6-4 + +#ifdef __NECTAR__ + +#ifdef __ASSEMBLER__ + +#define lda li +#define sta stw +#define ldw li + +#define r0 0 +#define r1 1 +#define r2 2 +#define r3 3 +#define r4 4 +#define r5 5 +#define r6 6 +#define r7 7 +#define r8 8 +#define r9 9 +#define r10 10 +#define r11 11 +#define r12 12 +#define r13 13 +#define r14 14 +#define r15 15 +#define r16 16 +#define r17 17 +#define r18 18 +#define r19 19 +#define r20 20 + +#define nop mr 0, 0 + +#endif + +#endif + diff --git a/include/LibNectarCore/base_alloc.h b/include/LibNectarCore/base_alloc.h new file mode 100644 index 0000000..e68efdb --- /dev/null +++ b/include/LibNectarCore/base_alloc.h @@ -0,0 +1,43 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBNECTAR_BASE_ALLOC_H +#define NECTAR_LIBNECTAR_BASE_ALLOC_H + +#include + +/// @brief allocate a new class. +/// @tparam KindClass the class type to allocate. +template +inline KindClass* allocate(Args&&... args) { + return new KindClass(forward(args)...); +} + +/// @brief allocate a new class. +/// @note aborts on error. +/// @tparam KindClass the class type to allocate. +template +inline KindClass* allocate_nothrow(Args&&... args) noexcept { + return allocate(forward(args)...); +} + +/// @brief free a class. +/// @tparam KindClass the class type to allocate. +template +inline void release(KindClass ptr) { + if (!ptr) return; + + delete ptr; +} + +/// @brief destroy and free a class. +/// @note aborts on error. +/// @tparam KindClass the class type to allocate. +template +inline void release_nothrow(KindClass ptr) noexcept { + release(ptr); +} + +#endif // NECTAR_LIBNECTAR_BASE_ALLOC_H diff --git a/include/LibNectarCore/base_exception.h b/include/LibNectarCore/base_exception.h new file mode 100644 index 0000000..992f76f --- /dev/null +++ b/include/LibNectarCore/base_exception.h @@ -0,0 +1,35 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBCXX_BASE_EXCEPTION_H +#define NECTAR_LIBCXX_BASE_EXCEPTION_H + +#include +#include +#include + +/// @author Amlal El Mahrouss (amlal@nekernel.org) + +inline constexpr int __terminate_id = 33; + +/// @note This function is internal, don't call it. +extern void __unwind_object_list(); + +inline void __throw_general(const char* what) { + __unwind_object_list(); + exit(__terminate_id); +} + +inline void __throw_domain_error(const char* what) { + __throw_general(what); + __builtin_unreachable(); // prevent from continuing. +} + +inline void __throw_bad_array_new_length(const char* what) { + __throw_general(what); + __builtin_unreachable(); // prevent from continuing. +} + +#endif // NECTAR_LIBCXX_BASE_EXCEPTION_H diff --git a/include/LibNectarCore/base_math.h b/include/LibNectarCore/base_math.h new file mode 100644 index 0000000..af31764 --- /dev/null +++ b/include/LibNectarCore/base_math.h @@ -0,0 +1,98 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBCXX_BASE_MATH_H +#define NECTAR_LIBCXX_BASE_MATH_H + +#include + +#ifndef NAN +#define NAN (__builtin_nanf("")) +#endif // !NAN + +/// @file base_math.h +/// @brief Base Mathematic functions. + +#ifdef __LIBCXX_USE_DOUBLE__ +typedef double real_type; +#else +typedef float real_type; +#endif + +inline constexpr static auto not_a_number = NAN; + +/// =========================================================== /// +/// @brief Power of Exponent function. +/// =========================================================== /// +template +inline real_type pow(real_type in) { + if (Exponent == 0) return 1; // Any number to the power of 0 is 1. + if (Exponent == 1) return in; // Any number to the power of 1 is itself. + + real_type result = 1; + + for (auto i = 0UL; i < Exponent; ++i) result *= in; + + return result; +} + +/// =========================================================== /// +/// @brief Square root function. +/// =========================================================== /// +inline real_type sqrt(real_type in) { + if (in == 0) return 0; + if (in == not_a_number) return not_a_number; + + auto constexpr const static Base = 2; + + auto x = in / Base; + + for (int i = 0; i < 10; ++i) { + x = (x + in / x) / Base; + } + + return x; +} + +/// =========================================================== /// +/// @brief Square of function, with Base template argument. +/// @param of Base argument to find the square of. +/// =========================================================== /// +template +inline real_type surd(real_type in) { + if (in == 0) return 0; + if (in == 1) return 1; + + if (Base == 1) return in; + if (Base == 2) return sqrt(in); + + return not_a_number; +} + +/// =========================================================== /// +/// @brief Linear interpolation equation solver. +/// @param from where? +/// @param to to? +/// @param Updated diff value according to difference. +/// =========================================================== /// +inline real_type lerp(real_type to, real_type from, real_type stat) { + real_type diff = (to - from); + return from + (diff * stat); +} + +using real_domain = double; + +struct complex_domain final { + double Re; + double Im; +}; + +typename using callable_type = Result (*)(size_t n, ...); + +#ifdef __cpp_lib_base_math +#define __cpp_lib_base_math 1 +#endif + +#endif // NECTAR_LIBCXX_BASE_MATH_H diff --git a/include/LibNectarCore/base_process.h b/include/LibNectarCore/base_process.h new file mode 100644 index 0000000..15d601b --- /dev/null +++ b/include/LibNectarCore/base_process.h @@ -0,0 +1,44 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBCXX_BASE_PROCESS_H +#define NECTAR_LIBCXX_BASE_PROCESS_H + +#include + +__init_decl() + +/// @brief CRT exit, with exit code (!!! exits all threads. !!!) +/// @param code the exit code. +/// @return the return > 0 for non successful. +extern int exit_(int code); + +/// @brief CRT signal handler. +/// @param code the signal code. +extern void signal_(int code); + +extern void (*__atexit_cdecl_ptr)(void); +extern void (**__atexit_lst_ptr)(void); +extern size_t __atexit_lst_cnt; + +__fini_decl() + + inline int signal(int code) { + signal_(code); + return -1; +} + +inline int32_t exit(const int32_t& code) { + for (auto idx = 0UL; idx < __atexit_lst_cnt; ++idx) { + __atexit_lst_ptr[idx](); + } + + if (__atexit_cdecl_ptr) __atexit_cdecl_ptr(); + + exit_(code); + return -1; +} + +#endif // NECTAR_LIBCXX_BASE_PROCESS_H diff --git a/include/LibNectarCore/defines.h b/include/LibNectarCore/defines.h new file mode 100644 index 0000000..061769c --- /dev/null +++ b/include/LibNectarCore/defines.h @@ -0,0 +1,80 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef __NECTAR_DEFINES_H__ +#define __NECTAR_DEFINES_H__ + +#define __ATTRIBUTE(X) __attribute__((X)) + +typedef __SIZE_TYPE__ size_t; +typedef __INT64_TYPE__ ssize_t; +typedef __INT32_TYPE__ int32_t; + +typedef void* ptr_type; +typedef __SIZE_TYPE__ size_type; + +typedef __INT64_TYPE__ ptrdiff_t; +typedef size_t uintptr_t; +typedef void* voidptr_t; +typedef void* any_t; +typedef char* caddr_t; + +#ifndef NULL +#define NULL ((voidptr_t) 0) +#endif // !null + +#define __alloca(sz) __ck_alloca(sz) + +#define __deref(ptr) (*(ptr)) + +#ifdef __cplusplus +#define __init_decl() extern "C" { +#define __fini_decl() \ + } \ + ; +#else +#define __init_decl() +#define __fini_decl() +#endif + +#if __has_builtin(__builtin_alloca) +#define alloca(sz) __builtin_alloca(sz) +#ifdef __alloca +#undef __alloca +#endif +#define __alloca alloca +#else +#warning !! alloca not detected !! +#endif + +typedef long long off_t; +typedef unsigned long long uoff_t; + +typedef union float_cast { + struct { + unsigned int mantissa : 23; + unsigned int exponent : 8; + unsigned int sign : 1; + }; + + float f; +} __ATTRIBUTE(packed) float_cast_t; + +typedef union double_cast { + struct { + unsigned long long int mantissa : 52; + unsigned int exponent : 11; + unsigned int sign : 1; + }; + + double f; +} __ATTRIBUTE(packed) double_cast_t; + +namespace std { +struct placement_t; +struct nothrow_t; +} // namespace std + +#endif /* __NECTAR_DEFINES_H__ */ diff --git a/include/LibNectarCore/filesystem.h b/include/LibNectarCore/filesystem.h new file mode 100644 index 0000000..daac4c1 --- /dev/null +++ b/include/LibNectarCore/filesystem.h @@ -0,0 +1,18 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef __NECTAR_FS_H__ +#define __NECTAR_FS_H__ + +class path; +class filesystem_error; +class directory_entry; +class directory_iterator; + +#ifndef __nec_lib_filesystem +#define __nec_lib_filesystem 201703L +#endif + +#endif // __NECTAR_FS_H__ diff --git a/include/LibNectarCore/mkhdrs.sh b/include/LibNectarCore/mkhdrs.sh new file mode 100755 index 0000000..b6b9f75 --- /dev/null +++ b/include/LibNectarCore/mkhdrs.sh @@ -0,0 +1,15 @@ +#! /bin/sh + +outputDir=libcnec/ + +mkdir -p $outputDir + +for f in *.h; do + +#This line splits the file name on the delimiter "." +baseName=`echo $f | cut -d "." -f 1` + +cp $f $outputDir$baseName + +done + diff --git a/include/LibNectarCore/new.h b/include/LibNectarCore/new.h new file mode 100644 index 0000000..58ea424 --- /dev/null +++ b/include/LibNectarCore/new.h @@ -0,0 +1,65 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef NECTAR_LIBNECTAR_NEW_H +#define NECTAR_LIBNECTAR_NEW_H + +#include + +struct nothrow_t final { + explicit nothrow_t() = default; + ~nothrow_t() = default; +}; + +struct placement_t final { + explicit placement_t() = default; + ~placement_t() = default; + + void* __base{}; + int32_t __align{}; + size_t __size{}; +}; + +// AMLALE: Define the placement_t feature. +#ifndef __nectar_has_placement +#define __nectar_has_placement 1 +#endif + +// AMLALE: Define nothrow +#ifndef __nectar_has_nothrow +#define __nectar_has_nothrow 1 +#endif + +void* operator new(size_t); +void* operator new[](size_t); + +/// \brief placement_t new and delete operators. Governs how the memory shall be placed. +/// \note This is a feature that shall be used wisely, failure to do so will produce Undefined +/// Behaviors at runtime. +void* operator pnew(struct placement_t*); +void operator pdelete(struct placement_t*, void*); + +/// \brief For all offsets within the base range and alignement 'align' +/// \brief Allocate offsets with respect to the `base` interval, apply alignement of `align` value. +/// Return `offsets` of length n as an aligned value within the domain of `base`. +using placeable_callable_type = void* /*offsets*/ (*) (void* base, size_t n, const int& align); + +/// \note This should NOT fail, failure to meet the conditions will cause the program's state to be +/// aborted. +/// \brief Set the placement policy of future memory allocations. +template +void set_placement_policy(const PlaceableCallable&) noexcept; + +void* operator new(size_t, const nothrow_t&) noexcept; +void* operator new(size_t, void*) noexcept; +void* operator new[](size_t, const nothrow_t&) noexcept; +void* operator new[](size_t, void*) noexcept; + +void operator delete(void*) noexcept; +void operator delete(void*, size_t) noexcept; + +void operator delete[](void*) noexcept; + +#endif // NECTAR_LIBNECTAR_NEW_H diff --git a/include/LibNectarCore/utility.h b/include/LibNectarCore/utility.h new file mode 100644 index 0000000..834b1a6 --- /dev/null +++ b/include/LibNectarCore/utility.h @@ -0,0 +1,27 @@ +// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Licensed under the Apache License, Version 2.0 (See accompanying +// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0) +// Official repository: https://github.com/nekernel-org/nectar + +#ifndef LIBNECTAR_UTILITY_H +#define LIBNECTAR_UTILITY_H + +/// @brief Forward object. +/// @tparam Args the object type. +/// @param arg the object. +/// @return object's rvalue +template +inline auto forward(Args& arg) -> Args&& { + return static_cast(arg); +} + +/// @brief Move object. +/// @tparam Args the object type. +/// @param arg the object. +/// @return object's rvalue +template +inline auto move(Args&& arg) -> Args&& { + return static_cast(arg); +} + +#endif // LIBNECTAR_UTILITY_H -- cgit v1.2.3