stdecnval.c

程序涵盖了设计FIR滤器的各种方法

/*-------------- Telecommunications & Signal Processing Lab ---------------
                             McGill University

Routine:
  int STdecNval (const char String[], int Nmin, int Nmax, int Type, void *Val,
                 int *N)

Purpose:
  Decode numeric values (variable number)

Description:
  This routine decodes a string containing numeric data.  Multiple data items
  data items in the string are separated by commas or white-space (as defined
  by the isspace routine).  The data type can be specified.  If the number of
  data values in the string is less than a given minimum number or a decoding
  error is detected, an error message is printed and an error indication is
  returned.  A warning messages is printed if extra data follows the requested
  values (this data is ignored).

Parameters:
  <-  int STdecNval
      Error status,
        0 - no error
        1 - error, too few values or data format error
	2 - warning, data values too large or too small
   -> const char String[]
      Input string
   -> int Nmin
      Minimum number of values to be read (may be zero)
   -> int Nmax
      Maximum number of values to be read
   -> int Type
      Code for the data type, 'D' for double, 'F' for float, 'I' for int, 'L'
      for long int.
  <-  void *Val
      Array of Nmax elements used to store the decoded values.  Only the first
      N values are modified.
  <-  int *N
      Actual number of values decoded.  In the case of an error, N indicates
      the number of values successfully decoded.  In that case, N may be less
      than Nmin.

Author / revision:
  P. Kabal  Copyright (C) 1999

  $Revision: 1.7 $  $Date: 1999/06/04 22:34:58 $

-------------------------------------------------------------------------*/

static char rcsid[] = "$Id: STdecNval.c 1.7 1999/06/04 FilterDesign-v4r0a $";

#include <string.h>

#include <libtsp.h>
#include <libtsp/nucleus.h>
#include <libtsp/STmsg.h>

#define MAXC	256


int
STdecNval (const char String[], int Nmin, int Nmax, int Type, void *Val,
	   int *N)

{

  char *token;
  int nc, n;
  const char *p;
  int status;
  void *v;
  char cbuf[MAXC+1];

/* Allocate temporary string space */
  nc = strlen (String);
  if (nc > MAXC)
    token = (char *) UTmalloc (nc + 1);
  else
    token = cbuf;

/* Find the substrings */
  p = String;
  n = 0;
  status = 0;
  while	 (p != NULL && n < Nmax) {
    p = STfindToken (p, ",", "", token, 2, nc);
    if (token[0] != '\0') {

      switch (Type) {
      case 'D':
	v = (void *) (((double *) Val) + n);
	break;
      case 'F':
	v = (void *) (((float *) Val) + n);
	break;
      case 'I':
	v = (void *) (((int *) Val) + n);
	break;
      case 'L':
	v = (void *) (((long int *) Val) + n);
	break;
      }

      /* Non-null token string */
      status = STdec1val (token, Type, v);
      if (status == 1)
	break;
      ++n;
    }
    else {
      /* Null token string */
      if (p != NULL || n != 0 || Nmin != 0) {
	status = 1;
	UTwarn ("STdecNval - %s", STM_EmptyData);
      }
      break;
    }
  }

/* Check the number of values found */
  if (status != 1) {
    if (n < Nmin) {
      status = 1;
      UTwarn ("STdecNval - %s", STM_TooFewData);
    }
    if (p != NULL && n >= Nmax)
      UTwarn ("STdecNval - %s", STM_ExtraData);
  }

  if (token != cbuf)
    UTfree ((void *) token);
  *N = n;

  return status;
}