libs/rt-thread
libs
/
rt-thread
4
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[libc] add comments to the cstdlib.c (#8209) 

Co-authored-by: sq <1838545301@qq.com>
This commit is contained in:
shu-qian 2023-11-01 17:31:57 +08:00 committed by GitHub
parent ebc9582c07
commit c7e0a96f6f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 55 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
components/libc/compilers/common/cstdlib.c
View File

@ -14,6 +14,11 @@
#define DBG_LVL DBG_INFO #define DBG_LVL DBG_INFO
#include <rtdbg.h> #include <rtdbg.h>
/**
* @brief This function is called when a thread exits. It can detach the thread and perform cleanup.
*
* @param status is the exit status of the thread.
*/
void __rt_libc_exit(int status) void __rt_libc_exit(int status)
{ {
rt_thread_t self = rt_thread_self(); rt_thread_t self = rt_thread_self();
@ -22,7 +27,7 @@ void __rt_libc_exit(int status)
{ {
LOG_W("thread:%s exit:%d!", self->parent.name, status); LOG_W("thread:%s exit:%d!", self->parent.name, status);
#ifdef RT_USING_PTHREADS #ifdef RT_USING_PTHREADS
if(self->pthread_data != RT_NULL) if (self->pthread_data != RT_NULL)
{ {
extern void pthread_exit(void *value); extern void pthread_exit(void *value);
pthread_exit((void *)status); pthread_exit((void *)status);
@ -36,6 +41,13 @@ void __rt_libc_exit(int status)
} }
#ifdef RT_USING_MSH #ifdef RT_USING_MSH
/**
* @brief Execute a command using the Micro-Shell (MSH) subsystem.
*
* @param command is the command string to execute.
*
* @return Returns 0 after executing the command.
*/
int system(const char *command) int system(const char *command)
{ {
extern int msh_exec(char *cmd, rt_size_t length); extern int msh_exec(char *cmd, rt_size_t length);
@ -50,6 +62,15 @@ int system(const char *command)
RTM_EXPORT(system); RTM_EXPORT(system);
#endif /* RT_USING_MSH */ #endif /* RT_USING_MSH */
/**
* @brief Convert a long integer to a string representation with a specified radix.
*
* @param value is the long integer to convert.
* @param string is the destination string where the result will be stored.
* @param radix is the base of the number system to be used for conversion.
*
* @return Returns a pointer to the destination string.
*/
char *ltoa(long value, char *string, int radix) char *ltoa(long value, char *string, int radix)
{ {
char tmp[33]; char tmp[33];
@ -61,12 +82,12 @@ char *ltoa(long value, char *string, int radix)
if (string == NULL) if (string == NULL)
{ {
return 0 ; return 0;
} }
if (radix > 36 || radix <= 1) if (radix > 36 || radix <= 1)
{ {
return 0 ; return 0;
} }
sign = (radix == 10 && value < 0); sign = (radix == 10 && value < 0);
@ -84,7 +105,7 @@ char *ltoa(long value, char *string, int radix)
i = v % radix; i = v % radix;
v = v / radix; v = v / radix;
if (i < 10) if (i < 10)
*tp++ = (char)(i+'0'); *tp++ = (char)(i + '0');
else else
*tp++ = (char)(i + 'a' - 10); *tp++ = (char)(i + 'a' - 10);
} }
@ -100,12 +121,29 @@ char *ltoa(long value, char *string, int radix)
return string; return string;
} }
/**
* @brief Convert an integer to a string representation with a specified radix.
*
* @param value is the integer to convert.
* @param string is the destination string where the result will be stored.
* @param radix is the base of the number system to be used for conversion.
*
* @return Returns a pointer to the destination string.
*/
char *itoa(int value, char *string, int radix) char *itoa(int value, char *string, int radix)
{ {
return ltoa(value, string, radix) ; return ltoa(value, string, radix);
} }
/**
* @brief Convert an unsigned long integer to a string representation with a specified radix.
*
* @param value is the unsigned long integer to convert.
* @param string is the destination string where the result will be stored.
* @param radix is the base of the number system to be used for conversion.
*
* @return Returns a pointer to the destination string.
*/
char *ultoa(unsigned long value, char *string, int radix) char *ultoa(unsigned long value, char *string, int radix)
{ {
char tmp[33]; char tmp[33];
@ -129,7 +167,7 @@ char *ultoa(unsigned long value, char *string, int radix)
i = v % radix; i = v % radix;
v = v / radix; v = v / radix;
if (i < 10) if (i < 10)
*tp++ = (char)(i+'0'); *tp++ = (char)(i + '0');
else else
*tp++ = (char)(i + 'a' - 10); *tp++ = (char)(i + 'a' - 10);
} }
@ -143,7 +181,16 @@ char *ultoa(unsigned long value, char *string, int radix)
return string; return string;
} }
/**
* @brief Convert an unsigned integer to a string representation with a specified radix.
*
* @param value is the unsigned integer to convert.
* @param string is the destination string where the result will be stored.
* @param radix is the base of the number system to be used for conversion.
*
* @return Returns a pointer to the destination string.
*/
char *utoa(unsigned value, char *string, int radix) char *utoa(unsigned value, char *string, int radix)
{ {
return ultoa(value, string, radix) ; return ultoa(value, string, radix);
} }