home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / xwphescr.zip / XWPH0208.ZIP / include / helpers / stringh.h < prev    next >
C/C++ Source or Header  |  2002-06-20  |  8KB  |  195 lines
  1.  
  2. /*
  3.  *@@sourcefile stringh.h:
  4.  *      header file for stringh.c. See notes there.
  5.  *
  6.  *      Note: Version numbering in this file relates to XWorkplace version
  7.  *            numbering.
  8.  *
  9.  *@@include #define INCL_DOSDATETIME
  10.  *@@include #include <os2.h>
  11.  *@@include #include "helpers\stringh.h"
  12.  */
  13.  
  14. /*
  15.  *      Copyright (C) 1997-2000 Ulrich Möller.
  16.  *      This file is part of the "XWorkplace helpers" source package.
  17.  *      This is free software; you can redistribute it and/or modify
  18.  *      it under the terms of the GNU General Public License as published
  19.  *      by the Free Software Foundation, in version 2 as it comes in the
  20.  *      "COPYING" file of the XWorkplace main distribution.
  21.  *      This program is distributed in the hope that it will be useful,
  22.  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  23.  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24.  *      GNU General Public License for more details.
  25.  */
  26.  
  27. #if __cplusplus
  28. extern "C" {
  29. #endif
  30.  
  31. #ifndef STRINGH_HEADER_INCLUDED
  32.     #define STRINGH_HEADER_INCLUDED
  33.  
  34.     #if defined(__DEBUG_MALLOC_ENABLED__) && !defined(DONT_REPLACE_STRINGH_MALLOC) // setup.h, helpers\memdebug.c
  35.         APIRET XWPENTRY strhStoreDebug(PSZ *ppszTarget,
  36.                                        PCSZ pcszSource,
  37.                                        PULONG pulLength,
  38.                                        const char *pcszSourceFile,
  39.                                        unsigned long ulLine,
  40.                                        const char *pcszFunction);
  41.         #define strhStore(a, b, c) strhStoreDebug((a), (b), (c), __FILE__, __LINE__, __FUNCTION__)
  42.     #else
  43.         APIRET XWPENTRY strhStore(PSZ *ppszTarget, PCSZ pcszSource, PULONG pulLength);
  44.     #endif
  45.  
  46.     PSZ XWPENTRY strhcpy(PSZ string1, const char *string2);
  47.  
  48.     #if defined(__DEBUG_MALLOC_ENABLED__) && !defined(DONT_REPLACE_STRINGH_MALLOC) // setup.h, helpers\memdebug.c
  49.         PSZ XWPENTRY strhdupDebug(const char *pcszSource,
  50.                                   unsigned long *pulLength,
  51.                                   const char *pcszSourceFile,
  52.                                   unsigned long ulLine,
  53.                                   const char *pcszFunction);
  54.         #define strhdup(a, pul) strhdupDebug((a), (pul), __FILE__, __LINE__, __FUNCTION__)
  55.     #else
  56.         PSZ XWPENTRY strhdup(const char *pcszSource,
  57.                              unsigned long *pulLength);
  58.     #endif
  59.  
  60.     int XWPENTRY strhcmp(const char *p1, const char *p2);
  61.  
  62.     int XWPENTRY strhicmp(const char *p1, const char *p2);
  63.  
  64.     PSZ XWPENTRY strhistr(const char *string1, const char *string2);
  65.  
  66.     ULONG XWPENTRY strhncpy0(PSZ pszTarget,
  67.                              const char *pszSource,
  68.                              ULONG cbSource);
  69.  
  70.     ULONG XWPENTRY strhlen(PCSZ pcsz);
  71.  
  72.     ULONG XWPENTRY strhSize(PCSZ pcsz);
  73.  
  74.     ULONG XWPENTRY strhCount(const char *pszSearch, CHAR c);
  75.  
  76.     BOOL XWPENTRY strhIsDecimal(PSZ psz);
  77.  
  78.     #if defined(__DEBUG_MALLOC_ENABLED__) && !defined(DONT_REPLACE_STRINGH_MALLOC) // setup.h, helpers\memdebug.c
  79.         PSZ XWPENTRY strhSubstrDebug(const char *pBegin,      // in: first char
  80.                                      const char *pEnd,        // in: last char (not included)
  81.                                      const char *pcszSourceFile,
  82.                                      unsigned long ulLine,
  83.                                      const char *pcszFunction);
  84.         #define strhSubstr(a, b) strhSubstrDebug((a), (b), __FILE__, __LINE__, __FUNCTION__)
  85.     #else
  86.         PSZ XWPENTRY strhSubstr(const char *pBegin, const char *pEnd);
  87.     #endif
  88.  
  89.     PSZ XWPENTRY strhExtract(PCSZ pszBuf,
  90.                              CHAR cOpen,
  91.                              CHAR cClose,
  92.                              PCSZ *ppEnd);
  93.  
  94.     PSZ XWPENTRY strhQuote(PSZ pszBuf,
  95.                            CHAR cQuote,
  96.                            PSZ *ppEnd);
  97.  
  98.     ULONG XWPENTRY strhStrip(PSZ psz);
  99.  
  100.     PSZ XWPENTRY strhins(const char *pcszBuffer,
  101.                          ULONG ulInsertOfs,
  102.                          const char *pcszInsert);
  103.  
  104.     ULONG XWPENTRY strhFindReplace(PSZ *ppszBuf,
  105.                                    PULONG pulOfs,
  106.                                    const char *pcszSearch,
  107.                                    const char *pcszReplace);
  108.  
  109.     ULONG XWPENTRY strhWords(PSZ psz);
  110.  
  111.     #define STRH_BEGIN_CHARS    "\x0d\x0a "
  112.     #define STRH_END_CHARS      "\x0d\x0a /-"
  113.  
  114.     BOOL XWPENTRY strhGetWord(PSZ *ppszStart,
  115.                               const char *pLimit,
  116.                               const char *pcszBeginChars,
  117.                               const char *pcszEndChars, //  = "\x0d\x0a /-";
  118.                               PSZ *ppszEnd);
  119.  
  120.     BOOL XWPENTRY strhIsWord(const char *pcszBuf,
  121.                              const char *p,
  122.                              ULONG cbSearch,
  123.                              const char *pcszBeginChars,
  124.                              const char *pcszEndChars);
  125.  
  126.     PSZ XWPENTRY strhFindWord(const char *pszBuf,
  127.                               const char *pszSearch,
  128.                               const char *pcszBeginChars,
  129.                               const char *pcszEndChars);
  130.  
  131.     PSZ XWPENTRY strhFindEOL(const char *pcszSearchIn, ULONG *pulOffset);
  132.  
  133.     PSZ XWPENTRY strhFindNextLine(PSZ pszSearchIn, PULONG pulOffset);
  134.  
  135.     ULONG XWPENTRY strhBeautifyTitle(PSZ psz);
  136.  
  137.     ULONG strhBeautifyTitle2(PSZ pszTarget,
  138.                              PCSZ pcszSource);
  139.  
  140.     PSZ XWPENTRY strhFindAttribValue(const char *pszSearchIn, const char *pszAttrib);
  141.  
  142.     PSZ XWPENTRY strhGetNumAttribValue(const char *pszSearchIn,
  143.                                        const char *pszTag,
  144.                                        PLONG pl);
  145.  
  146.     PSZ XWPENTRY strhGetTextAttr(const char *pszSearchIn, const char *pszTag, PULONG pulOffset);
  147.  
  148.     PSZ XWPENTRY strhFindEndOfTag(const char *pszBeginOfTag);
  149.  
  150.     ULONG XWPENTRY strhGetBlock(const char *pszSearchIn,
  151.                                 PULONG pulSearchOffset,
  152.                                 const char *pszTag,
  153.                                 PSZ *ppszBlock,
  154.                                 PSZ *ppszAttribs,
  155.                                 PULONG pulOfsBeginTag,
  156.                                 PULONG pulOfsBeginBlock);
  157.  
  158.     /* ******************************************************************
  159.      *
  160.      *   Miscellaneous
  161.      *
  162.      ********************************************************************/
  163.  
  164.     VOID XWPENTRY strhArrayAppend(PSZ *ppszRoot,
  165.                                   const char *pcszNew,
  166.                                   ULONG cbNew,
  167.                                   PULONG pcbRoot);
  168.  
  169.     PSZ XWPENTRY strhCreateDump(PBYTE pb,
  170.                                 ULONG ulSize,
  171.                                 ULONG ulIndent);
  172.  
  173.     /* ******************************************************************
  174.      *
  175.      *   Fast string searches
  176.      *
  177.      ********************************************************************/
  178.  
  179.     void* XWPENTRY strhmemfind(const void *in_block,
  180.                                size_t block_size,
  181.                                const void *in_pattern,
  182.                                size_t pattern_size,
  183.                                size_t *shift,
  184.                                BOOL *repeat_find);
  185.  
  186.     char* XWPENTRY strhtxtfind (const char *string,
  187.                                 const char *pattern);
  188.  
  189. #endif
  190.  
  191. #if __cplusplus
  192. }
  193. #endif
  194.  
  195.