mirror of
https://github.com/c3lang/c3c.git
synced 2026-02-27 12:01:16 +00:00
290 lines
6.9 KiB
C
290 lines
6.9 KiB
C
// Copyright (c) 2021-2022 Christoffer Lerno and contributors. All rights reserved.
|
|
// Use of this source code is governed by the MIT license
|
|
// a copy of which can be found in the LICENSE_STDLIB file.
|
|
module std::core::builtin;
|
|
import libc;
|
|
import std::hash;
|
|
|
|
/**
|
|
* Use `IteratorResult` when reading the end of an iterator, or accessing a result out of bounds.
|
|
**/
|
|
fault IteratorResult
|
|
{
|
|
NO_MORE_ELEMENT
|
|
}
|
|
|
|
/**
|
|
* Use `SearchResult` when trying to return a value from some collection but the element is missing.
|
|
**/
|
|
fault SearchResult
|
|
{
|
|
MISSING
|
|
}
|
|
|
|
/**
|
|
* Use `CastResult` when an attempt at conversion fails.
|
|
**/
|
|
fault CastResult
|
|
{
|
|
TYPE_MISMATCH
|
|
}
|
|
|
|
/**
|
|
* Stores a variable on the stack, then restores it at the end of the
|
|
* macro scope.
|
|
*
|
|
* @param variable `the variable to store and restore`
|
|
**/
|
|
macro void @scope(&variable; @body) @builtin
|
|
{
|
|
var temp = variable;
|
|
defer variable = temp;
|
|
@body();
|
|
}
|
|
|
|
/**
|
|
* Swap two variables
|
|
**/
|
|
macro void @swap(&a, &b) @builtin
|
|
{
|
|
var temp = a;
|
|
a = b;
|
|
b = temp;
|
|
}
|
|
|
|
/**
|
|
* Convert an `any` type to a type, returning an failure if there is a type mismatch.
|
|
*
|
|
* @param v `the any to convert to the given type.`
|
|
* @param $Type `the type to convert to`
|
|
* @return `The any.ptr converted to its type.`
|
|
* @ensure @typeis(return, $Type*)
|
|
* @return! CastResult.TYPE_MISMATCH
|
|
**/
|
|
macro anycast(any v, $Type) @builtin
|
|
{
|
|
if (v.type != $Type.typeid) return CastResult.TYPE_MISMATCH?;
|
|
return ($Type*)v.ptr;
|
|
}
|
|
|
|
struct CallstackElement
|
|
{
|
|
CallstackElement* prev;
|
|
String function;
|
|
String file;
|
|
uint line;
|
|
}
|
|
|
|
fn void default_panic(String message, String file, String function, uint line)
|
|
{
|
|
CallstackElement* stack = $$stacktrace();
|
|
$if ($defined(io::stderr) && $defined(File.printf))
|
|
|
|
if (stack) stack = stack.prev;
|
|
if (stack)
|
|
{
|
|
(void)io::stderr().print("\nERROR: '");
|
|
(void)io::stderr().print(message);
|
|
(void)io::stderr().printn("'");
|
|
}
|
|
else
|
|
{
|
|
(void)io::stderr().print("\nERROR: '");
|
|
(void)io::stderr().print(message);
|
|
(void)io::stderr().printfn("', in function %s (%s:%d)", function, file, line);
|
|
}
|
|
while (stack)
|
|
{
|
|
(void)io::stderr().printfn(" in function %s (%s:%d)", stack.function, stack.file, stack.line);
|
|
if (stack == stack.prev) break;
|
|
stack = stack.prev;
|
|
}
|
|
|
|
$endif
|
|
$$trap();
|
|
}
|
|
|
|
typedef PanicFn = fn void(String message, String file, String function, uint line);
|
|
|
|
PanicFn panic = &default_panic;
|
|
|
|
fn void panicf(String fmt, String file, String function, uint line, args...)
|
|
{
|
|
@stack_mem(512; Allocator* mem)
|
|
{
|
|
DString s;
|
|
s.init(.using = mem);
|
|
s.printf(fmt, ...args);
|
|
panic(s.str(), file, function, line);
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Marks the path as unreachable. This will panic in safe mode, and in fast will simply be assumed
|
|
* never happens.
|
|
* @param [in] string "The panic message or format string"
|
|
**/
|
|
macro void unreachable(String string = "Unreachable statement reached.", ...) @builtin @noreturn
|
|
{
|
|
panicf(string, $$FILE, $$FUNC, $$LINE, $vasplat());
|
|
$$unreachable();
|
|
}
|
|
|
|
/**
|
|
* Marks the path as unsupported, this is similar to unreachable.
|
|
* @param [in] string "The error message"
|
|
**/
|
|
macro void unsupported(String string = "Unsupported function invoked") @builtin @noreturn
|
|
{
|
|
panicf(string, $$FILE, $$FUNC, $$LINE, $vasplat());
|
|
$$unreachable();
|
|
}
|
|
|
|
/**
|
|
* @param expr "the expression to cast"
|
|
* @param $Type "the type to cast to"
|
|
*
|
|
* @require $sizeof(expr) == $Type.sizeof "Cannot bitcast between types of different size."
|
|
* @ensure @typeis(result, $Type)
|
|
**/
|
|
macro bitcast(expr, $Type) @builtin
|
|
{
|
|
usz $size = $sizeof(expr);
|
|
$Type x @noinit;
|
|
mem::copy(&x, &expr, $size, $Type.alignof, $alignof(expr));
|
|
return x;
|
|
}
|
|
|
|
/**
|
|
* @param $Type `The type of the enum`
|
|
* @param [in] enum_name `The name of the enum to search for`
|
|
* @require $Type.kindof == ENUM `Only enums may be used`
|
|
* @ensure @typeis(return, $Type)
|
|
* @return! SearchResult.MISSING
|
|
**/
|
|
macro enum_by_name($Type, String enum_name) @builtin
|
|
{
|
|
typeid x = $Type.typeid;
|
|
foreach (i, name : x.names)
|
|
{
|
|
if (name == enum_name) return ($Type)i;
|
|
}
|
|
return SearchResult.MISSING?;
|
|
}
|
|
|
|
/**
|
|
* Mark an expression as likely to be true
|
|
*
|
|
* @param #value "expression to be marked likely"
|
|
* @param $probability "in the range 0 - 1"
|
|
* @require $probability >= 0 && $probability <= 1.0
|
|
**/
|
|
macro bool @likely(bool #value, $probability = 1.0) @builtin
|
|
{
|
|
$if ($probability == 1.0)
|
|
return $$expect(#value, true);
|
|
$else
|
|
return $$expect_with_probability(#value, true, $probability);
|
|
$endif
|
|
}
|
|
|
|
/**
|
|
* Mark an expression as unlikely to be true
|
|
*
|
|
* @param #value "expression to be marked unlikely"
|
|
* @param $probability "in the range 0 - 1"
|
|
* @require $probability >= 0 && $probability <= 1.0
|
|
**/
|
|
macro bool @unlikely(bool #value, $probability = 1.0) @builtin
|
|
{
|
|
$if ($probability == 1.0)
|
|
return $$expect(#value, false);
|
|
$else
|
|
return $$expect_with_probability(#value, false, $probability);
|
|
$endif
|
|
}
|
|
|
|
/**
|
|
* @require values::@is_int(#value) || values::@is_bool(#value)
|
|
* @checked $typeof(#value) a = expected
|
|
* @require $probability >= 0 && $probability <= 1.0
|
|
**/
|
|
macro @expect(#value, expected, $probability = 1.0) @builtin
|
|
{
|
|
$if ($probability == 1.0)
|
|
return $$expect(#value, ($typeof(#value))expected);
|
|
$else
|
|
return $$expect_with_probability(#value, expected, $probability);
|
|
$endif
|
|
}
|
|
|
|
/**
|
|
* Locality for prefetch, levels 0 - 3, corresponding
|
|
* to "extremely local" to "no locality"
|
|
**/
|
|
enum PrefetchLocality
|
|
{
|
|
NO_LOCALITY,
|
|
FAR,
|
|
NEAR,
|
|
VERY_NEAR,
|
|
}
|
|
|
|
/**
|
|
* Prefetch a pointer.
|
|
|
|
* @param [in] ptr `Pointer to prefetch`
|
|
* @param $locality `Locality ranging from none to extremely local`
|
|
* @param $write `Prefetch for write, otherwise prefetch for read.`
|
|
**/
|
|
macro prefetch(void* ptr, PrefetchLocality $locality = VERY_NEAR, bool $write = false) @builtin
|
|
{
|
|
$$prefetch(ptr, $write ? 1 : 0, $locality.ordinal);
|
|
}
|
|
|
|
macro swizzle(v, ...) @builtin
|
|
{
|
|
return $$swizzle(v, $vasplat());
|
|
}
|
|
|
|
macro swizzle2(v, v2, ...) @builtin
|
|
{
|
|
return $$swizzle2(v, v2, $vasplat());
|
|
}
|
|
|
|
macro bool @castable(#expr, $To) @builtin
|
|
{
|
|
return $checks(($To)#expr);
|
|
}
|
|
|
|
macro bool @convertible(#expr, $To) @builtin
|
|
{
|
|
return $checks($To x = #expr);
|
|
}
|
|
|
|
macro anyfault @catchof(#expr) @builtin
|
|
{
|
|
if (catch f = #expr) return f;
|
|
return anyfault {};
|
|
}
|
|
|
|
macro bool @ok(#expr) @builtin
|
|
{
|
|
if (catch #expr) return false;
|
|
return true;
|
|
}
|
|
|
|
macro uint int.hash(int i) => i;
|
|
macro uint uint.hash(uint i) => i;
|
|
macro uint short.hash(short s) => s;
|
|
macro uint ushort.hash(ushort s) => s;
|
|
macro uint char.hash(char c) => c;
|
|
macro uint ichar.hash(ichar c) => c;
|
|
macro uint long.hash(long i) => (uint)((i >> 32) ^ i);
|
|
macro uint ulong.hash(ulong i) => (uint)((i >> 32) ^ i);
|
|
macro uint int128.hash(int128 i) => (uint)((i >> 96) ^ (i >> 64) ^ (i >> 32) ^ i);
|
|
macro uint uint128.hash(uint128 i) => (uint)((i >> 96) ^ (i >> 64) ^ (i >> 32) ^ i);
|
|
macro uint bool.hash(bool b) => (uint)b;
|
|
macro uint typeid.hash(typeid t) => ((ulong)(uptr)t).hash();
|
|
macro uint String.hash(String c) => (uint)fnv32a::encode(c);
|
|
macro uint char[].hash(char[] c) => (uint)fnv32a::encode(c); |