ircproxy  The Ultimate Cyborg

---

IRC_compare.h

Go to the documentation of this file.

// ircproxy -- An IRC bouncer.
//
//! @file IRC_compare.h
//! @brief This file contains the declaration of the IRC string- and character compare functions.
//
// Copyright (C) 2006, 2007 by
//
// Carlo Wood, Run on IRC <carlo@alinoe.com>
// RSA-1024 0x624ACAD5 1997-01-26                    Sign & Encrypt
// Fingerprint16 = 32 EC A7 B6 AC DB 65 A6  F6 F6 55 DD 1C DC FF 61
//
// This file may be distributed under the terms of the Q Public License
// version 1.0 as appearing in the file LICENSE.QPL included in the
// packaging of this file.

#ifndef IRC_COMPARE_H
#define IRC_COMPARE_H

#ifndef USE_PCH
#include <cstddef>
#include <string>
#endif

#include "ircd_chattr.h"

//! @brief Compare two IRC characters in a 'case insensitive' way.
//
// Returns whether c1 is lexicographically less than (-1), equal (0) or larger than (1) c2.
inline int IRCStringCompare(char c1, char c2)
{
  int lc1 = static_cast<unsigned char>(ToLower(c1));
  int lc2 = static_cast<unsigned char>(ToLower(c2));
  if (lc1 < lc2)
    return -1;
  if (lc1 > lc2)
    return 1;
  return 0;
}

//! @brief Compare two IRC characters in a 'case insensitive' way.
//
// Returns true when c1 is lexicographically less than c2. False otherwise.
inline bool IRC_compare(char c1, char c2)
{
  return static_cast<unsigned char>(ToLower(c1)) < static_cast<unsigned char>(ToLower(c2));
}

//! Compare two whole IRC strings in a 'case insensitive' way.
int IRCStringCompare(char const* s1, char const* s2);

//! @brief Compare the first \a count characters of two IRC strings in a 'case insensitive' way.
//
// Returns whether s1 is lexicographically less than (-1), equal (0) or larger than (1) s2.
int IRCStringCompare(char const* s1, char const* s2, size_t count);

//! Compare two whole IRC strings in a 'case insensitive' way.
inline int IRCStringCompare(std::string const& s1, std::string const& s2)
{
  return IRCStringCompare(s1.c_str(), s2.c_str());
}

//! @brief Compare the first \a count characters of two IRC strings in a 'case insensitive' way.
//
// Returns whether s1 is lexicographically less than (-1), equal (0) or larger than (1) s2.
inline int IRCStringCompare(std::string const& s1, std::string const& s2, size_t count)
{
  return IRCStringCompare(s1.c_str(), s2.c_str(), count);
}

//! Compare two whole IRC strings in a 'case insensitive' way.
inline int IRCStringCompare(std::string const& s1, char const* s2)
{
  return IRCStringCompare(s1.c_str(), s2);
}

//! @brief Compare the first \a count characters of two IRC strings in a 'case insensitive' way.
//
// Returns whether s1 is lexicographically less than (-1), equal (0) or larger than (1) s2.
inline int IRCStringCompare(std::string const& s1, char const* s2, size_t count)
{
  return IRCStringCompare(s1.c_str(), s2, count);
}

//! Compare two whole IRC strings in a 'case insensitive' way.
inline int IRCStringCompare(char const* s1, std::string const& s2)
{
  return IRCStringCompare(s1, s2.c_str());
}

//! @brief Compare the first \a count characters of two IRC strings in a 'case insensitive' way.
//
// Returns whether s1 is lexicographically less than (-1), equal (0) or larger than (1) s2.
inline int IRCStringCompare(char const* s1, std::string const& s2, size_t count)
{
  return IRCStringCompare(s1, s2.c_str(), count);
}

//! Functor to compare strings with IRCStringCompare.
struct IRC_less {
  //! Functor implementation.
  bool operator()(std::string const& s1, std::string const& s2) const { return IRCStringCompare(s1, s2) < 0; }
};

#endif // IRC_COMPARE_H

---