Include/vos_string.h

   1 /******************************************************************************
   2 *
   3 *   Copyright (c) 2020 ICT/CAS.
   4 *
   5 *   Licensed under the O-RAN Software License, Version 1.0 (the "Software License");
   6 *   you may not use this file except in compliance with the License.
   7 *   You may obtain a copy of the License at
   8 *
   9 *       https://www.o-ran.org/software
  10 *
  11 *   Unless required by applicable law or agreed to in writing, software
  12 *   distributed under the License is distributed on an "AS IS" BASIS,
  13 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 *   See the License for the specific language governing permissions and
  15 *   limitations under the License.
  16 *
  17 *******************************************************************************/
  18
  19
  20
  21 #ifndef __VOS_STRING_H__
  22 #define __VOS_STRING_H__
  23
  24 #ifdef __cplusplus
  25 extern "C"{
  26 #endif /* __cplusplus */
  27
  28 /** 同 memcpy */
  29 VOID *VOS_MemCpy(VOID * pcDest, const VOID * pcSrc, ULONG ulLen);
  30
  31 /** 同 memmove */
  32 VOID *VOS_MemMove(VOID * pcDest, const VOID * pcSrc, ULONG ulLen);
  33
  34 /** 同 memset */
  35 VOID *VOS_MemSet(VOID *pcBuf, CHAR cWhat, ULONG ulHowMany);
  36
  37 /** 同 memset(&var,0,sizeof(var)) */
  38 VOID *VOS_MemZero(VOID *pcBuf, ULONG ulHowMany);
  39
  40 /** 同 memcmp */
  41 LONG VOS_MemCmp(const VOID *pcBuf1, const VOID *pcBuf2, ULONG ulLen);
  42
  43 /** 同 strchr */
  44 CHAR *VOS_StrChr(const CHAR *pcStr, CHAR cCh);
  45
  46 /** 同 strrchr */
  47 CHAR *VOS_StrRChr(const CHAR *pcStr, CHAR cCh);
  48
  49 /** 同 strcat */
  50 CHAR *VOS_StrCat(CHAR *pcDest, const CHAR *pcAppend);
  51
  52 /** 同 strncat */
  53 CHAR *VOS_StrnCat(CHAR *pcDest, const CHAR *pcAppend, ULONG ulLen);
  54
  55 /** 同 strcpy */
  56 CHAR *VOS_StrCpy(CHAR *pcDest, const CHAR *pcSrc);
  57
  58 /** 同 strncpy */
  59 CHAR *VOS_StrnCpy(CHAR * pcDest,const CHAR *pcSrc, ULONG ulCount);
  60
  61 /** 同 strncmp */
  62 ULONG VOS_StrnCmp(const CHAR * cs, const CHAR * ct, ULONG count);
  63
  64 /** 同 strcmp */
  65 LONG VOS_StrCmp(const CHAR *szStr1, const CHAR *szStr2);
  66
  67 /** 同 strlen */
  68 ULONG VOS_StrLen(const CHAR *szStr);
  69
  70 /** 同 strstr */
  71 CHAR *VOS_StrStr(const CHAR *szStr, const CHAR *szToFind);
  72
  73 /** 同 strncmp */
  74 CHAR *VOS_StrpBrk(const CHAR *szStr, const CHAR *szToFind);
  75
  76 /** 同 atol */
  77 LONG VOS_AtoL(const CHAR *szString);
  78
  79 /** 同 strtol */
  80 LONG VOS_StrToL(const CHAR *cp,CHAR **endp,INT base);
  81
  82 /** 同 strtoul */
  83 ULONG VOS_StrToUL(const CHAR *szNptr, CHAR **szEndptr, INT ulBase );
  84
  85 /** 同 strtoll */
  86 LONGLONG VOS_StrToLL(const CHAR *cp,CHAR **endp,INT base);
  87
  88 /** 同 strtoull */
  89 ULONGLONG VOS_StrToULL(const CHAR *cp,CHAR **endp,INT base);
  90
  91 /** 同 strtok */
  92 CHAR * VOS_StrToK(CHAR* strToken, const CHAR * strDelimit);
  93
  94 /** 同 atoi */
  95 INT VOS_AtoI(const CHAR* s);
  96
  97 /** 同 strncasecmp */
  98 ULONG VOS_StrnCaseCmp(const CHAR*, const CHAR*, ULONG ulLen);
  99
 100 /** 同 strcasecmp */
 101 LONG VOS_StrCaseCmp(const CHAR *cs, const CHAR *ct);
 102
 103 /** 同 strnlen */
 104 ULONG VOS_StrnLen(const CHAR * s, ULONG count);
 105
 106 /** 将字符串转换为小写 */
 107 CHAR *VOS_StrToLower(CHAR *src);
 108
 109 /** 将字符串转换为大写 */
 110 CHAR *VOS_StrToUpper(CHAR *src);
 111
 112
 113 /**
 114  * 复制字符串，申请大小为strlen(src)+1内存，然后将字符串拷入，并返回
 115  * @param[in]   src       源字符串
 116  * @param[in]   mod_id    模块ID
 117  * @return      成功返回新字符串的地址，失败返回NULL
 118  */
 119 CHAR *VOS_StrDup (const CHAR *src,INT mod_id);
 120
 121
 122 /**
 123  * 复制字符串，并转换为小写，申请大小为strlen(src)+1内存，然后将字符串拷入，并返回
 124  * @param[in]   src       源字符串
 125  * @param[in]   mod_id    模块ID
 126  */
 127 CHAR *VOS_StrDupToLower (const CHAR *src,INT mod_id);
 128
 129
 130 /**
 131  * 计算从左侧第一个不是空白字符起到字符串结尾的长度
 132  * @param[in]   szStr      字符串
 133 * @return      字符串长度
 134 */
 135 ULONG VOS_StrLeftTrimLen(const CHAR *szStr);
 136
 137
 138 /**
 139  * 将str 中的old字符替换成new字符
 140  * @param[in]   src      字符串
 141  * @param[in]   old      要替换的字符
 142  * @param[in]   new      替换成的字符
 143  * @return      返回指向src的指针
 144  */
 145 CHAR *VOS_StrCharReplace(CHAR *src,const CHAR old,const CHAR new);
 146
 147
 148 #ifdef __cplusplus
 149 }
 150 #endif /* __cplusplus */
 151
 152 #endif /*__VOS_STRING_H__*/