lib_str.h 文件参考

#include <cpu.h>
#include <lib_def.h>
#include <lib_ascii.h>
#include <app_cfg.h>
#include <stdlib.h>
#include <ctype.h>
#include <errno.h>
#include <limits.h>
#include <stdio.h>

lib_str.h 的引用(Include)关系图:

此图展示该文件直接或间接的被哪些文件引用了:

浏览源代码.

宏定义
#define	LIB_STR_EXT   extern
#define	Str_FmtPrint   snprintf
#define	Str_FmtScan   sscanf
#define	Str_IsPrint(a)   ASCII_IsPrint(a)
#define	Str_ToLong(a, b, c)   Str_ParseNbr_Int32S((CPU_CHAR *)(a), (CPU_CHAR **)(b), (CPU_INT08U)(c))

函数
CPU_SIZE_T	Str_Len (CPU_CHAR *pstr)
CPU_SIZE_T	Str_Len_N (CPU_CHAR *pstr, CPU_SIZE_T len_max)
CPU_CHAR *	Str_Copy (CPU_CHAR *pdest, CPU_CHAR *psrc)
CPU_CHAR *	Str_Copy_N (CPU_CHAR *pdest, CPU_CHAR *psrc, CPU_SIZE_T len_max)
CPU_CHAR *	Str_Cat (CPU_CHAR *pdest, CPU_CHAR *pstr_cat)
CPU_CHAR *	Str_Cat_N (CPU_CHAR *pdest, CPU_CHAR *pstr_cat, CPU_SIZE_T len_max)
CPU_INT16S	Str_Cmp (CPU_CHAR *p1_str, CPU_CHAR *p2_str)
CPU_INT16S	Str_Cmp_N (CPU_CHAR *p1_str, CPU_CHAR *p2_str, CPU_SIZE_T len_max)
CPU_INT16S	Str_CmpIgnoreCase (CPU_CHAR *p1_str, CPU_CHAR *p2_str)
CPU_INT16S	Str_CmpIgnoreCase_N (CPU_CHAR *p1_str, CPU_CHAR *p2_str, CPU_SIZE_T len_max)
CPU_CHAR *	Str_Char (CPU_CHAR *pstr, CPU_CHAR srch_char)
CPU_CHAR *	Str_Char_N (CPU_CHAR *pstr, CPU_SIZE_T len_max, CPU_CHAR srch_char)
CPU_CHAR *	Str_Char_Last (CPU_CHAR *pstr, CPU_CHAR srch_char)
CPU_CHAR *	Str_Str (CPU_CHAR *pstr, CPU_CHAR *psrch_str)
CPU_CHAR *	Str_FmtNbr_Int32U (CPU_INT32U nbr, CPU_INT08U nbr_dig, CPU_INT08U nbr_base, CPU_CHAR lead_char, CPU_BOOLEAN lower_case, CPU_BOOLEAN nul, CPU_CHAR *pstr)
CPU_CHAR *	Str_FmtNbr_Int32S (CPU_INT32S nbr, CPU_INT08U nbr_dig, CPU_INT08U nbr_base, CPU_CHAR lead_char, CPU_BOOLEAN lower_case, CPU_BOOLEAN nul, CPU_CHAR *pstr)
CPU_INT32U	Str_ParseNbr_Int32U (CPU_CHAR *pstr, CPU_CHAR **pstr_next, CPU_INT08U nbr_base)
CPU_INT32S	Str_ParseNbr_Int32S (CPU_CHAR *pstr, CPU_CHAR **pstr_next, CPU_INT08U nbr_base)

宏定义说明

#define LIB_STR_EXT   extern

在文件 lib_str.h 第 118 行定义.

#define Str_FmtPrint   snprintf

在文件 lib_str.h 第 189 行定义.

#define Str_FmtScan   sscanf

在文件 lib_str.h 第 190 行定义.

#define Str_IsPrint

(

a)

ASCII_IsPrint(a)

在文件 lib_str.h 第 193 行定义.

#define Str_ToLong	(		a,
			b,
			c
	)		Str_ParseNbr_Int32S((CPU_CHAR *)(a), (CPU_CHAR **)(b), (CPU_INT08U)(c))

在文件 lib_str.h 第 194 行定义.

函数说明

CPU_SIZE_T Str_Len

(

CPU_CHAR *

pstr)

在文件 lib_str.c 第 208 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_Len_N().

参考自 BSP_Print(), BSP_SerPrint(), Str_Char_Last() , 以及 Str_Str().

{
    CPU_SIZE_T  len;


    len = Str_Len_N((CPU_CHAR *)pstr,
                    (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL);

    return (len);
}

函数调用图:

这是这个函数的调用关系图:

CPU_SIZE_T Str_Len_N	(	CPU_CHAR *	pstr,
		CPU_SIZE_T	len_max
	)

在文件 lib_str.c 第 257 行定义.

参考自 Str_Len().

{
    CPU_SIZE_T  len;


    len = 0;
    while (( pstr != (CPU_CHAR *)  0 ) &&                       /* Calc str len until NULL ptr (see Note #2a) ...       */
           (*pstr != (CPU_CHAR  )'\0') &&                       /* ... or NULL char found      (see Note #2b) ...       */
           ( len   < (CPU_SIZE_T)len_max)) {                    /* ... or max nbr chars srch'd (see Note #2c).          */
        len++;
        pstr++;
    }

    return (len);
}

这是这个函数的调用关系图:

CPU_CHAR* Str_Copy	(	CPU_CHAR *	pdest,
		CPU_CHAR *	psrc
	)

在文件 lib_str.c 第 313 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_Copy_N().

参考自 App_DispScr_CtxSw(), App_DispScr_Inputs(), App_DispScr_SignOn() , 以及 App_DispScr_VersionTickRateCPU().

{
    pdest = Str_Copy_N((CPU_CHAR *)pdest,
                       (CPU_CHAR *)psrc,
                       (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL);

    return (pdest);
}

函数调用图:

这是这个函数的调用关系图:

CPU_CHAR* Str_Copy_N	(	CPU_CHAR *	pdest,
		CPU_CHAR *	psrc,
		CPU_SIZE_T	len_max
	)

在文件 lib_str.c 第 369 行定义.

参考自 Str_Copy().

{
    CPU_CHAR    *pstr;
    CPU_CHAR    *pstr_next;
    CPU_SIZE_T   len_copy;

                                                                /* Rtn NULL if str ptr(s) NULL      (see Note #2a).     */
    if (pdest == (CPU_CHAR *)0) {
        return  ((CPU_CHAR *)0);
    }
    if (psrc  == (CPU_CHAR *)0) {
        return  ((CPU_CHAR *)0);
    }

    if (len_max == (CPU_SIZE_T)0) {                             /* Rtn NULL if copy len equals zero (see Note #2d).     */
        return  ((CPU_CHAR *)0);
    }


    pstr      = pdest;
    pstr_next = pstr;
    pstr_next++;
    len_copy  = 0;

    while (( pstr_next != (CPU_CHAR *)  0 ) &&                  /* Copy str until NULL ptr(s)  [see Note #2b]  ...      */
           ( psrc      != (CPU_CHAR *)  0 ) &&
           (*psrc      != (CPU_CHAR  )'\0') &&                  /* ... or NULL char found      (see Note #2c); ...      */
           ( len_copy  <  (CPU_SIZE_T)len_max)) {               /* ... or max nbr chars copied (see Note #2d).          */
       *pstr = *psrc;
        pstr++;
        pstr_next++;
        psrc++;
        len_copy++;
    }

   *pstr = (CPU_CHAR)'\0';                                      /* Append NULL char (see Note #2b2).                    */


    return (pdest);
}

这是这个函数的调用关系图:

CPU_CHAR* Str_Cat	(	CPU_CHAR *	pdest,
		CPU_CHAR *	pstr_cat
	)

在文件 lib_str.c 第 454 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_Cat_N().

{
    pdest = Str_Cat_N((CPU_CHAR *)pdest,
                      (CPU_CHAR *)pstr_cat,
                      (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL);

    return (pdest);
}

函数调用图:

CPU_CHAR* Str_Cat_N	(	CPU_CHAR *	pdest,
		CPU_CHAR *	pstr_cat,
		CPU_SIZE_T	len_max
	)

在文件 lib_str.c 第 513 行定义.

参考自 Str_Cat().

{
    CPU_CHAR    *pstr;
    CPU_CHAR    *pstr_next;
    CPU_SIZE_T   len_cat;

                                                                /* Rtn NULL if str ptr(s) NULL     (see Note #2a).      */
    if (pdest == (CPU_CHAR *)0) {
        return  ((CPU_CHAR *)0);
    }
    if (pstr_cat == (CPU_CHAR *)0) {
        return  ((CPU_CHAR *)0);
    }

    if (len_max == (CPU_SIZE_T)0) {                             /* Rtn NULL if cat len equals zero (see Note #2e).      */
        return  ((CPU_CHAR *)0);
    }


    pstr = pdest;
    while (( pstr != (CPU_CHAR *)  0 ) &&                       /* Adv to end of cur dest str until NULL ptr ...        */
           (*pstr != (CPU_CHAR  )'\0')) {                       /* ... or NULL char found..                             */
        pstr++;
    }
    if (pstr == (CPU_CHAR *)0) {                                /* If NULL str overrun, rtn NULL (see Note #2b).        */
        return ((CPU_CHAR *)0);
    }

    pstr_next = pstr;
    pstr_next++;
    len_cat   = 0;

    while (( pstr_next != (CPU_CHAR *)  0 ) &&                  /* Cat str until NULL ptr(s)  [see Note #2c]  ...       */
           ( pstr_cat  != (CPU_CHAR *)  0 ) &&
           (*pstr_cat  != (CPU_CHAR  )'\0') &&                  /* ... or NULL char found     (see Note #2d); ...       */
           ( len_cat   <  (CPU_SIZE_T)len_max)) {               /* ... or max nbr chars cat'd (see Note #2d).           */
       *pstr = *pstr_cat;
        pstr++;
        pstr_next++;
        pstr_cat++;
        len_cat++;
    }

   *pstr = (CPU_CHAR)'\0';                                      /* Append NULL char (see Note #2c2).                    */


    return (pdest);
}

这是这个函数的调用关系图:

CPU_INT16S Str_Cmp	(	CPU_CHAR *	p1_str,
		CPU_CHAR *	p2_str
	)

在文件 lib_str.c 第 641 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_Cmp_N().

{
    CPU_INT16S  cmp_val;


    cmp_val = Str_Cmp_N((CPU_CHAR *)p1_str,
                        (CPU_CHAR *)p2_str,
                        (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL);

    return (cmp_val);
}

函数调用图:

CPU_INT16S Str_Cmp_N	(	CPU_CHAR *	p1_str,
		CPU_CHAR *	p2_str,
		CPU_SIZE_T	len_max
	)

在文件 lib_str.c 第 743 行定义.

参考自 Str_Cmp() , 以及 Str_Str().

{
    CPU_CHAR    *p1_str_next;
    CPU_CHAR    *p2_str_next;
    CPU_INT16S   cmp_val;
    CPU_SIZE_T   cmp_len;


    if (len_max == 0) {                                         /* If cmp len equals zero, rtn 0      (see Note #3d1).  */
        return ((CPU_INT16S)0);
    }

    if (p1_str == (CPU_CHAR *)0) {
        if (p2_str == (CPU_CHAR *)0) {
            return ((CPU_INT16S)0);                             /* If BOTH str ptrs NULL,  rtn 0      (see Note #3a1A). */
        }
        cmp_val = (CPU_INT16S)0 - (CPU_INT16S)(*p2_str);
        return (cmp_val);                                       /* If p1_str NULL, rtn neg p2_str val (see Note #3a1B1).*/
    }
    if (p2_str == (CPU_CHAR *)0) {
        cmp_val = (CPU_INT16S)(*p1_str);
        return (cmp_val);                                       /* If p2_str NULL, rtn pos p1_str val (see Note #3a1B2).*/
    }


    p1_str_next = p1_str;
    p2_str_next = p2_str;
    p1_str_next++;
    p2_str_next++;
    cmp_len     = 0;
    while ((*p1_str      == *p2_str)          &&                /* Cmp strs until non-matching chars (see Note #3c) ... */
           (*p1_str      != (CPU_CHAR  )'\0') &&                /* ... or NULL chars                 (see Note #3b) ... */
           ( p1_str_next != (CPU_CHAR *)  0 ) &&                /* ... or NULL ptr(s) found          (see Note #3a2);   */
           ( p2_str_next != (CPU_CHAR *)  0 ) &&
           ( cmp_len     <  (CPU_SIZE_T)len_max)) {             /* ... or max nbr chars cmp'd        (see Note #3d2).   */
        p1_str_next++;
        p2_str_next++;
        p1_str++;
        p2_str++;
        cmp_len++;
    }


    if (cmp_len == len_max) {                                       /* If strs     identical for len nbr of chars, ...  */
        return ((CPU_INT16S)0);                                     /* ... rtn 0                   (see Note #3d2).     */
    }

    if (*p1_str != *p2_str) {                                       /* If strs NOT identical, ...                       */
         cmp_val = (CPU_INT16S)(*p1_str) - (CPU_INT16S)(*p2_str);   /* ... calc & rtn char diff    (see Note #3c).      */

    } else if (*p1_str  == (CPU_CHAR)'\0') {                        /* If NULL char(s) found, ...                       */
         cmp_val = 0;                                               /* ... strs identical; rtn 0   (see Note #3b).      */

    } else {
        if (p1_str_next == (CPU_CHAR *)0) {
            if (p2_str_next == (CPU_CHAR *)0) {                     /* If BOTH next str ptrs NULL, ...                  */
                cmp_val  = (CPU_INT16S)0;                           /* ... rtn 0                   (see Note #3a2A).    */
            } else {                                                /* If p1_str_next NULL, ...                         */
                                                                    /* ... rtn neg p2_str_next val (see Note #3a2B1).   */
                cmp_val  = (CPU_INT16S)0 - (CPU_INT16S)(*p2_str_next);
            }
        } else {                                                    /* If p2_str_next NULL, ...                         */
            cmp_val = (CPU_INT16S)(*p1_str_next);                   /* ... rtn pos p1_str_next val (see Note #3a2B2).   */
        }
    }


    return (cmp_val);
}

这是这个函数的调用关系图:

CPU_INT16S Str_CmpIgnoreCase	(	CPU_CHAR *	p1_str,
		CPU_CHAR *	p2_str
	)

在文件 lib_str.c 第 902 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_CmpIgnoreCase_N().

{
    CPU_INT16S  cmp_val;


    cmp_val = Str_CmpIgnoreCase_N((CPU_CHAR *)p1_str,
                                  (CPU_CHAR *)p2_str,
                                  (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL);

    return (cmp_val);
}

函数调用图:

CPU_INT16S Str_CmpIgnoreCase_N	(	CPU_CHAR *	p1_str,
		CPU_CHAR *	p2_str,
		CPU_SIZE_T	len_max
	)

在文件 lib_str.c 第 1014 行定义.

参考 ASCII_TO_LOWER.

参考自 Str_CmpIgnoreCase().

{
    CPU_CHAR    *p1_str_next;
    CPU_CHAR    *p2_str_next;
    CPU_CHAR     char1;
    CPU_CHAR     char2;
    CPU_INT16S   cmp_val;
    CPU_SIZE_T   cmp_len;


    if (len_max == 0) {                                         /* If cmp len equals zero, rtn 0      (see Note #3d1).  */
        return ((CPU_INT16S)0);
    }

    if (p1_str == (CPU_CHAR *)0) {
        if (p2_str == (CPU_CHAR *)0) {
            return ((CPU_INT16S)0);                             /* If BOTH str ptrs NULL,  rtn 0      (see Note #3a1A). */
        }
        char2   =  ASCII_TO_LOWER(*p2_str);
        cmp_val = (CPU_INT16S)0 - (CPU_INT16S)char2;
        return (cmp_val);                                       /* If p1_str NULL, rtn neg p2_str val (see Note #3a1B1).*/
    }
    if (p2_str == (CPU_CHAR *)0) {
        char1   =  ASCII_TO_LOWER(*p1_str);
        cmp_val = (CPU_INT16S)char1;
        return (cmp_val);                                       /* If p2_str NULL, rtn pos p1_str val (see Note #3a1B2).*/
    }


    p1_str_next = p1_str;
    p2_str_next = p2_str;
    p1_str_next++;
    p2_str_next++;
    char1       = ASCII_TO_LOWER(*p1_str);
    char2       = ASCII_TO_LOWER(*p2_str);
    cmp_len     = 0;
    while (( char1       ==  char2)           &&                /* Cmp strs until non-matching chars (see Note #3c) ... */
           (*p1_str      != (CPU_CHAR  )'\0') &&                /* ... or NULL chars                 (see Note #3b) ... */
           ( p1_str_next != (CPU_CHAR *)  0 ) &&                /* ... or NULL ptr(s) found          (see Note #3a2);   */
           ( p2_str_next != (CPU_CHAR *)  0 ) &&
           ( cmp_len     <  (CPU_SIZE_T)len_max)) {             /* ... or max nbr chars cmp'd        (see Note #3d2).   */
        p1_str_next++;
        p2_str_next++;
        p1_str++;
        p2_str++;
        cmp_len++;
        char1 = ASCII_TO_LOWER(*p1_str);
        char2 = ASCII_TO_LOWER(*p2_str);
    }


    if (cmp_len == len_max) {                                   /* If strs     identical for len nbr of chars, ...      */
        return ((CPU_INT16S)0);                                 /* ... rtn 0                   (see Note #3d2).         */
    }

    if (char1 != char2) {                                       /* If strs NOT identical, ...                           */
         cmp_val = (CPU_INT16S)char1 - (CPU_INT16S)char2;       /* ... calc & rtn char diff    (see Note #3c).          */

    } else if (char1 == (CPU_CHAR)'\0') {                       /* If NULL char(s) found, ...                           */
         cmp_val = 0;                                           /* ... strs identical; rtn 0   (see Note #3b).          */

    } else {
        if (p1_str_next == (CPU_CHAR *)0) {
            if (p2_str_next == (CPU_CHAR *)0) {                 /* If BOTH next str ptrs NULL, ...                      */
                cmp_val  = (CPU_INT16S)0;                       /* ... rtn 0                   (see Note #3a2A).        */
            } else {                                            /* If p1_str_next NULL, ...                             */
                char2    =  ASCII_TO_LOWER(*p2_str_next);
                cmp_val  = (CPU_INT16S)0 - (CPU_INT16S)char2;   /* ... rtn neg p2_str_next val (see Note #3a2B1).       */
            }
        } else {                                                /* If p2_str_next NULL, ...                             */
            char1   =  ASCII_TO_LOWER(*p1_str_next);
            cmp_val = (CPU_INT16S)char1;                        /* ... rtn pos p1_str_next val (see Note #3a2B2).       */
        }
    }


    return (cmp_val);
}

这是这个函数的调用关系图:

CPU_CHAR* Str_Char	(	CPU_CHAR *	pstr,
		CPU_CHAR	srch_char
	)

在文件 lib_str.c 第 1133 行定义.

参考 DEF_INT_CPU_U_MAX_VAL , 以及 Str_Char_N().

{
    pstr = Str_Char_N((CPU_CHAR *)pstr,
                      (CPU_SIZE_T)DEF_INT_CPU_U_MAX_VAL,
                      (CPU_CHAR  )srch_char);

    return (pstr);
}

函数调用图:

CPU_CHAR* Str_Char_N	(	CPU_CHAR *	pstr,
		CPU_SIZE_T	len_max,
		CPU_CHAR	srch_char
	)

在文件 lib_str.c 第 1191 行定义.

参考自 Str_Char().

{
    CPU_CHAR    *pstr_next;
    CPU_SIZE_T   len_srch;


    if (pstr == (CPU_CHAR *)0) {                                /* Rtn NULL if srch str ptr NULL    (see Note #2a).     */
        return ((CPU_CHAR *)0);
    }

    if (len_max == (CPU_SIZE_T)0) {                             /* Rtn NULL if srch len equals zero (see Note #2e).     */
        return ((CPU_CHAR *)0);
    }


    pstr_next = pstr;
    pstr_next++;
    len_srch  = 0;
    while (( pstr_next != (CPU_CHAR *)  0 )      &&             /* Srch str until NULL ptr(s)  [see Note #2b]  ...      */
           (*pstr      != (CPU_CHAR  )'\0')      &&             /* ... or NULL char            (see Note #2c)  ...      */
           (*pstr      != (CPU_CHAR  )srch_char) &&             /* ... or srch char found      (see Note #2d); ...      */
           ( len_srch  <  (CPU_SIZE_T)len_max)) {               /* ... or max nbr chars srch'd (see Note #2e).          */
        pstr++;
        pstr_next++;
        len_srch++;
    }


    if (*pstr != srch_char) {                                   /* If srch char NOT found, str points to NULL; ...      */
         return ((CPU_CHAR *)0);                                /* ... rtn NULL (see Notes #2b & #2c).                  */
    }

    return (pstr);                                              /* Else rtn ptr to found srch char (see Note #2d).      */
}

这是这个函数的调用关系图:

CPU_CHAR* Str_Char_Last	(	CPU_CHAR *	pstr,
		CPU_CHAR	srch_char
	)

在文件 lib_str.c 第 1267 行定义.

参考 Str_Len().

{
    CPU_CHAR    *pstr_next;
    CPU_SIZE_T   str_len;


    if (pstr == (CPU_CHAR *)0) {                                /* Rtn NULL if srch str ptr NULL (see Note #2a).        */
        return ((CPU_CHAR *)0);
    }


    pstr_next  = pstr;
    str_len    = Str_Len(pstr);
    pstr_next += str_len;
    while (( pstr_next != pstr) &&                              /* Srch str from end until begining (see Note #2c) ...  */
           (*pstr_next != srch_char)) {                         /* ... until srch char found        (see Note #2d).     */
        pstr_next--;
    }


    if (*pstr_next != srch_char) {                              /* If srch char NOT found, str points to NULL; ...      */
         return ((CPU_CHAR *)0);                                /* ... rtn NULL (see Notes #2b & #2c).                  */
    }

    return (pstr_next);                                         /* Else rtn ptr to found srch char (see Note #2d).      */
}

函数调用图:

CPU_CHAR* Str_Str	(	CPU_CHAR *	pstr,
		CPU_CHAR *	psrch_str
	)

在文件 lib_str.c 第 1337 行定义.

参考 DEF_NO, DEF_YES, Str_Cmp_N() , 以及 Str_Len().

{
    CPU_SIZE_T    str_len;
    CPU_SIZE_T    srch_str_len;
    CPU_SIZE_T    srch_len;
    CPU_SIZE_T    srch_ix;
    CPU_BOOLEAN   srch_done;
    CPU_INT16S    srch_cmp;
    CPU_CHAR     *pstr_srch_ix;

                                                                /* Rtn NULL if str ptr(s) NULL (see Note #2a).          */
    if (pstr == (CPU_CHAR *)0) {
        return ((CPU_CHAR *)0);
    }
    if (psrch_str == (CPU_CHAR *)0) {
        return ((CPU_CHAR *)0);
    }


    str_len      = Str_Len(pstr);
    srch_str_len = Str_Len(psrch_str);
    if (srch_str_len > str_len) {                               /* If srch str len > str len, rtn NULL  (see Note #2b). */
        return ((CPU_CHAR *)0);
    }
    if (srch_str_len == 0) {                                    /* If srch str len = 0, srch str equal NULL str; ...    */
        pstr_srch_ix = (CPU_CHAR *)(pstr + str_len);            /* ... rtn ptr to NULL str found in str (see Note #2c). */
        return (pstr_srch_ix);
    }

    srch_len  = str_len - srch_str_len;                         /* Determine srch len (see Note #2d1).                  */
    srch_ix   = 0;
    srch_done = DEF_NO;
    do {
        pstr_srch_ix = (CPU_CHAR *)(pstr + srch_ix);
        srch_cmp     =  Str_Cmp_N(pstr_srch_ix, psrch_str, srch_str_len);
        srch_done    = (srch_cmp == 0) ? DEF_YES : DEF_NO;
        srch_ix++;
    } while ((srch_done == DEF_NO) && (srch_ix <= srch_len));


    if (srch_cmp != 0) {                                        /* If srch str NOT found, rtn NULL  (see Note #2d).     */
        return ((CPU_CHAR *)0);
    }

    return (pstr_srch_ix);                                      /* Rtn ptr to srch str found in str (see Note #2e).     */
}

函数调用图:

CPU_CHAR* Str_FmtNbr_Int32U	(	CPU_INT32U	nbr,
		CPU_INT08U	nbr_dig,
		CPU_INT08U	nbr_base,
		CPU_CHAR	lead_char,
		CPU_BOOLEAN	lower_case,
		CPU_BOOLEAN	nul,
		CPU_CHAR *	pstr
	)

在文件 lib_str.c 第 1476 行定义.

参考 DEF_NO , 以及 Str_FmtNbr_Int32().

参考自 App_DispScr_CtxSw(), App_DispScr_Inputs() , 以及 App_DispScr_VersionTickRateCPU().

{
    CPU_CHAR  *pstr_fmt;


    pstr_fmt = Str_FmtNbr_Int32((CPU_INT32U )nbr,               /* Fmt unsigned int into str.                           */
                                (CPU_INT08U )nbr_dig,
                                (CPU_INT08U )nbr_base,
                                (CPU_BOOLEAN)DEF_NO,
                                (CPU_CHAR   )lead_char,
                                (CPU_BOOLEAN)lower_case,
                                (CPU_BOOLEAN)nul,
                                (CPU_CHAR  *)pstr);

    return (pstr_fmt);
}

函数调用图:

这是这个函数的调用关系图:

CPU_CHAR* Str_FmtNbr_Int32S	(	CPU_INT32S	nbr,
		CPU_INT08U	nbr_dig,
		CPU_INT08U	nbr_base,
		CPU_CHAR	lead_char,
		CPU_BOOLEAN	lower_case,
		CPU_BOOLEAN	nul,
		CPU_CHAR *	pstr
	)

在文件 lib_str.c 第 1602 行定义.

参考 DEF_NO, DEF_YES , 以及 Str_FmtNbr_Int32().

{
    CPU_CHAR     *pstr_fmt;
    CPU_INT32S    nbr_fmt;
    CPU_BOOLEAN   nbr_neg;


    nbr_fmt = nbr;
    if (nbr_fmt < 0) {                                          /* If nbr neg, ...                                      */
        nbr_fmt = -nbr_fmt;                                     /* ... negate nbr.                                      */
        nbr_neg =  DEF_YES;
    } else {
        nbr_neg =  DEF_NO;
    }

    pstr_fmt = Str_FmtNbr_Int32((CPU_INT32U )nbr_fmt,           /* Fmt signed int into str.                             */
                                (CPU_INT08U )nbr_dig,
                                (CPU_INT08U )nbr_base,
                                (CPU_BOOLEAN)nbr_neg,
                                (CPU_CHAR   )lead_char,
                                (CPU_BOOLEAN)lower_case,
                                (CPU_BOOLEAN)nul,
                                (CPU_CHAR  *)pstr);

    return (pstr_fmt);
}

函数调用图:

CPU_INT32U Str_ParseNbr_Int32U	(	CPU_CHAR *	pstr,
		CPU_CHAR **	pstr_next,
		CPU_INT08U	nbr_base
	)

在文件 lib_str.c 第 2037 行定义.

参考 DEF_NO , 以及 Str_ParseNbr_Int32().

{
    CPU_INT32U  nbr;


    nbr = Str_ParseNbr_Int32((CPU_CHAR    *)pstr,               /* Parse/convert str ...                                */
                             (CPU_CHAR   **)pstr_next,
                             (CPU_INT08U   )nbr_base,
                             (CPU_BOOLEAN  )DEF_NO,             /* ... as unsigned int (see Note #2a2).                 */
                             (CPU_BOOLEAN *)0);

    return (nbr);
}

函数调用图:

CPU_INT32S Str_ParseNbr_Int32S	(	CPU_CHAR *	pstr,
		CPU_CHAR **	pstr_next,
		CPU_INT08U	nbr_base
	)

在文件 lib_str.c 第 2252 行定义.

参考 DEF_INT_32S_MAX_VAL, DEF_INT_32S_MIN_VAL, DEF_INT_32S_MIN_VAL_ONES_CPL, DEF_NO, DEF_YES , 以及 Str_ParseNbr_Int32().

{
    CPU_INT32S   nbr;
    CPU_INT32U   nbr_abs;
    CPU_BOOLEAN  nbr_neg;


    nbr_abs = Str_ParseNbr_Int32((CPU_CHAR    *) pstr,          /* Parse/convert str ...                                */
                                 (CPU_CHAR   **) pstr_next,
                                 (CPU_INT08U   ) nbr_base,
                                 (CPU_BOOLEAN  ) DEF_YES,       /* ... as signed int (see Note #2a2).                   */
                                 (CPU_BOOLEAN *)&nbr_neg);

    if (nbr_neg == DEF_NO) {                                    /* Chk for neg nbr & ovf/undf (see Note #2a3A1).        */
        nbr = (nbr_abs > (CPU_INT32U) DEF_INT_32S_MAX_VAL)          ?  (CPU_INT32S)DEF_INT_32S_MAX_VAL
                                                                    :  (CPU_INT32S)nbr_abs;
    } else {
        nbr = (nbr_abs > (CPU_INT32U)-DEF_INT_32S_MIN_VAL_ONES_CPL) ?  (CPU_INT32S)DEF_INT_32S_MIN_VAL
                                                                    : -(CPU_INT32S)nbr_abs;
    }

    return (nbr);
}

函数调用图: