header bmstdlib

#include <ctime> //time.h
#include <cmath>
#include <cerrno>
#include <cstdlib>
#include <cstdio>
#include <vector>
#include <iostream>
#include <string>
#include <cctype>
#include <fstream>

#ifdef _WIN32
#include <windows.h>
#endif

#ifdef __linux
#include <unistd.h>
#endif

using namespace std;

/**** maths ****/
// tire un nombre aléatoire compris entre min et max
// si min n'est pas renseigné, il vaut par défaut 0
int MathRandom(int max, int min = 0);

// arrondi au nombre entier le plus proche
int MathRound(float a);

// arrondi au nombre entier supérieur
int MathCeil(float a);

// calcule une racine
// par défaut, c'est une racine carrée
double MathRoot(float a, int expo = 2);

//arrondi au nombre entier inférieur
double MathFloor(float a);

/**** fichiers ****/

//vérifie si un fichier est ouvrable avec le mode demandé
//retourne 0 en cas de succès
//sinon, un nombre qui correspond à l'erreur
int FileOpen(char* fname, char* mode);

//écrit "content" à la suite du fichier
//retourne 0 en cas de succès
//sinon, un code erreur (c'est aussi le cas des fonctions qui suivent)
int FileWrite(char* fname, const string& content);

//écrit "content" à la suite du fichier, dans une nouvelle ligne
int FileWriteLine(char* fname, const string& content);

//retourne le contenu entier d'un fichier dans une chaine de caractère C++
string FileGetContents(char* fname);

//écrit "content" au début du fichier.
int FileWriteFirstLine(char* fname, const string& content);

//remplace le contenu du fichier par "content"
int FileRewrite(char* fname, const string& content);

//retourne true si le fichier est vide. false sinon.
bool FileIsEmpty(char* fname);

//crée un fichier. 0 en cas de succès, etc
int FileCreate(char* fname);

//supprime le fichier. 0 en cas de succès etc
int FileDelete(char* fname);

//renomme le fichier. 0 = succes, etc
int FileRename(char* fname, char* nwName);

//retourne un array contenant chaque ligne du fichier
vector<string> FileGetLines(char* fname);

/**** arrays ****/

//Dit si un élément de NIMPORTE QUEL TYPE, et dans un array d'éléments du même type
template <typename T>
bool ArrayIn(const T& el, const vector<T>& array);

//Retourne la taille d'un array
template <typename T>
size_t ArraySize(const vector<T>& array);

//retourne true si le tableau est vide, false sinon
template <typename T>
bool ArrayEmpty(const vector<T>& array);

//regroupe les éléments d'un array dans une chaine de caractère
//les éléments sont liés par le paramètre "jointure"
template <typename T>
string ArrayJoin(const vector<T>& array, string jointure);

/**** strings ****/

//met toute une chaine en minuscules
string StringLower(const string& str) ;

//met toute une chaine en majuscules
string StringUpper(const string& str) ;

//retourne la taille d'une chaine de caractère.
//equivalent à strlen
size_t StringLength(const string& str) ;

//retourne la position de motif dans str2explore.
// -1 si motif n'est pas dans str2explore
size_t StringFind(const string& motif, const string& str2explore) ;

//retourne une sous chaine de str
// pos = a partir de quel offset prendre la chaine
// n = taille de la sous-chaine
string StringGetSubStr(string str, size_t pos = 0, size_t n = -1);

/**** console ****/

//affiche n'importe quelle chose affichable dans la console
template <typename T>
void ConsolePrint(T disp) ;

//affiche n'importe quelle chose affichable dans la console, dans une nouvelle ligne
template <typename T>
void ConsolePrintln(T disp) ;

//récupère l'entrée clavier dans la variable passée en argument (n'importe quel type)
template <typename T>
inline void ConsoleAsk(T& ptr) ;

//pareil que son voisin du dessus
inline void ConsoleAsk(string& ptr) ;

//vide le contenu de la console
inline void ConsoleClean();

//cache la console - ne fonctionne que sur Windows
inline void ConsoleHide();

/**** program ****/
//fait stopper le thread du programme pendant x secondes
inline void ProgramSleep(int sec) ;

//pareil que le voisin du dessus, mais en millisecondes
inline void ProgramSleepMs(int ms) ;

//termine le programme avec un code de sortie.
//par défaut, le code de sorti est 0 (le programme s'est déroulé correctement)
inline void ProgramExit(int code = EXIT_SUCCESS) ;