stringext.c File Reference

String processing functions. More...

#include "tpcclibConfig.h"
#include "tpcextensions.h"
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <time.h>
#include <string.h>
#include <strings.h>
#include <ctype.h>

Go to the source code of this file.

Functions
int	strTokenNr (const char *s1, const char *s2)
int	strTokenNCpy (const char *s1, const char *s2, int i, char *s3, int count)
int	strChrCount (const char *s1, const char *s2)
int	strUppercaseCount (const char *s)
void	strReplaceChar (char *s, char c1, char c2)
char *	strcasestr (const char *haystack, const char *needle)
char *	strdup (const char *s)
char *	strndup (const char *s, size_t n)
char *	strstrNoQuotation (const char *haystack, const char *needle)
int	strncpyCleanSpaces (char *s1, const char *s2, int maxlen)
int	strCleanSpaces (char *s)
int	strncpyClean (char *s1, const char *s2, int maxlen)
int	strClean (char *s)
char *	strTokenDup (const char *s1, const char *s2, int *next)
int	strInPars (char *s)
void	strCleanPars (char *s)
char *	strncatInt (char *str1, const int n, size_t count)
char *	strncatDouble (char *str1, const double d, size_t count)
char *	strncatIntZ (char *str1, const int n, const int maxn, size_t count)
size_t	strnlen (const char *s, size_t n)
size_t	strlcat (char *dst, const char *src, size_t dstsize)
size_t	strlcpy (char *dst, const char *src, size_t dstsize)
int	strIsSpaceOnly (char *s)
char *	strdelstr (char *s1, const char *s2)
char *	strTrimLeft (char *s, const size_t t)
char *	strEncodeForXML (const char *s)
void	strCleanForXML (char *s)

Detailed Description

String processing functions.

Definition in file stringext.c.

Function Documentation

strcasestr()

char * strcasestr	(	const char *	haystack,
		const char *	needle )

Case-insensitive version of strstr().

Returns

a pointer to the beginning of the first occurrence, or NULL if not found.

See also

strdelstr, strstrNoQuotation

Parameters

haystack	Pointer to string in which sub-string needle is searched.
needle	Pointer to sub-string which is searched for in source string haystack.

Definition at line 155 of file stringext.c.

  {
  if(!haystack || !*haystack || !needle || !*needle) return 0;
 
  const char *s=haystack, *p=needle;
  do {
    if(!*p) return(char*)haystack;
    if((*p==*s) || (tolower(*p)==tolower(*s))) {
      p++; s++;
    } else {
      p=needle; if(!*s) return(NULL);
      s=++haystack;
    }
  } while(1);
  return *p ? NULL : (char*)haystack;
}

Referenced by csvSearchField(), dcmImgIsotope(), dcmMListRead(), elementIdentify(), iftSearchKey(), iftSearchValue(), imgFormatFromFName(), parFormatFromExtension(), parReadRES(), parWriteRES(), strdelstr(), tacReadInveonCSV(), tacSelectBestReference(), tacWritePMOD(), tacWriteXML(), and unitIdentifyFilename().

strChrCount()

int strChrCount	(	const char *	s1,
		const char *	s2 )

Count how many times characters specified in string s2 are found in string s1.

Search is case-sensitive.

Author

Vesa Oikonen

Returns

Returns the nr of characters of s2 found in s1.

See also

strReplaceChar, strstrNoQuotation, strUppercaseCount

Parameters

s1	String to search for characters; not modified.
s2	String containing characters which are searched for; not modified.

Definition at line 98 of file stringext.c.

  {
  unsigned int n=0, i, j;
  if(s1==NULL || s2==NULL || strlen(s1)==0 || strlen(s2)==0) return (int)n;
  for(i=0; i<strlen(s1); i++)
    for(j=0; j<strlen(s2); j++)
      if(s1[i]==s2[j]) n++;
  return (int)n;
}

Referenced by strncpyClean().

strClean()

int strClean

(

char *

s

)

Removes any initial and trailing space characters from specified string s. Removes also quotation marks ("" or '') that may be around the string s. Quotes or space characters in the middle of the string are not removed.

Returns

0 when successful, otherwise >0.

Author

Vesa Oikonen

See also

strncpyCleanSpaces, strCleanSpaces, strIsSpaceOnly, strCleanPars

Parameters

s	Pointer to the string.

Definition at line 389 of file stringext.c.

  {
  if(s==NULL) return 0;
  int len=strlen(s); if(len<0) return 0;
  char *s2; s2=calloc(len+1, sizeof(char)); if(s2==NULL) return(1);
  int n=strncpyClean(s2, s, len+1);
  if(n<1) strcpy(s, ""); else strcpy(s, s2);
  free(s2);
  return 0;
}

Referenced by iftPutFromString(), iftPutFromStringWithSpaceSeparator(), imgReadDICOM(), tacNameSplit(), and tacRead4DM().

strCleanForXML()

void strCleanForXML

(

char *

s

)

Remove from string those characters that would require encoding in XML. Replaced by character '-'.

See also

strEncodeForXML

Parameters

s	Pointer to the string to be cleaned.

Definition at line 769 of file stringext.c.

  {
  if(s==NULL || *s=='\0') return;
  strReplaceChar(s, '&', '-');
  strReplaceChar(s, '\'', '-');
  strReplaceChar(s, '\"', '-');
  strReplaceChar(s, '<', '-');
  strReplaceChar(s, '>', '-');
  return;
}

strCleanPars()

void strCleanPars

(

char *

s

)

Remove parenthesis (s), [s], or {s} from around the string s.

Only one set of pars are removed, and only if the same pars are as the first and last character of the string.

Precondition

If necessary, remove possible spaces or quotation marks before this.

See also

strInPars, strCleanSpaces

Author

Vesa Oikonen

Parameters

s	Pointer to the string.

Definition at line 476 of file stringext.c.

  {
  if(s==NULL || strInPars(s)==0) return;
  int len=strlen(s);
  s[--len]=(char)0;
  for(int i=1; i<=len; i++) s[i-1]=s[i];
  return;
}

Referenced by iftGetDoubleWithUnit(), tacRead4DM(), tacReadCarimasTxt(), and tacReadDFT().

strCleanSpaces()

int strCleanSpaces

(

char *

s

)

Removes any initial and trailing space characters from specified string s. Space characters in the middle of the string are not removed.

Returns

0 when successful, otherwise >0.

Author

Vesa Oikonen

See also

strClean, strncpyClean, strncpyCleanSpaces, strIsSpaceOnly

Parameters

s	Pointer to the string.

Definition at line 300 of file stringext.c.

  {
  if(s==NULL) return 0;
  int len=strlen(s); if(len<0) return 0;
  char *s2; s2=strdup(s); if(s2==NULL) return(1);
  int n=strncpyCleanSpaces(s2, s, len+1);
  if(n<1) strcpy(s, ""); else strcpy(s, s2);
  free(s2);
  return 0;
}

Referenced by csvCleanSpaces(), dcmImgIsotope(), and strncpyClean().

strdelstr()

char * strdelstr	(	char *	s1,
		const char *	s2 )

Find (case-insensitive) s2 in s1, and delete it from s1.

Returns

Returns pointer to s1 at where the deletion stopped, or to the start of s1 in case s2 was not found.

See also

strReplaceChar, strClean, strTrimleft

Parameters

s1	Pointer to string in which sub-string s2 is searched; modified.
s2	Pointer to sub-string which is searched for in source string s1.

Definition at line 688 of file stringext.c.

  {
  if(s1==NULL || s2==NULL) return(s1); //printf("strdelstr('%s', '%s')\n", s1, s2);
  int n=strlen(s2); if(n<1) return(s1);
  char *cptr, *rptr;
  cptr=strcasestr(s1, s2);
  if(cptr==NULL || *cptr==(char)0) return(s1);
  rptr=cptr;
  while(*cptr) {*cptr=cptr[n]; cptr++;}
  return(rptr);
}

strdup()

char * strdup

(

const char *

s

)

Allocates memory and copies into it the string addressed by s, including the terminating character.

Postcondition

Remember to free the memory from the returned pointer after last use.

Returns

pointer to allocated string, or NULL in case of error.

Parameters

s	String to be duplicated.

Definition at line 185 of file stringext.c.

  {
  if(s==NULL) return NULL;
  size_t length=strlen(s)+1;
  void *r;
  r=calloc(length, sizeof(char)); if(r==NULL) return NULL;
  return (char*)memcpy(r, s, length);
}

Referenced by atofCheck(), atofVerified(), csvCellReplace(), csvDuplicate(), csvPutString(), dcmFileList(), dcmMListRead(), iftPut(), iftPutFromString(), iftPutFromStringWithSpaceSeparator(), iftReplaceKey(), iftReplaceValue(), parCombineTACs(), parCompareParameterNames(), parCompareTacNames(), parSelectByAnother(), pathCreate(), pathExist(), roinameSubpart(), statusSet(), strCleanSpaces(), strTokenDup(), studynrFromFilename(), tacNameSplit(), tacRead(), tacReadCarimasTxt(), tacReadCSV(), tacReadDFT(), tacReadHRRTHC(), tacReadPMOD(), tpcHtmlUsage(), tpcPrintBuild(), tpcPrintUsage(), and tpcProgramName().

strEncodeForXML()

char * strEncodeForXML

(

const char *

s

)

Encode special characters for XML, including SVG.

Postcondition

Free the memory of returned string pointer.

Returns

Returns pointer to encoded string. NULL is returned in case of an error, or if encoding is not necessary.

See also

strCleanForXML

Parameters

s	Pointer to the string to be encoded.

Definition at line 731 of file stringext.c.

  {
  if(s==NULL) return(NULL);
  /* Count the characters needing encoding */
  int n=0;
  for(size_t i=0; i<strlen(s); i++) {
    if(s[i]=='&') {n++; continue;}
    if(s[i]=='\'') {n++; continue;}
    if(s[i]=='\"') {n++; continue;}
    if(s[i]=='<') {n++; continue;}
    if(s[i]=='>') {n++; continue;}
  }
  if(n==0) return(NULL);
  /* Allocate memory for new string (one char to max 6 chars) */
  n*=5; n+=strlen(s)+1;
  char *ns=(char*)malloc(n*sizeof(char));
  if(ns==NULL) return(NULL);
  /* Process the string */
  for(int i=0; i<n; i++) ns[i]=(char)0;
  for(size_t i=0; i<strlen(s); i++) {
    if(s[i]=='&') {strcat(ns, "&amp;"); continue;}
    if(s[i]=='\'') {strcat(ns, "&apos;"); continue;}
    if(s[i]=='\"') {strcat(ns, "&quot;"); continue;}
    if(s[i]=='<') {strcat(ns, "&lt;"); continue;}
    if(s[i]=='>') {strcat(ns, "&gt;"); continue;}
    ns[strlen(ns)]=s[i];
  }
  return(ns);
}

Referenced by parWriteXML(), and tacWriteXML().

strInPars()

int strInPars

(

char *

s

)

Checks whether string is inside parenthesis (s), [s], or {s}, that is, the same pars as the first and last character of the string.

Precondition

If necessary, remove possible spaces or quotation marks before this.

Returns

0 if not in pars, 1 if inside pars.

Author

Vesa Oikonen

See also

strCleanPars, strCleanSpaces, strIsValidNumber

Parameters

s	Pointer to the string.

Definition at line 453 of file stringext.c.

  {
  if(s==NULL) return 0;
  int len=strlen(s); if(len<2) return 0;
  if(s[0]=='(' && s[len-1]==')') return 1;
  if(s[0]=='{' && s[len-1]=='}') return 1;
  if(s[0]=='[' && s[len-1]==']') return 1;
  return 0;
}

Referenced by strCleanPars(), and tacReadDFT().

strIsSpaceOnly()

int strIsSpaceOnly

(

char *

s

)

Checks whether string contains only space characters.

Text files saved in text editor or Excel may accidentally contain empty looking lines which still may contain tabs and spaces, leading to problems when reading them for example as CSV files.

Returns

0 if lines contains something more than spaces, 1 if only space characters or string is empty.

Author

Vesa Oikonen

See also

strClean, strncpyCleanSpaces

Parameters

s	Pointer to the string.

Definition at line 671 of file stringext.c.

  {
  if(s==NULL) return(1);
  int len=strlen(s); if(len<1) return(1);
  for(int i=0; i<len; i++) if(!isspace(s[i])) return(0);
  return 1;
}

Referenced by csvRead().

strlcat()

size_t strlcat	(	char *	dst,
		const char *	src,
		size_t	dstsize )

Safer version of strncat.

At most dstsize-1 characters are appended from the source string to destination string. Destination string will be NUL terminated, unless dstsize <= strlen(dst).

Remarks

Included in POSIX but not in GCC.

Returns

the size of the buffer that would have been needed for the destination string; if >=dstsize, then truncation occurred.

Parameters

dst	Destination string.
src	Source string.
dstsize	The actual length of buffer allocated for the destination string; for example, destination string has been allocated as char dst[dstsize];

Definition at line 592 of file stringext.c.

  {
  char *d;
  const char *s=src;
  size_t dlen, n;
 
  /* Find the current length of dst */
  dlen=strnlen(dst, dstsize);
  if(s==NULL) return(dlen);
  n=dstsize-dlen;
  if(n==0) return(dlen+strlen(s));
  d=dst+dlen;
  while(*s!='\0') {
    if(n!=1) {*d=*s; d++; n--;}
    s++;
  }
  *d='\0';
  return(dlen+(s-src));
}

Referenced by fileBackup(), micropetExists(), parReadFIT(), parReadRES(), roinameAddField(), roinameEditByTemplate(), roinameSubpart(), and tpcProgramName().

strlcpy()

size_t strlcpy	(	char *	dst,
		const char *	src,
		size_t	dstsize )

Safer version of strncpy or strcpy.

At most dstsize-1 characters are copied from the source string to destination string. Destination string will be NUL terminated.

Remarks

Included in POSIX but not in GCC.

Returns

the size of the buffer that would have been needed for the destination string; if >=dstsize, then truncation occurred.

Parameters

dst	Destination string.
src	Source string.
dstsize	The actual length of buffer allocated for the destination string; for example, destination string has been allocated as char dst[dstsize];

Definition at line 632 of file stringext.c.

  {
  if(dstsize>0) dst[0]='\0';
  if(strlen(src)==0) return(0);
 
  char *d=dst;
  const char *s=src;
  size_t n;
 
  /* Copy as many chars as allowed */
  n=dstsize;
  if(n!=0) while(--n!=0) {*d=*s; if(*d=='\0') {d++; s++; break;} d++; s++;}
  if(n==0) { // not enough space, add NUL, and check how much space were needed
    if(dstsize!=0) *d='\0';
    while(*s++) {}
  }
  return(s-src-1);
}

Referenced by abssWrite(), anaExists(), dcmAddItem(), dcmFileRead(), dcmMListRead(), dcmSameImage(), ecatReadMainheader(), ecatWriteMainheader(), fileBackup(), imgCopyHeader(), imgSetNiftiHeader(), imgWriteNifti(), micropetExists(), niftiCreateFNames(), niftiExists(), parReadCSV(), parReadFIT(), parReadRES(), parWriteFIT(), roinameAddField(), strDateRead(), strDateTimeValid(), strncpyClean(), strncpyCleanSpaces(), strTokenDup(), strTokenNCpy(), studynrFromFilename(), tacGetHeaderIsotope(), tacGetHeaderStudynr(), tacNameSplit(), tacRead4DM(), tacReadCarimasTxt(), tacReadCSV(), tacReadDFT(), tacReadInveonCSV(), tacReadMat(), tacReadOldAllogg(), tacReadPMOD(), tacReadQView(), tacReadSIF(), tacReadSimple(), and tpcProgramName().

strncatDouble()

char * strncatDouble	(	char *	str1,
		const double	d,
		size_t	count )

Concatenate not more than count characters of the string representation of double d to the string pointed to by str1. String is terminated with a null.

See also

strncatInt

Returns

Pointer to str1.

Parameters

str1	String to be catenated.
d	Double value to be catenated as string into str1.
count	No more than count characters are concatenated to str1. If str1 was allocated like char str1[MAX_LEN], then set count=MAX_LEN-strlen(str1)-1.

Definition at line 517 of file stringext.c.

  {
  char tmp[128]; sprintf(tmp, "%g", d);
  return strncat(str1, tmp, count);
}

strncatInt()

char * strncatInt	(	char *	str1,
		const int	n,
		size_t	count )

Concatenate not more than count characters of the string representation of integer n to the string pointed to by str1. String is terminated with a null.

See also

strncatDouble, strncatIntZ, strIsValidNumber

Returns

Pointer to str1.

Parameters

str1	String to be catenated.
n	Integer value to be catenated as string into str1.
count	No more than count characters are concatenated to str1. If str1 was allocated like char str1[MAX_LEN], then set count=MAX_LEN-strlen(str1)-1.

Definition at line 495 of file stringext.c.

  {
  char tmp[128]; sprintf(tmp, "%d", n);
  return strncat(str1, tmp, count);
}

strncatIntZ()

char * strncatIntZ	(	char *	str1,
		const int	n,
		const int	maxn,
		size_t	count )

Concatenate not more than count characters of the zero-padded string representation of integer n to the string pointed to by str1. String is terminated with a null.

See also

strncatInt, strncatDouble

Returns

Pointer to str1.

Parameters

str1	String to be catenated.
n	Integer value to be catenated as string into str1.
maxn	Integer value which is large enough that it would not need to be zero-padded.
count	No more than count characters are concatenated to str1. If str1 was allocated like char str1[MAX_LEN], then set count=MAX_LEN-strlen(str1)-1.

Definition at line 539 of file stringext.c.

  {
  if(n<0) strncat(str1, "-", count);
  char tmp[128]; sprintf(tmp, "%d", abs(maxn));
  int len=strlen(tmp);
  sprintf(tmp, "%0*d", len, abs(n));
  return strncat(str1, tmp, count);
}

strncpyClean()

int strncpyClean	(	char *	s1,
		const char *	s2,
		int	maxlen )

Version of strncpy() which as usual copies s2 to s1, but without any quotation marks ("" or ''), space characters, or line end characters that may be around the string s2.

Returns

the length of the new string s1.

Author

Vesa Oikonen

See also

strncpyCleanSpaces, strCleanSpaces, strClean, strIsSpaceOnly, strstrNoQuotation

Parameters

s1	Pointer to pre-allocated result string with length of at least maxlen characters, including NULL character.
s2	Pointer to the original string.
maxlen	Max length of s1, including the trailing zero.

Definition at line 321 of file stringext.c.

  {
  if(s1==NULL) return(0);
  s1[0]=(char)0; if(maxlen<1) return(0);
  if(maxlen<2) {strcpy(s1, ""); return(0);}
  if(s2==NULL || strlen(s2)<1) return(0);
 
  char *tmp;
  int i, sqn, dqn, m;
 
  /* Allocate temp string */
  tmp=calloc(strlen(s2)+1, sizeof(char));
 
  /* Trim space characters */
  i=strncpyCleanSpaces(tmp, s2, strlen(s2)+1);
  if(i<1) {strcpy(s1, ""); free(tmp); return(0);}
 
  /* Loop as long as there is something to trim */
  i=1;
  while(i) {
    m=0; // nothing modified so far  
    /* Count quotes */
    sqn=strChrCount(tmp, "\'");
    dqn=strChrCount(tmp, "\"");
    if(sqn==0 && dqn==0) {i=0; break;}
    /* Trim matching quotation marks */
    if(dqn>=2 && tmp[0]=='\"' && tmp[strlen(tmp)-1]=='\"') {
      tmp[0]=' '; tmp[strlen(tmp)-1]=(char)0; dqn-=2; m+=2;
    }
    if(sqn>=2 && tmp[0]=='\'' && tmp[strlen(tmp)-1]=='\'') {
      tmp[0]=' '; tmp[strlen(tmp)-1]=(char)0; sqn-=2; m+=2;
    }
    /* Trim orphan quotation marks */
    if(sqn%2) {
      if(tmp[0]=='\'') {tmp[0]=' '; sqn--; m++;}
      else if(tmp[strlen(tmp)-1]=='\'') {tmp[strlen(tmp)-1]=(char)0; sqn--; m++;}
    }
    if(dqn%2) {
      if(tmp[0]=='\"') {tmp[0]=' '; dqn--; m++;}
      else if(tmp[strlen(tmp)-1]=='\"') {tmp[strlen(tmp)-1]=(char)0; dqn--; m++;}
    }
    /* If nothing was modified, then do not continue */
    if(m==0) {i=0; break;}
    /* Trim spaces, quit if error encountered */
    if(strCleanSpaces(tmp)) i=0;
  }
 
  strlcpy(s1, tmp, maxlen);
  free(tmp);
  return(strlen(s1));
}

Referenced by imgReadDICOM(), parSelectParameters(), parSelectTACs(), strClean(), and tacSelectTACs().

strncpyCleanSpaces()

int strncpyCleanSpaces	(	char *	s1,
		const char *	s2,
		int	maxlen )

Version of strncpy() which as usual copies s2 to s1, but without any space characters or line end characters that may be around the string s2.

Returns

the length of the new string s1.

Author

Vesa Oikonen

See also

strCleanSpaces, strncpyClean, strIsSpaceOnly

Parameters

s1	Pointer to pre-allocated result string with length of at least maxlen characters, including NULL character.
s2	Pointer to the original string.
maxlen	Max length of s1, including the trailing zero.

Definition at line 265 of file stringext.c.

  {
  if(s1==NULL) return(0);
  s1[0]=(char)0; if(maxlen<1) return(0);
  if(maxlen<2) {strcpy(s1, ""); return(0);}
  if(s2==NULL || strlen(s2)<1) return(0);
 
  char *cptr;
  int i;
 
  cptr=(char*)s2; cptr+=strspn(s2, "\t\n\r ");
  strlcpy(s1, cptr, maxlen); i=strlen(s1); if(i<1) return(0);
  cptr=s1+(i-1);
  while(i>0) {
    if(*cptr!='\t' && *cptr!='\n' && *cptr!='\r' && *cptr!=' ') break;
    i--; s1[i]=(char)0; cptr--;
  }
  return(i);
}

Referenced by niftiBasename(), parReadFIT(), strCleanSpaces(), strncpyClean(), and tacRead4DM().

strndup()

char * strndup	(	const char *	s,
		size_t	n )

Allocates memory and copies into it first n characters from string addressed by s, and adds the terminating character.

Postcondition

Remember to free the memory from the returned pointer after last use.

Returns

pointer to allocated string, or NULL in case of error.

Parameters

s	String to be duplicated.
n	Max nr of characters to copy, not including terminal zero.

Definition at line 205 of file stringext.c.

  {
  size_t length=strnlen(s, n);
  void *r; r=calloc(length+1, sizeof(char)); if(r==NULL) return NULL;
  return (char*)memcpy(r, s, length);
}

Referenced by csvPutLine(), csvPutLineWithSpaces(), iftPutFromString(), iftPutFromStringWithSpaceSeparator(), and tpcProgramName().

strnlen()

size_t strnlen	(	const char *	s,
		size_t	n )

Safer version of strlen, in case the argument s is not NUL terminated string. Computes the length of string s, but never scans beyond the n first bytes of the string.

Remarks

Included in POSIX and GCC, so this implementation may not be needed.

Returns

same as strlen() or n, whicever is smaller.

Parameters

s	Pointer to string, or character array, that may not be NULL terminated.
n	The actual length of buffer allocated for the string; for example, string could have been allocated as char s[n];

Definition at line 566 of file stringext.c.

  {
  if(s==NULL) return(0);
  char *ps=(char*)s;
  size_t i=0;
  while(i<n && *ps!='\0') {i++; ps++;}
  return(i);
}

Referenced by abssIdFromFName(), anaExists(), anaReadHeader(), atoiCheck(), dcmAddItem(), dcmDA2intl(), dcmDT2intl(), dcmFileList(), dcmFileRead(), dcmFileRemove(), dcmFileWrite(), dcmSOPIdentify(), dcmSOPUIDName(), dcmTM2intl(), dcmTrUID(), elementIdentify(), fileExist(), filenameGetExtension(), filenameGetExtensions(), filenameRmExtension(), filenameRmExtensions(), filenameRmFile(), filenameRmPath(), imgFormatFromFName(), imgRead(), imgReadDICOM(), imgReadNifti(), imgWrite(), imgWriteDICOM(), imgWriteNifti(), isotopeIdentify(), micropetExists(), micropetHeaderRead(), mtgaPlotSVG(), niftiExists(), niftiReadHeader(), niftiWriteHeader(), parCombineTACs(), parSelectByAnother(), parWriteFIT(), pathCreate(), pathFileList(), pathFileNr(), roinameMatch(), roinameSubpart(), strDateRead(), strDateTimeValid(), strDateValid(), strDateValid2(), strDateValid3(), strIsValidNumber(), strlcat(), strndup(), strTimeValid(), strTokenNr(), studynrFromFilename(), tacPlotFitSVG(), tacPlotHistogramSVG(), tacPlotLineSVG(), tacReadAllogg(), tacReadGEMS(), tacReadMat(), tacReadModelingData(), tacReadModelingInput(), tacReadOldAllogg(), tacReadQView(), tacReadReference(), tacReadScanditronics(), tpcHtmlUsage(), tpcProcessStdOptions(), tpcProgramName(), tpcYesNo(), unitIdentify(), and unitIdentifyFilename().

strReplaceChar()

void strReplaceChar	(	char *	s,
		char	c1,
		char	c2 )

Replace all characters c1 in string s with character c2.

See also

strChrCount, strdelstr, strTrimleft, strstrNoQuotation

Author

Vesa Oikonen

Parameters

s	Pointer to string in which the character is replaced.
c1	Character to be replaced.
c2	Character to use instead. If NULL, then only the first character is replaced.

Definition at line 134 of file stringext.c.

  {
  char *cptr;
  if(s==NULL || strlen(s)==0) return;
  while((cptr=strchr(s, c1))!=NULL) *cptr=c2;
  return;
}

Referenced by csvPutDouble(), parCombineTACs(), parCompareParameterNames(), parCompareTacNames(), parSelectByAnother(), parToIFT(), strCleanForXML(), and tacWritePMOD().

strstrNoQuotation()

char * strstrNoQuotation	(	const char *	haystack,
		const char *	needle )

Version of strstr() which ignores any matches inside quotation marks "" or ''.

Returns

a pointer to the beginning of the first occurrence, or NULL if not found.

Author

Vesa Oikonen

Remarks

This function is an enhanced version of the one from libtpcmisc.

See also

strClean, strCleanSpaces

Parameters

haystack	Pointer to string to be searched.
needle	Pointer to string with quotation marks.

Definition at line 225 of file stringext.c.

  {
  if(haystack==NULL) return((char*)NULL);
  if(needle==NULL) return((char*)haystack);
 
  size_t i, test_len;
  int single_quotation=0;
  int double_quotation=0;
  char *cptr;
  
  test_len=strlen(needle); if(test_len<1) return((char*)haystack);
  for(i=0, cptr=(char*)haystack; i<strlen(haystack); i++, cptr++) {
    if(*cptr=='\'') {
      if(single_quotation==0 && strchr(cptr+1, '\'')!=NULL) single_quotation=1;
      else single_quotation=0;
      continue;
    }
    if(*cptr=='\"') {
      if(double_quotation==0 && strchr(cptr+1, '\"')!=NULL) double_quotation=1;
      else double_quotation=0;
      continue;
    }
    if(single_quotation==1 || double_quotation==1) continue;
    if(strncmp(cptr, needle, test_len)==0) return(cptr);
  }
  return((char*)NULL);
}

Referenced by csvRead(), iftPutFromString(), and iftPutFromStringWithSpaceSeparator().

strTokenDup()

char * strTokenDup	(	const char *	s1,
		const char *	s2,
		int *	next )

Search the string s1 for the first token. The characters making up the string s2 are the delimiters that determine the tokens.

Returns

Returns pointer to a copy of the token string, or NULL in case of an error or if no token found.

Postcondition

Remember to free the memory from the returned pointer after last use.

Author

Vesa Oikonen

See also

strTokenNCpy, strstrNoQuotation

Parameters

s1	String from where tokens are searched; not modified in any way.
s2	String containing character delimiters.
next	Index of s1 where the token ended; set to NULL, if not needed.

Definition at line 413 of file stringext.c.

  {
  if(next!=NULL) *next=0;
  if(s1==NULL) return NULL;
 
  char *s3=NULL, *cptr;
  size_t j;
  
  /* If no delimiters, then return copy of s1 */
  if(s2==NULL || strlen(s2)<1) {
    s3=strdup(s1); if(next!=NULL) *next=strlen(s1);
    return s3;
  } 
  /* Pass initial delimiter characters */
  cptr=(char*)s1; j=strspn(cptr, s2); cptr+=j; if(next!=NULL) *next=j;
  /* calculate characters between delimiters */
  j=strcspn(cptr, s2); if(j==0) {return NULL;}
  if(next!=NULL) *next+=j;
  /* Allocate space for token */
  s3=calloc(j+1, sizeof(char)); if(s3==NULL) return NULL;
  strlcpy(s3, cptr, j+1);
  return s3;
}

Referenced by csvRead(), iftRead(), tacFormatDetermine(), and tacRead4DM().

strTokenNCpy()

int strTokenNCpy	(	const char *	s1,
		const char *	s2,
		int	i,
		char *	s3,
		int	count )

Copy the i'th token in the string s1 into string s3. The characters making up the string s2 are the delimiters that determine the tokens.

See also

strTokenNr, strTokenDup

Returns

Returns the length of token, 0 if no token(s) found.

Author

Vesa Oikonen

Parameters

s1	String from where tokens are searched; not modified in any way.
s2	String containing character delimiters.
i	Token number to copy (1..nr of tokens).
s3	String array into where the token is copied; string will be null terminated.
count	Length of s3, including terminal null.

Definition at line 53 of file stringext.c.

  {
  int j=0, n=0;
  char *cptr;
  if(s3!=NULL && count>0) s3[0]=(char)0;
  if(s1==NULL || s2==NULL || strlen(s1)==0 || strlen(s2)==0) return(0);
  if(i<1 || s3==NULL || count<2) return(0);
 
  cptr=(char*)s1;
  do {
    // pass delimiter characters
    j=strspn(cptr, s2); cptr+=j;
    // pass characters between delimiters
    j=strcspn(cptr, s2); if(j>0) n++;
    // if this is the required token nr, then stop here
    if(n==i) {
      if(j>count-1) j=count-1;
      strlcpy(s3, cptr, j+1); //strncpy(s3, cptr, j); s3[j]=(char)0;
      break;
    }
    cptr+=j;
  } while(j>0);
  if(n>i) {s3[0]=(char)0; return(0);}
  return(j);
}

Referenced by atofList(), doubleGetWithUnit(), floatGetWithUnit(), iftGetDoubleWithUnit(), intlistAddFromString(), intlistExpandFromString(), parFromIFT(), parReadCSV(), parReadRES(), and tacReadSIF().

strTokenNr()

int strTokenNr	(	const char *	s1,
		const char *	s2 )

Calculate the number of tokens in the string s1. The characters making up the string s2 are the delimiters that determine the token.

See also

strTokenNCpy, strTokenDup

Returns

Returns the nr of tokens.

Author

Vesa Oikonen

Parameters

s1	String from where tokens are calculated; not modified in any way.
s2	String containing character delimiters.

Definition at line 25 of file stringext.c.

  {
  int i=0, n=0;
  char *cptr;
  if(s1==NULL || s2==NULL || strnlen(s1, 1)==0 || strnlen(s2, 1)==0) return(0);
 
  cptr=(char*)s1;
  do {
    // pass delimiter characters
    i=strspn(cptr, s2); cptr+=i;
    // pass characters between delimiters
    i=strcspn(cptr, s2); cptr+=i; if(i>0) n++; 
  } while(i>0);
  return(n);
}

Referenced by atofList(), doubleGetWithUnit(), floatGetWithUnit(), intlistAddFromString(), intlistExpandFromString(), parFromIFT(), parReadRES(), and tacNameSplit().

strTrimLeft()

char * strTrimLeft	(	char *	s,
		const size_t	t )

Strip string of t characters from the left.

Returns

Returns pointer to the string.

See also

filenameGetExtension

Parameters

s	Pointer to the string to be trimmed. Overwritten.
t	Number of characters to remove.

Definition at line 710 of file stringext.c.

  {
  if(s==NULL || t==0) return(s);
  size_t len=strlen(s); if(len<1) return(s);
  if(t>=len) {s[0]=(char)0; return(s);}
  memmove(s, s+t, 1+len-t);
  return(s);
}

strUppercaseCount()

int strUppercaseCount

(

const char *

s

)

Count how many upper case characters are found in string.

Returns

Returns the nr of upper case characters found in s.

See also

strChrCount

Parameters

s	String to search for upper case characters; not modified.

Definition at line 118 of file stringext.c.

  {
  unsigned int n=0, i;
  if(s==NULL || strlen(s)==0) return (int)n;
  for(i=0; i<strlen(s); i++) if(isupper(s[i])) n++;
  return (int)n;
}