50 lines
No EOL
1.6 KiB
C
50 lines
No EOL
1.6 KiB
C
/*----------------------------------------------------------
|
|
* HTBLA-Leonding
|
|
* ---------------------------------------------------------
|
|
* Exercise Number: S05
|
|
* Title: Sorting criteria
|
|
* Author: Marc Tismonar
|
|
* ----------------------------------------------------------
|
|
* Description:
|
|
* Interface for sorting algorithms
|
|
* ----------------------------------------------------------
|
|
*/
|
|
|
|
|
|
#ifndef ___SORTING_CRITERIA_H
|
|
#define ___SORTING_CRITERIA_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
/**
|
|
* Declaration of function pointer for comparison function.
|
|
* A criterion function determines whether or not the given
|
|
* values are in the order that is defined by the criterion.
|
|
*
|
|
* @param int The value that is supposed being ordered before `snd`.
|
|
* @param int The value that is supposed being ordered after `fst`.
|
|
* @return True if `fst` IS actually ordered before `snd`
|
|
* (the values are in order), false otherwise.
|
|
*/
|
|
/* Note: Name the pointer type 'criterion_fn' */
|
|
typedef bool (*criterion_fn)(int fst, int snd);
|
|
|
|
/**
|
|
* Determines whether or not `fst` is smaller than or equal to `snd` (ascending order).
|
|
*
|
|
* @param fst The value that is supposed being smaller than `snd`.
|
|
* @param snd The value to compare.
|
|
* @return True if the criterion is satisfied, false otherwise.
|
|
*/
|
|
bool is_in_asc_order(int fst, int snd);
|
|
|
|
/**
|
|
* Determines whether or not `fst` is larger than or equal to `snd` (descending order).
|
|
*
|
|
* @param fst The value that is supposed being greater than `snd`.
|
|
* @param snd The value to compare.
|
|
* @return True if the criterion is satisfied, false otherwise.
|
|
*/
|
|
bool is_in_desc_order(int fst, int snd);
|
|
|
|
#endif |