mirror of
https://gitee.com/anod/open_agb_firm.git
synced 2025-05-06 13:54:09 +08:00
c04e09a770
type.h: 针对c++使用了c++23的using语法定义typedef memory.h/memory.c 提供了不对齐拷贝32位值的实现 其他大部分头文件，只是提供了c++的头文件支持
156 lines
4.0 KiB
C
156 lines
4.0 KiB
C
#pragma once
|
|
|
|
/*
|
|
* This file is part of libn3ds
|
|
* Copyright (C) 2024 derrek, profi200
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "types.h"
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
#define ARRAY_ENTRIES(a) (sizeof(a) / sizeof(*a))
|
|
|
|
|
|
|
|
/**
|
|
* @brief Waits at least the specified amount of CPU cycles.
|
|
*
|
|
* @param[in] cycles The cycles to wait.
|
|
*/
|
|
void wait_cycles(u32 cycles);
|
|
|
|
/**
|
|
* @brief Safer strcpy with checks.
|
|
* The dst string always gets terminated except when num is 0.
|
|
* If the src string is too long nothing is copied and dst will be terminated.
|
|
* This function is not safe against race conditions!
|
|
*
|
|
* @param dst The destination pointer.
|
|
* @param[in] src The source pointer.
|
|
* @param[in] num Maximum number of chars to copy including null terminator.
|
|
*
|
|
* @return The length of the copied string in bytes including null terminator.
|
|
*/
|
|
size_t safeStrcpy(char *const dst, const char *const src, size_t num);
|
|
|
|
/**
|
|
* @brief Basic string to double conversion. Limited to 6 decimal places.
|
|
* Doesn't support exponents.
|
|
*
|
|
* @param[in] str The string.
|
|
*
|
|
* @return The floating-point number represented by str.
|
|
*/
|
|
double str2double(const char *str);
|
|
|
|
/**
|
|
* @brief Basic string to float conversion. Limited to 6 decimal places.
|
|
* Doesn't support exponents. This is a wrapper for str2double().
|
|
*
|
|
* @param[in] str The string.
|
|
*
|
|
* @return The floating-point number represented by str.
|
|
*/
|
|
float str2float(const char *str);
|
|
|
|
/**
|
|
* @brief Calculates the integer log2 of value.
|
|
*
|
|
* @param[in] val The input value.
|
|
*
|
|
* @return log2 of val.
|
|
*/
|
|
static inline u32 intLog2(u32 val)
|
|
{
|
|
// The result is undefined if __builtin_clzl() is called with 0.
|
|
return (val ? 31u - __builtin_clzl(val) : val);
|
|
}
|
|
|
|
/**
|
|
* @brief Round up to the next power of 2.
|
|
*
|
|
* @param[in] val The input value. Ranges outside 2 - 2147483648 are undefined behavior!
|
|
*
|
|
* @return Next power of 2 of val.
|
|
*/
|
|
static inline u32 nextPow2(u32 val)
|
|
{
|
|
// Portable variant:
|
|
// https://graphics.stanford.edu/~seander/bithacks.html#RoundUpPowerOf2
|
|
/*val--;
|
|
val |= val>>1;
|
|
val |= val>>2;
|
|
val |= val>>4;
|
|
val |= val>>8;
|
|
val |= val>>16;
|
|
val++;
|
|
|
|
return val;*/
|
|
|
|
// Warning: Allowed range is 2 - 2147483648.
|
|
// Everything else is undefined behavior.
|
|
return BIT(32u - __builtin_clzl(val - 1));
|
|
}
|
|
|
|
/**
|
|
* @brief Converts a 8 bit BCD number to decimal.
|
|
*
|
|
* @param[in] bcd The BCD number in range 0x00-0x99.
|
|
*
|
|
* @return Decimal representaion of bcd.
|
|
*/
|
|
static inline u32 bcd2dec(const u32 bcd)
|
|
{
|
|
// https://stackoverflow.com/a/42340213
|
|
return bcd - 6u * (bcd>>4);
|
|
}
|
|
|
|
/**
|
|
* @brief Converts a 8 bit decimal number to BCD.
|
|
*
|
|
* @param[in] dec The decimal number in range 0-99.
|
|
*
|
|
* @return BCD representation of dec.
|
|
*/
|
|
static inline u32 dec2bcd(const u32 dec)
|
|
{
|
|
// Div 10 with fixed point math.
|
|
// Based on bcd2dec() above.
|
|
return dec + 6u * ((dec * 103u)>>10);
|
|
}
|
|
|
|
/**
|
|
* @brief Clamps s32 number x between min and max.
|
|
*
|
|
* @param[in] x The value to clamp.
|
|
* @param[in] min The minimum.
|
|
* @param[in] max The maximum.
|
|
*
|
|
* @return Clamped value of x.
|
|
*/
|
|
static inline s32 clamp_s32(const s32 x, const s32 min, const s32 max)
|
|
{
|
|
return (x < min ? min : (x > max ? max : x));
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
} // extern "C"
|
|
#endif |