Enrico Fraccaroli (Galfurian)
71 lines
2.6 KiB
C
71 lines
2.6 KiB
C
/// @file stdlib.h
|
|
/// @brief Useful generic functions and macros.
|
|
/// @copyright (c) 2014-2022 This file is distributed under the MIT License.
|
|
/// See LICENSE.md for details.
|
|
|
|
#pragma once
|
|
|
|
#include "stddef.h"
|
|
|
|
/// @brief Returns the number of usable bytes in the block pointed to by ptr.
|
|
/// @param ptr The pointer for which we want to retrieve the usable size.
|
|
/// @return The number of usable bytes in the block of allocated memory
|
|
/// pointed to by ptr. If ptr is not a valid pointer, 0 is returned.
|
|
size_t malloc_usable_size(void *ptr);
|
|
|
|
/// @brief Provides dynamically allocated memory.
|
|
/// @param size The amount of memory to allocate.
|
|
/// @return A pointer to the allocated memory.
|
|
void *malloc(unsigned int size);
|
|
|
|
/// @brief Allocates a block of memory for an array of num elements.
|
|
/// @param num The number of elements.
|
|
/// @param size The size of an element.
|
|
/// @return A pointer to the allocated memory.
|
|
void *calloc(size_t num, size_t size);
|
|
|
|
/// @brief Reallocates the given area of memory.
|
|
/// @param ptr The pointer to the memory to reallocate.
|
|
/// @param size The new size for the memory.
|
|
/// @return A pointer to the new portion of memory.
|
|
/// @details
|
|
/// It must be previously allocated by malloc(), calloc() or realloc() and
|
|
/// not yet freed with a call to free or realloc. Otherwise, the results
|
|
/// are undefined.
|
|
void *realloc(void *ptr, size_t size);
|
|
|
|
/// @brief Frees dynamically allocated memory.
|
|
/// @param ptr The pointer to the allocated memory.
|
|
void free(void *ptr);
|
|
|
|
/// The maximum value returned by the rand function.
|
|
#define RAND_MAX ((1U << 31U) - 1U)
|
|
|
|
/// @brief Allows to set the seed of the random value generator.
|
|
/// @param x The new seed.
|
|
void srand(int x);
|
|
|
|
/// @brief Generates a random value.
|
|
/// @return The random value.
|
|
int rand();
|
|
|
|
/// @brief Cause an abnormal program termination with core-dump.
|
|
void abort();
|
|
|
|
/// @brief Tries to adds the variable to the environment.
|
|
/// @param name Name of the variable.
|
|
/// @param value Value of the variable.
|
|
/// @param overwrite Override existing variable value or not.
|
|
/// @return Zero on success, or -1 on error with errno indicating the cause.
|
|
int setenv(const char *name, const char *value, int overwrite);
|
|
|
|
/// @brief Tries to remove the variable from the environment.
|
|
/// @param name Name of the variable.
|
|
/// @return Zero on success, or -1 on error with errno indicating the cause.
|
|
int unsetenv(const char *name);
|
|
|
|
/// @brief Returns the value of the given variable.
|
|
/// @param name Name of the variable.
|
|
/// @return A pointer to the value, or NULL if there is no match.
|
|
char *getenv(const char *name);
|