match_string.c File Reference

Provides functions for matching strings with various matching modes. More...

#include "match_string.h"
#include "mdb.h"
#include <ctype.h>

Go to the source code of this file.

Functions
long	match_string (char *string, char **option, long n_options, long mode)
	Matches a given string against an array of option strings based on specified modes.
int	strcmp_case_insensitive (char *s1, char *s2)
	Compares two strings in a case-insensitive manner.
int	strncmp_case_insensitive (char *s1, char *s2, long n)
	Compares up to a specified number of characters of two strings in a case-insensitive manner.

Detailed Description

Provides functions for matching strings with various matching modes.

Copyright

• (c) 2002 The University of Chicago, as Operator of Argonne National Laboratory.
• (c) 2002 The Regents of the University of California, as Operator of Los Alamos National Laboratory.

License

This file is distributed under the terms of the Software License Agreement found in the file LICENSE included with this distribution.

Author

M. Borland, C. Saunders, R. Soliday

Definition in file match_string.c.

Function Documentation

match_string()

long match_string	(	char *	string,
		char **	option,
		long	n_options,
		long	mode )

Matches a given string against an array of option strings based on specified modes.

This function searches for a match of the input string within the provided array of option strings. It supports different matching modes such as wildcard matching, case sensitivity, and whole string matching. Depending on the mode flags, it can return the first match or indicate ambiguity.

Parameters

string	The string to find a match for.
option	The array of strings to match against.
n_options	The number of option strings in the array.
mode	Flags that determine the matching behavior (e.g., WILDCARD_MATCH, MATCH_WHOLE_STRING, CASE_SENSITIVE, RETURN_FIRST_MATCH).

Returns

The index of the matching string in the options array, or -1 if no match is found or if multiple matches exist when ambiguity is not allowed.

Definition at line 34 of file match_string.c.

  {
  register long i, i_match, l;
 
  if (string == NULL)
    return (-1);
 
  if (mode & WILDCARD_MATCH) {
    for (i = 0; i < n_options; i++)
      if (wild_match(string, option[i]))
        return i;
    return -1;
  }
 
  if (!(mode & MATCH_WHOLE_STRING)) {
    l = strlen(string);
    i_match = -1;
    if (mode & CASE_SENSITIVE) {
      for (i = 0; i < n_options; i++) {
        if (strncmp(string, option[i], l) == 0) {
          if (mode & RETURN_FIRST_MATCH)
            return (i);
          if (i_match != -1)
            return (-1);
          i_match = i;
        }
      }
      return (i_match);
    } else {
      for (i = 0; i < n_options; i++) {
        if (strncmp_case_insensitive(string, option[i], MIN(l, (long)strlen(option[i]))) == 0) {
          if (mode & RETURN_FIRST_MATCH)
            return (i);
          if (i_match != -1)
            return (-1);
          i_match = i;
        }
      }
      return (i_match);
    }
  }
 
  if (mode & MATCH_WHOLE_STRING) {
    i_match = -1;
    if (mode & CASE_SENSITIVE) {
      for (i = 0; i < n_options; i++) {
        if (strcmp(string, option[i]) == 0) {
          if (mode & RETURN_FIRST_MATCH)
            return (i);
          if (i_match != -1)
            return (-1);
          i_match = i;
        }
      }
      return (i_match);
    } else {
      for (i = 0; i < n_options; i++) {
        if (strcmp_case_insensitive(string, option[i]) == 0) {
          if (mode & RETURN_FIRST_MATCH)
            return (i);
          if (i_match != -1)
            return (-1);
          i_match = i;
        }
      }
      return (i_match);
    }
  }
 
  /* unknown set of flags */
  puts("error: unknown flag combination in match_string()");
  puts("       contact programmer!");
  exit(1);
}

strcmp_case_insensitive()

int strcmp_case_insensitive	(	char *	s1,
		char *	s2 )

Compares two strings in a case-insensitive manner.

This function compares two null-terminated strings without considering the case of the characters. It returns an integer less than, equal to, or greater than zero if the first string is found, respectively, to be less than, to match, or be greater than the second string.

Parameters

s1	The first string to compare.
s2	The second string to compare.

Returns

An integer indicating the relationship between the strings:

• Less than zero if s1 is less than s2.
• Zero if s1 is equal to s2.
• Greater than zero if s1 is greater than s2.

Definition at line 128 of file match_string.c.

                                                {
  register char *ptr1, *ptr2;
 
  ptr1 = s1;
  ptr2 = s2;
  while (*ptr1 && *ptr2 && tolower(*ptr1) == tolower(*ptr2)) {
    ptr1++;
    ptr2++;
  }
  return ((int)(*ptr1 - *ptr2));
}

strncmp_case_insensitive()

int strncmp_case_insensitive	(	char *	s1,
		char *	s2,
		long	n )

Compares up to a specified number of characters of two strings in a case-insensitive manner.

This function compares the first n characters of two null-terminated strings without considering the case of the characters. It returns an integer less than, equal to, or greater than zero if the first n characters of the first string are found, respectively, to be less than, to match, or be greater than the second string.

Parameters

s1	The first string to compare.
s2	The second string to compare.
n	The maximum number of characters to compare.

Returns

An integer indicating the relationship between the strings up to n characters:

• Less than zero if s1 is less than s2.
• Zero if the first n characters of s1 are equal to s2.
• Greater than zero if s1 is greater than s2.

Definition at line 157 of file match_string.c.

                                                         {
  register char *ptr1, *ptr2;
  register long i;
 
  ptr1 = s1;
  ptr2 = s2;
  i = 0;
  while (i < n && *ptr1 && *ptr2 && tolower(*ptr1) == tolower(*ptr2)) {
    ptr1++;
    ptr2++;
    i++;
  }
 
  if (i == n)
    return (0);
 
  return ((int)(*ptr1 - *ptr2));
}