libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues 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
#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)
{
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);
#ifdef RT_USING_PTHREADS
if(self->pthread_data != RT_NULL)
if (self->pthread_data != RT_NULL)
{
extern void pthread_exit(void *value);
pthread_exit((void *)status);
@ -36,6 +41,13 @@ void __rt_libc_exit(int status)
}
#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)
{
extern int msh_exec(char *cmd, rt_size_t length);
@ -50,6 +62,15 @@ int system(const char *command)
RTM_EXPORT(system);
#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 tmp[33];
@ -61,12 +82,12 @@ char *ltoa(long value, char *string, int radix)
if (string == NULL)
{
return 0 ;
return 0;
}
if (radix > 36 || radix <= 1)
{
return 0 ;
return 0;
}
sign = (radix == 10 && value < 0);
@ -84,7 +105,7 @@ char *ltoa(long value, char *string, int radix)
i = v % radix;
v = v / radix;
if (i < 10)
*tp++ = (char)(i+'0');
*tp++ = (char)(i + '0');
else
*tp++ = (char)(i + 'a' - 10);
}
@ -100,12 +121,29 @@ char *ltoa(long value, char *string, int radix)
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)
{
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 tmp[33];
@ -129,7 +167,7 @@ char *ultoa(unsigned long value, char *string, int radix)
i = v % radix;
v = v / radix;
if (i < 10)
*tp++ = (char)(i+'0');
*tp++ = (char)(i + '0');
else
*tp++ = (char)(i + 'a' - 10);
}
@ -143,7 +181,16 @@ char *ultoa(unsigned long value, char *string, int radix)
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)
{
return ultoa(value, string, radix) ;
return ultoa(value, string, radix);
}