iftsrch.c File Reference

Search functions for IFT contents. More...

#include "libtpcmisc.h"

Go to the source code of this file.

Functions
int	iftGet (IFT *ift, char *key, int verbose)
int	iftGetNth (IFT *ift, char *key, int n, int verbose)
int	iftFindNthKey (IFT *ift, char *str, int n, int verbose)
int	iftFindNthValue (IFT *ift, char *str, int n, int verbose)
int	iftGetFrom (IFT *ift, int si, const char *key, int verbose)
int	iftGetFullmatchFrom (IFT *ift, int si, const char *key, const char *value, int verbose)
int	iftGetFloatValue (IFT *ift, int si, const char *key, float *value, int verbose)
int	iftGetDoubleValue (IFT *ift, int si, const char *key, double *value, int verbose)
int	iftGetIntValue (IFT *ift, int si, const char *key, int *value, int verbose)
int	iftGetKeyNr (IFT *ift, const char *key, int verbose)

Detailed Description

Search functions for IFT contents.

Author

Vesa Oikonen

Definition in file iftsrch.c.

Function Documentation

iftFindNthKey()

int iftFindNthKey	(	IFT *	ift,
		char *	str,
		int	n,
		int	verbose )

Find the Nth item of IFT where the specified string is found in the key. Comparison is case sensitive.

Returns

-1 if key was not found, or other negative value in case of an error, and the index [0..keyNr-1] if matching key is found.

See also

iftFindNthValue, iftGetNth, iftGet, iftGetFrom, iftGetKeyNr, iftRead, iftReplaceNthValue

Parameters

ift	Pointer to IFT structure.
str	Pointer to the case-sensitive (partial) key string.
n	Nth (1..keyNr-1) incidence of value is searched.
verbose	Verbose level; if zero, then only warnings are printed into stderr

Definition at line 84 of file iftsrch.c.

  {
  int li, found_nr=0;
 
  if(verbose>0) printf("%s(*ift, \"%s\", %d)\n", __func__, str, n);
  if(ift==NULL) {return(-10);}
  if(str==NULL || strlen(str)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(n<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  
  /* Search the list */
  for(li=0; li<ift->keyNr; li++) {
    if(strstr(ift->item[li].key, str)!=NULL) {
      found_nr++;
      if(n==found_nr) {iftSetStatus(ift, IFT_OK); return(li);}
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by cptReadOne().

iftFindNthValue()

int iftFindNthValue	(	IFT *	ift,
		char *	str,
		int	n,
		int	verbose )

Find the Nth item of IFT where the specified string is found in the value. Comparison is case sensitive.

Returns

-1 if key was not found, or other negative value in case of an error, and the index [0..keyNr-1] if matching value is found.

See also

iftFindNthKey, iftGetFrom, iftGetKeyNr, iftRead, iftReplaceNthValue

Parameters

ift	Pointer to IFT structure.
str	Pointer to the case-sensitive (partial) value string.
n	Nth (1..keyNr-1) incidence of value is searched..
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 120 of file iftsrch.c.

  {
  int li, found_nr=0;
 
  if(verbose>0) printf("%s(*ift, \"%s\", %d)\n", __func__, str, n);
  if(ift==NULL) {return(-10);}
  if(str==NULL || strlen(str)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(n<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  
  /* Search the list */
  for(li=0; li<ift->keyNr; li++) {
    if(strstr(ift->item[li].value, str)!=NULL) {
      found_nr++;
      if(n==found_nr) {iftSetStatus(ift, IFT_OK); return(li);}
    }
  }
  iftSetStatus(ift, IFT_VALUENOTFOUND);
  return(-1);
}

Referenced by cptReadOne(), and xelRead().

iftGet()

int iftGet	(	IFT *	ift,
		char *	key,
		int	verbose )

Find the key in the IFT and return the index [0..keyNr-1]. Key is case insensitive.

See also

iftGetNth, iftFindNthKey, iftGetFrom, iftGetKeyNr, iftRead, iftReplaceNthValue

Returns

-1 if key was not found, or other negative value in case of an error

Parameters

ift	Pointer to IFT structure.
key	Pointer to the key string; contents are replaced by the correct key string.
verbose	Verbose level; if zero, then only warnings are printed into stderr

Definition at line 15 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0) printf("%s(*ift, \"%s\")\n", __func__, key);
  if(ift==NULL) {return(-10);}
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  
  /* Search the list */
  for(li=0; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      strcpy(key, ift->item[li].key);
      iftSetStatus(ift, IFT_OK); return(li);
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by cptReadOne(), dft_fill_hdr_from_IFT(), ecat7CopyHeadersNoQuant(), imgGetMicropetHeader(), irdRead(), niftiHeaderFromIFT(), tsvRead(), vrdRead(), and xelRead().

iftGetDoubleValue()

int iftGetDoubleValue	(	IFT *	ift,
		int	si,
		const char *	key,
		double *	value,
		int	verbose )

Finds the specified key string from IFT structure, and reads the corresponding value as double.

Returns

Returns the index of key/value, -1 if key or value was not found, and <-1 in case of an error.

See also

iftGetFloatValue, iftGetIntValue, iftRead

Parameters

ift	Pointer to existing IFT.
si	Index [0..keyNr-1] from which the search is started.
key	Pointer to the key string; search is case-insensitive.
value	Pointer to double variable where value is written; NaN is written in case of an error.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 268 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0) printf("%s(*ift, \"%s\", *value)\n", __func__, key);
  if(ift==NULL) {return(-10);}
  if(value==NULL) {iftSetStatus(ift, IFT_FAULT); return(-10);}
  *value=nan("");
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(si<0) {iftSetStatus(ift, IFT_FAULT); return(-12);}
  iftSetStatus(ift, IFT_VALUENOTFOUND);
  /* Search the list */
  for(li=si; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      if(ift->item[li].value==NULL || strlen(ift->item[li].value)<1) return -1;
      (void)sscanf(ift->item[li].value, "%lf", value);
      if(isnan(*value)) return -1;
      iftSetStatus(ift, IFT_OK); return(li);
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by hrrtMakeCalHdr().

iftGetFloatValue()

int iftGetFloatValue	(	IFT *	ift,
		int	si,
		const char *	key,
		float *	value,
		int	verbose )

Finds the specified key string from IFT structure, and reads the corresponding value as float.

See also

iftGetDoubleValue, iftGetIntValue

Returns

Returns the index of key/value, -1 if key or value was not found, and <-1 in case of an error.

Parameters

ift	Pointer to existing IFT.
si	Index [0..keyNr-1] from which the search is started.
key	Pointer to the key string; search is case-insensitive.
value	Pointer to float variable where value is written; NaN is written in case of an error.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 228 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0) printf("%s(*ift, \"%s\", *value)\n", __func__, key);
  if(ift==NULL) {return(-10);}
  if(value==NULL) {iftSetStatus(ift, IFT_FAULT); return(-10);}
  *value=nanf("");
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(si<0) {iftSetStatus(ift, IFT_FAULT); return(-12);}
  iftSetStatus(ift, IFT_VALUENOTFOUND);
  /* Search the list */
  for(li=si; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      if(ift->item[li].value==NULL || strlen(ift->item[li].value)<1) return -1;
      (void)sscanf(ift->item[li].value, "%f", value);
      if(isnan(*value)) return -1;
      iftSetStatus(ift, IFT_OK); return(li);
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by imgGetMicropetHeader(), imgReadMicropetFrame(), niftiHeaderFromIFT(), and upetReadImagedata().

iftGetFrom()

int iftGetFrom	(	IFT *	ift,
		int	si,
		const char *	key,
		int	verbose )

Finds the specified key in the IFT, starting from specified index. Key is case insensitive.

Returns

Returns the index of key/value, -1 if key or value was not found, and <-1 in case of an error.

See also

iftGetFullmatchFrom, iftFindNthValue

Parameters

ift	Pointer to existing IFT.
si	Index [0..keyNr-1] from which the search is started.
key	Pointer to the key string; search is case-insensitive.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 156 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0) printf("%s(*ift, %d, \"%s\")\n", __func__, si, key);
  if(ift==NULL) {return(-10);}
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(si<0) {iftSetStatus(ift, IFT_FAULT); return(-12);}
  
  /* Search the list */
  for(li=si; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      iftSetStatus(ift, IFT_OK); return(li);
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by hrrtMakeCalHdr(), and interfileIsHeader().

iftGetFullmatchFrom()

int iftGetFullmatchFrom	(	IFT *	ift,
		int	si,
		const char *	key,
		const char *	value,
		int	verbose )

Finds the index with specified key and value in the IFT, starting from specified index. Key and value are case insensitive.

Returns

Returns the index of key/value, -1 if key or value was not found, and <-1 in case of an error.

See also

iftGetFrom, iftFindNthValue

Parameters

ift	Pointer to existing IFT.
si	Index [0..keyNr-1] from which the search is started.
key	Pointer to the key string; search is case-insensitive.
value	Pointer to the value string; search is case-insensitive.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 191 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0)  printf("%s(*ift, %d, \"%s\", \"%s\")\n", __func__, si, key, value);
  if(ift==NULL) {return(-10);}
  if(key==NULL) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(value==NULL) {iftSetStatus(ift, IFT_FAULT); return(-12);}
  if(si<0) {iftSetStatus(ift, IFT_FAULT); return(-13);}
  
  /* Search the list */
  for(li=si; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)!=0) continue;
    if(strcasecmp(ift->item[li].value, value)!=0) continue;
    iftSetStatus(ift, IFT_OK); return(li);
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by imgReadMicropetFrame(), and upetReadImagedata().

iftGetIntValue()

int iftGetIntValue	(	IFT *	ift,
		int	si,
		const char *	key,
		int *	value,
		int	verbose )

Finds the specified key string from IFT structure, and reads the corresponding value as int.

Returns

Returns the index of key/value, -1 if key or value was not found, and <-1 in case of an error.

See also

iftGetKeyNr, iftGetDoubleValue

Parameters

ift	Pointer to existing IFT.
si	Index [0..keyNr-1] from which the search is started.
key	Pointer to the key string; search is case-insensitive.
value	Pointer to int variable where value is written; -9999 is written in case of an error.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 309 of file iftsrch.c.

  {
  int li;
 
  if(verbose>0) printf("%s(*ift, \"%s\", *value)\n", __func__, key);
  if(ift==NULL) {return(-10);}
  if(value==NULL) {iftSetStatus(ift, IFT_FAULT); return(-10);}
  *value=-9999;
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(si<0) {iftSetStatus(ift, IFT_FAULT); return(-12);}
  /* Search the list */
  iftSetStatus(ift, IFT_VALUENOTFOUND);
  for(li=si; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      if(ift->item[li].value==NULL || strlen(ift->item[li].value)<1) return -1;
      (void)sscanf(ift->item[li].value, "%d", value);
      if(*value==-9999) return -1;
      iftSetStatus(ift, IFT_OK); return(li);
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by hrrtMakeCalHdr(), imgGetMicropetHeader(), niftiHeaderFromIFT(), and upetReadImagedata().

iftGetKeyNr()

int iftGetKeyNr	(	IFT *	ift,
		const char *	key,
		int	verbose )

Find the nr of occurrences of the specified key in the IFT. Key is case insensitive.

See also

iftFindNthValue

Returns

Returns the nr of occurrences of the key.

Parameters

ift	Pointer to existing IFT
key	Pointer to the key string
verbose	Verbose level; if zero, then only warnings are printed into stderr

Definition at line 350 of file iftsrch.c.

  {
  int li, found_nr=0;
 
  if(verbose>0) printf("%s(*ift, \"%s\")\n", __func__, key);
  if(ift==NULL) {return(0);}
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(0);}
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  
  /* Search the list */
  for(li=0; li<ift->keyNr; li++) if(strcasecmp(ift->item[li].key, key)==0) found_nr++;
  if(found_nr>0) iftSetStatus(ift, IFT_OK);
  else iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(found_nr);
}

iftGetNth()

int iftGetNth	(	IFT *	ift,
		char *	key,
		int	n,
		int	verbose )

Find the Nth key with similar name in the IFT and return the index [0..keyNr-1]. Key is case insensitive.

See also

iftFindNthKey, iftGet, iftGetFrom, iftGetKeyNr, iftRead, iftReplaceNthValue

Returns

-1 if key was not found, or other negative value in case of an error

Parameters

ift	pointer to IFT structure.
key	Pointer to the key string; contents are replaced by the correct key string.
n	Nth (1..) incidence of key is searched.
verbose	Verbose level; if zero, then only warnings are printed into stderr.

Definition at line 48 of file iftsrch.c.

  {
  int li, found_nr=0;
 
  if(verbose>0) printf("%s(*ift, \"%s\", %d)\n", __func__, key, n);
  if(ift==NULL) {return(-10);}
  if(key==NULL || strlen(key)<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  if(n<1) {iftSetStatus(ift, IFT_FAULT); return(-11);}
  
  /* Search the list */
  for(li=0; li<ift->keyNr; li++) {
    if(strcasecmp(ift->item[li].key, key)==0) {
      strcpy(key, ift->item[li].key); found_nr++;
      if(n==found_nr) {iftSetStatus(ift, IFT_OK); return(li);}
    }
  }
  iftSetStatus(ift, IFT_KEYNOTFOUND);
  return(-1);
}

Referenced by dft_fill_hdr_from_IFT(), and tsvRead().