home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 18
/
CD_ASCQ_18_111294_W.iso
/
dos
/
prg
/
c
/
x_lib10
/
xx.doc
< prev
Wrap
Text File
|
1994-10-20
|
36KB
|
1,349 lines
════════════════════════════════════════════════════════════════════════════
LES FONCTIONS UTILITAIRES
────────────────────────────────────────────────────────────────────────────
présentation
────────────
Le groupe XX regroupe des fonctions indépendantes offrant des services
dans plusieurs domaines (dates, conversions, chaînes).
opérations sur les dates
────────────────────────
Trois formats de représentation des dates sont possibles : les formats
binaire, grégorien et julien.
Le format binaire permet de compacter une date sur un entier long tout
en préservant l'ordre chronologique.
Le format grégorien décompose une date en année, mois et jour.
Le format julien permet de représenter une date comme un nombre de jours
écoulés depuis l'origine avec les propriétés suivantes :
-- ordre chronologique respecté,
-- opérations arithmétiques possibles.
Contrairement à d'autres applications ou librairies de fonctions, X/LIB
n'impose pas le format julien comme format interne de représentation des
dates, évitant ainsi le ralentissement dû à la complexité des opérations
de conversions depuis ou vers ce format.
╒═══════════════════════════════════════════════════════════════════╕
│ fonction utilisation │
├───────────────────────────────────────────────────────────────────┤
│ _db2g convertit une date binaire en date grégorienne │
│ _db2j convertit une date binaire en date julienne │
│ _dchr modifie le caractère séparateur des dates │
│ _dcur renvoie la date binaire courante │
│ _ddim renvoie le nombre de jours dans un mois │
│ _ddiy renvoie le nombre de jours dans une année │
│ _ddow renvoie le numéro d'un jour dans la semaine │
│ _ddoy renvoie le numéro d'un jour dans l'année │
│ _depq modifie le millésime des dates │
│ _dg2b convertit une date grégorienne en date binaire │
│ _dg2j convertit une date grégorienne en date julienne │
│ _dj2b convertit une date julienne en date binaire │
│ _dj2g convertit une date julienne en date grégorienne │
│ _dstr convertit une date binaire en chaîne │
│ _dval convertit une chaîne en date binaire │
│ _dver vérifie la validité d'une date grégorienne │
│ _dwoy renvoie le numéro d'une semaine dans l'année │
└───────────────────────────────────────────────────────────────────┘
opérations sur les heures
─────────────────────────
Deux formats de représentation des heures sont possibles : les formats
binaire et classique.
Le format binaire permet de compacter une heure sur un entier long tout
en préservant l'ordre chronologique.
Le format classique décompose une heure en heures, minutes et secondes.
╒═══════════════════════════════════════════════════════════════════╕
│ fonction utilisation │
├───────────────────────────────────────────────────────────────────┤
│ _tb2t convertit une heure binaire en heure classique │
│ _tchr modifie le caractère séparateur des heures │
│ _tcur renvoie l'heure binaire courante │
│ _tmod normalise une heure classique │
│ _tstr convertit une heure binaire en chaîne │
│ _tt2b convertit une heure classique en heure binaire │
│ _ttix renvoie la valeur de l'horloge interne │
│ _tval convertit une chaîne en heure binaire │
│ _tver vérifie la validité d'une heure classique │
└───────────────────────────────────────────────────────────────────┘
conversions numériques
──────────────────────
╒═══════════════════════════════════════════════════════════════════╕
│ fonction utilisation │
├───────────────────────────────────────────────────────────────────┤
│ _s2db convertit une chaîne en nombre décimal double │
│ _s2fl convertit une chaîne en nombre décimal │
│ _s2si convertit une chaîne en entier signé │
│ _s2sl convertit une chaîne en entier long signé │
│ _s2sv convertit une chaîne en entier long signé │
│ _s2ui convertit une chaîne en entier non signé │
│ _s2ul convertit une chaîne en entier long non signé │
│ _s2uv convertit une chaîne en entier long non signé │
└───────────────────────────────────────────────────────────────────┘
opérations sur chaînes
──────────────────────
╒═══════════════════════════════════════════════════════════════════╕
│ fonction utilisation │
├───────────────────────────────────────────────────────────────────┤
│ _scnt compte les occurences d'un caractère de chaîne │
│ _scpy copie une chaîne dans une autre │
│ _scut supprime les espaces autour d'une chaîne │
│ _sdel supprime des caractères autour d'une chaîne │
│ _sdup copie une chaîne dans une autre │
│ _smax renvoie la longueur maximale d'une sous-chaîne │
│ _snew crée une chaîne ... │
│ _spad ajoute des caractères autour d'une chaîne │
│ _sset initialise une chaîne avec un caractère │
│ _sval évalue une expression arithmétique │
└───────────────────────────────────────────────────────────────────┘
════════════════════════════════════════════════════════════════════════════
_db2g
convertit une date binaire en date grégorienne
────────────────────────────────────────────────────────────────────────────
utilisation
void _db2g (long val, int *yer, int *mon, int *day)
paramètres
val date binaire
yer pointeur sur année
mon pointeur sur mois
day pointeur sur jour
assertions
val date valide
yer != 0
mon != 0
day != 0
description
_db2g() convertit la date binaire val en date grégorienne et place ses
trois composantes (année, mois, jour) dans yer, mon et day.
voir aussi
_dg2b()
════════════════════════════════════════════════════════════════════════════
_db2j
convertit une date binaire en date julienne
────────────────────────────────────────────────────────────────────────────
utilisation
long _db2j (long val)
paramètres
val date binaire
assertions
val date valide
description
_db2j() convertit la date binaire val en une date julienne.
voir aussi
_dj2b()
════════════════════════════════════════════════════════════════════════════
_dchr
modifie le caractère séparateur des dates
────────────────────────────────────────────────────────────────────────────
utilisation
void _dchr (char chr)
paramètres
chr séparateur
assertions
chr != 0
description
_dchr() remplace le séparateur des dates par le caractère chr.
Par défaut, le séparateur de dates est le caractère '/'.
voir aussi
_depq(), _dstr()
════════════════════════════════════════════════════════════════════════════
_dcur
renvoie la date binaire courante
────────────────────────────────────────────────────────────────────────────
utilisation
long _dcur (void)
description
_dcur() renvoie la date courante du système au format binaire.
════════════════════════════════════════════════════════════════════════════
_ddim
renvoie le nombre de jours dans un mois
────────────────────────────────────────────────────────────────────────────
utilisation
int _ddim (int yer, int mon)
paramètres
yer année
mon mois
assertions
yer [1..9999]
mon [1..12]
description
_ddim() renvoie le nombre de jours dans le mois mon de l'année yer.
voir aussi
_ddiy()
════════════════════════════════════════════════════════════════════════════
_ddiy
renvoie le nombre de jours dans une année
────────────────────────────────────────────────────────────────────────────
utilisation
int _ddiy (int yer)
paramètres
yer année
assertions
yer [1..9999]
description
_ddiy() renvoie le nombre de jours dans l'année yer.
voir aussi
_ddim()
════════════════════════════════════════════════════════════════════════════
_ddow
renvoie le numéro d'un jour dans la semaine
────────────────────────────────────────────────────────────────────────────
utilisation
int _ddow (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
assertions
yer [1..9999]
mon [1..12]
day [1..31]
description
_ddow() renvoie le numéro dans la semaine du jour day du mois mon de
l'année yer.
_ddow() renvoie un entier compris entre 0 et 6 :
╒═══════════════════════════════════════════════════════════╕
│ résultat jour de la semaine │
├───────────────────────────────────────────────────────────┤
│ 0 dimanche │
│ 1 lundi │
│ 2 mardi │
│ 3 mercredi │
│ 4 jeudi │
│ 5 vendredi │
│ 6 samedi │
└───────────────────────────────────────────────────────────┘
voir aussi
_ddoy(), _dwoy()
════════════════════════════════════════════════════════════════════════════
_ddoy
renvoie le numéro d'un jour dans l'année
────────────────────────────────────────────────────────────────────────────
utilisation
int _ddoy (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
assertions
yer [1..9999]
mon [1..12]
day [1..31]
description
_ddoy() renvoie le numéro dans l'année yer du jour day du mois mon.
_ddoy() renvoie un entier compris entre 1 et 366.
voir aussi
_ddow(), _dwoy()
════════════════════════════════════════════════════════════════════════════
_depq
modifie le millésime des dates
────────────────────────────────────────────────────────────────────────────
utilisation
void _depq (int val)
paramètres
val millésime
description
_depq() remplace le millésime des dates par val.
Le millésime est utilisé pour lier les années à un siècle par défaut.
Par défaut, le millésime de dates vaut 1900.
voir aussi
_dchr(), _dstr()
════════════════════════════════════════════════════════════════════════════
_dg2b
convertit une date grégorienne en date binaire
────────────────────────────────────────────────────────────────────────────
utilisation
long _dg2b (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
assertions
yer [1..9999]
mon [1..12]
day [1..31]
description
_dg2b() convertit la date grégorienne (yer, mon, day) en date binaire.
voir aussi
_db2g()
════════════════════════════════════════════════════════════════════════════
_dg2j
convertit une date grégorienne en date julienne
────────────────────────────────────────────────────────────────────────────
utilisation
long _dg2j (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
assertions
yer [1..9999]
mon [1..12]
day [1..31]
description
_dg2j() convertit la date grégorienne (yer, mon, day) en date julienne.
voir aussi
_dj2g()
════════════════════════════════════════════════════════════════════════════
_dj2b
convertit une date julienne en date binaire
────────────────────────────────────────────────────────────────────────────
utilisation
long _dj2b (long val)
paramètres
val date binaire
assertions
val date valide
description
_dj2b() convertit la date julienne val en date binaire.
voir aussi
_db2j()
════════════════════════════════════════════════════════════════════════════
_dj2g
convertit une date julienne en date grégorienne
────────────────────────────────────────────────────────────────────────────
utilisation
void _db2g (long val, int *yer, int *mon, int *day)
paramètres
val date julienne
yer pointeur sur année
mon pointeur sur mois
day pointeur sur jour
assertions
val date valide
yer != 0
mon != 0
day != 0
description
_dj2g() convertit la date julienne val en date grégorienne et place ses
trois composantes (année, mois, jour) dans yer, mon et day.
voir aussi
_dg2j()
════════════════════════════════════════════════════════════════════════════
_dstr
convertit une date binaire en chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
char * _dstr (int fmt, long val, char *str)
paramètres
fmt format de conversion
val date binaire
str pointeur sur chaîne
assertions
fmt format valide
val date valide
str != 0
description
_dstr() convertit la date binaire val en une chaîne placée dans str au
format fmt.
Le format de conversion fmt est une des constantes suivantes :
╒═══════════════════════════════════════════════════════════╕
│ constante format longueur │
├───────────────────────────────────────────────────────────┤
│ xx_DMY JJMMAA 6 │
│ xx_DMYY JJMMCCAA 8 │
│ xx_DMYC JJ/MM/AA 8 │
│ xx_DMYYC JJ/MM/CCAA 10 │
│ xx_MDY MMJJAA 6 │
│ xx_MDYY MMJJCCAA 8 │
│ xx_MDYC MM/JJ/AA 8 │
│ xx_MDYYC MM/JJ/CCAA 10 │
│ xx_YMD AAMMJJ 6 │
│ xx_YYMD CCAAMMJJ 8 │
└───────────────────────────────────────────────────────────┘
Dans les formats ci-dessus, JJ indique le numéro du jour, MM le numéro
du mois, AA les années dans le millésime courant et CC le millésime.
Le millésime peut être modifié par _depq().
Le séparateur des dates peut être modifié par _dchr().
str doit pouvoir contenir la chaîne résultant de la conversion plus le
délimiteur nul.
_dstr() renvoie str.
voir aussi
_dchr(), _depq()
════════════════════════════════════════════════════════════════════════════
_dval
convertit une chaîne en date binaire
────────────────────────────────────────────────────────────────────────────
utilisation
int _dval (int fmt, const char *str, long *val)
paramètres
fmt format de conversion
str pointeur sur chaîne
val pointeur sur date binaire
assertions
fmt format valide
str != 0
val != 0
description
_dval() convertit la chaîne str en une date binaire selon le format de
conversion fmt.
En cas de conversion réussie, _dval() place la date binaire dans val et
renvoie une valeur non nulle. Dans le cas contraire, _dval() renvoie 0
sans modifier le contenu de val.
Le format de conversion fmt est le même que celui utilisé par _dstr().
voir aussi
_dstr()
════════════════════════════════════════════════════════════════════════════
_dver
vérifie la validité d'une date grégorienne
────────────────────────────────────────────────────────────────────────────
utilisation
int _dver (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
description
_dver() vérifie la validité de la date grégorienne (yer, mon, day).
_dver() renvoie une valeur non nulle en cas de format correct et 0 dans
le cas contraire.
════════════════════════════════════════════════════════════════════════════
_dwoy
renvoie le numéro d'une semaine dans l'année
────────────────────────────────────────────────────────────────────────────
utilisation
int _dwoy (int yer, int mon, int day)
paramètres
yer année
mon mois
day jour
assertions
yer [1..9999]
mon [1..12]
day [1..31]
description
_dwoy() renvoie le numéro de la semaine dans laquelle est située la date
grégorienne (yer, mon, day).
_dwoy() suppose que le lundi est le premier jour de la semaine et que la
première semaine de l'année commence avec le premier lundi de janvier.
voir aussi
_ddow(), _ddoy()
════════════════════════════════════════════════════════════════════════════
_s2..
convertit une chaîne en ...
────────────────────────────────────────────────────────────────────────────
utilisation
int _s2db (const char *str, double *val)
int _s2fl (const char *str, float *val)
int _s2si (const char *str, int *val)
int _s2sl (const char *str, long *val)
int _s2sv (const char *str, int rad, long *val)
int _s2ui (const char *str, unsigned int *val)
int _s2ul (const char *str, unsigned long *val)
int _s2uv (const char *str, int rad, unsigned long *val)
paramètres
str pointeur sur chaîne
rad base de conversion entière
val pointeur sur résultat
assertions
str != 0
rad base valide
val != 0
description
_s2..() convertit la chaîne str en un nombre placé dans val.
Si la conversion est réussie, le nombre résultant est conservé dans val.
Si la conversion échoue, le contenu de val est indéfini.
Les conversions entières sont faites en base décimale sauf pour _s2sv()
et _s2uv() qui utilisent une base précise.
La base de conversion rad est une des valeurs suivantes :
╒═══════════════════════════════════════════════════════════╕
│ base utilisation │
├───────────────────────────────────────────────────────────┤
│ 0 conversion avec base implicite selon les │
│ premiers caractères de la chaîne. │
│ │
│ ──────────────────────────── │
│ 1°car 2°car base │
│ ──────────────────────────── │
│ 0 X base 16 │
│ x base 16 │
│ 1..7 base 8 │
│ 1..9 base 10 │
│ ──────────────────────────── │
│ │
│ │
│ 2..36 conversion dans les bases 2 à 36 │
└───────────────────────────────────────────────────────────┘
_s2..() renvoit une valeur non nulle si la conversion est réussie et 0
en cas d'échec.
════════════════════════════════════════════════════════════════════════════
_scnt
compte les occurences d'un caractère de chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
int _scnt (const char *str, char chr)
paramètres
str pointeur sur chaîne
chr caractère
assertions
str != 0
description
_scnt() renvoie le nombre d'occurences de chr dans la chaîne str.
En complément à _smax(), _scnt() permet d'obtenir le nombre de lignes
logiques terminées par le caractère '\n' et composant une chaîne.
voir aussi
_smax()
════════════════════════════════════════════════════════════════════════════
_scpy
copie une chaîne dans une autre
────────────────────────────────────────────────────────────────────────────
utilisation
char * _scpy (char *dst, const char *src, int max)
paramètres
dst pointeur sur chaîne destination
src pointeur sur chaîne source
max longueur maximale
assertions
dst != 0
description
_scpy() copie la chaîne src dans dst à concurrence de max caractères.
Si dst est nul, _scpy() considère que la chaîne est vide.
_scpy() ajoute toujours un délimiteur nul à la fin de dst qui doit donc
pouvoir recevoir (max + 1) caractères.
_scpy() renvoie dst.
voir aussi
_sdup
════════════════════════════════════════════════════════════════════════════
_scut
supprime les espaces autour d'une chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
int _scut (char *str, int bos, int eos)
paramètres
str pointeur sur chaîne
bos suppression au début
eos suppression en fin
assertions
str != 0
description
_scut() supprime les espaces autour de la chaîne str.
Si bos est non nul, _scut() supprime les espaces situés au début de la
chaîne.
Si eos est non nul, _scut() supprime les espaces situés en fin de la
chaîne.
_scut() renvoie la longueur de la chaîne résultante.
voir aussi
_sdel()
════════════════════════════════════════════════════════════════════════════
_sdel
supprime des caractères autour d'une chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
int _sdel (char *str, chr lch, char rch)
paramètres
str pointeur sur chaîne
lch caractère
rch caractère
assertions
str != 0
description
_sdel() supprime les caractères lch et rch autour de la chaîne str.
Si lch est non nul, _sdel() supprime les caractères lch situés au début
de la chaîne.
Si rch est non nul, _sdel() supprime les caractères rch situés en fin de
la chaîne.
_sdel() renvoie la longueur de la chaîne résultante.
voir aussi
_scut()
════════════════════════════════════════════════════════════════════════════
_sdup
copie une chaîne dans une autre
────────────────────────────────────────────────────────────────────────────
utilisation
int _sdup (char *dst, const char *src, int max)
paramètres
dst pointeur sur chaîne destination
src pointeur sur chaîne source
max longueur maximale
assertions
dst != 0
description
_sdup() copie la chaîne src dans dst à concurrence de max caractères
_sdup() appelle _scpy() et renvoie le nombre de caractères copiés.
voir aussi
_scpy()
════════════════════════════════════════════════════════════════════════════
_smax
renvoie la longueur maximale d'une sous-chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
int _smax (const char *str, char chr)
paramètres
str pointeur sur chaîne
chr caractère
assertions
str != 0
description
_smax() renvoie la longueur de la plus longue portion de la chaîne str
délimitée par chr.
Le délimiteur ne fait pas partie du nombre de caractères renvoyés.
En complément à _scnt(), _smax() permet d'obtenir la longueur maximale
des lignes logiques terminées par le caractère '\n' et composant une
chaîne.
voir aussi
_scnt()
════════════════════════════════════════════════════════════════════════════
_snew
crée une chaîne ...
────────────────────────────────────────────────────────────────────────────
utilisation
char * _snew (int max)
char * _snew (char chr, int max)
char * _snew (const char *str)
paramètres
max longueur maximale
chr caractère
str pointeur sur chaîne
assertions
str != 0
description
Dans sa première forme, _snew() crée une chaîne vide pouvant recevoir un
maximum de max caractères en plus du délimiteur nul.
Dans sa deuxième forme, _snew() crée une chaîne initialisée avec max
caractères chr et terminée par le délimiteur nul.
Dans sa troisième forme, _snew() crée une copie de la chaîne str.
_snew() crée une chaîne en appelant malloc() ; un appel à free() est
donc nécessaire pour libérer l'espace mémoire ainsi alloué.
_snew() renvoie un pointeur sur la chaîne allouée ou 0 en cas de pénurie
de mémoire.
════════════════════════════════════════════════════════════════════════════
_spad
ajoute des caractères autour d'une chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
char * _spad (char *str, char lch, char rch, int max)
paramètres
str pointeur sur chaîne
lch caractère
rch caractère
max longueur maximale
assertions
str != 0
description
_spad() ajoute les caractères lch et rch autour de la chaîne str.
Les caractères lch et rch ne sont ajoutés que s'ils sont non nuls : au
début de str pour lch et en fin pour rch. Dans ce cas, _spad() répartit
équitablement le nombre de chaque caractère pour obtenir une chaîne
d'une longueur finale de max caractères.
La chaîne str doit pouvoir recevoir (max + 1) caractères.
_spad() est sans effet si la longueur de la chaîne avant traitement est
déjà supérieure à max.
_spad renvoie dst.
voir aussi
_sdel()
════════════════════════════════════════════════════════════════════════════
_sset
initialise une chaîne avec un caractère
────────────────────────────────────────────────────────────────────────────
utilisation
char * _sset (char *str, char chr, int max)
paramètres
str pointeur sur chaîne
chr caractère
max longueur maximale
assertions
str != 0
description
_sset() initialise la chaîne str avec max caractères chr.
_sset() ajoute un délimiteur à la fin de la chaîne str qui doit donc
pouvoir recevoir (max + 1) caractères.
_sset() renvoie str.
════════════════════════════════════════════════════════════════════════════
_sval
évalue une expression arithmétique
────────────────────────────────────────────────────────────────────────────
utilisation
int _sval (char *str, double *val)
paramètres
str pointeur sur chaîne
val pointeur sur résultat
assertions
str != 0
val != 0
description
_sval évalue l'expression arithmétique contenue dans la chaîne str et
place son résultat dans val.
_sval est un évaluateur simple d'expressions arithmétiques incluant les
quatre opérations de base (+, -, *, /) ainsi que la négation.
Les opérations sont évaluées dans leur ordre d'apparition dans la chaîne
et seules les parenthèses permettent de modifier cet ordre. Un maximum
de huit niveaux de parenthèses est autorisé.
Si l'évaluation réussit, _sval renvoie une valeur non nulle. Dans le cas
contraire, _sval renvoie 0 et le contenu de val est indéfini.
════════════════════════════════════════════════════════════════════════════
_tb2t
convertit une heure binaire en heure classique
────────────────────────────────────────────────────────────────────────────
utilisation
void _tb2t (long val, int *hor, int *min, int *sec)
paramètres
val heure binaire
hor pointeur sur les heures
min pointeur sur les minutes
sec pointeur sur les secondes
assertions
val heure valide
hor != 0
min != 0
description
_tb2t() convertit l'heure binaire val en heure classique et place ses
trois composantes (heures, minutes, secondes) dans hor, min et sec.
Les secondes ne sont renvoyées que si sec est non nul.
voir aussi
_tt2b()
════════════════════════════════════════════════════════════════════════════
_tchr
modifie le caractère séparateur des heures
────────────────────────────────────────────────────────────────────────────
utilisation
void _tchr (char chr)
paramètres
chr séparateur
assertions
chr != 0
description
_tchr() remplace le séparateur des heures par le caractère chr.
Par défaut, le séparateur des heures est le caractère ':'.
voir aussi
_tstr()
════════════════════════════════════════════════════════════════════════════
_tcur
renvoie l'heure binaire courante
────────────────────────────────────────────────────────────────────────────
utilisation
long _tcur (void)
description
_tcur() renvoie l'heure courante du système au format binaire.
════════════════════════════════════════════════════════════════════════════
_tmod
normalise une heure classique
────────────────────────────────────────────────────────────────────────────
utilisation
int _tmod (int *hor, int *min, int *sec)
paramètres
hor pointeur sur les heures
min pointeur sur les minutes
sec pointeur sur les secondes
assertions
hor != 0
min != 0
description
_tmod() normalise l'heure classique (*hor, *min, *sec) en convertissant
les secondes en minutes, les minutes en heures et les heures en jours
puis en replaçant les résultats dans hor, min et sec.
Les secondes ne sont renvoyées que si sec est non nul.
_tmod() renvoie le nombre de jours résultant de la normalisation.
════════════════════════════════════════════════════════════════════════════
_tstr
convertit une heure binaire en chaîne
────────────────────────────────────────────────────────────────────────────
utilisation
char * _tstr (int fmt, long val, char *str)
paramètres
fmt format de conversion
val heure binaire
str pointeur sur chaîne
assertions
fmt format valide
val heure valide
str != 0
description
_tstr() convertit l'heure binaire val en une chaîne placée dans str au
format fmt.
Le format de conversion fmt est une des constantes suivantes :
╒═══════════════════════════════════════════════════════════╕
│ constante format longueur │
├───────────────────────────────────────────────────────────┤
│ xx_HMS HHMMSS 6 │
│ xx_HMSC HH:MM:SS 8 │
│ xx_HM HHMM 4 │
│ xx_HMC HH:MM 5 │
└───────────────────────────────────────────────────────────┘
Dans les formats ci-dessus, HH indique les heures, MM les minutes et SS
les secondes.
Le séparateur des heures peut être modifié par _tchr().
str doit pouvoir contenir la chaîne résultant de la conversion plus le
délimiteur nul.
_tstr() renvoie str.
voir aussi
_tchr()
════════════════════════════════════════════════════════════════════════════
_tt2b
convertit une heure classique en heure binaire
────────────────────────────────────────────────────────────────────────────
utilisation
long _tt2b (int hor, int min, int sec)
paramètres
hor heures
min minutes
sec secondes
assertions
hor [0..23]
min [0..59]
sec [0..59]
description
_tt2b() convertit l'heure classique (hor, min, sec) en heure binaire.
voir aussi
_tb2t()
════════════════════════════════════════════════════════════════════════════
_ttix
renvoie la valeur de l'horloge interne
────────────────────────────────────────────────────────────────────────────
utilisation
long _ttix (void)
description
_ttix() renvoie la valeur de l'horloge interne.
Le résultat de _ttix() est le nombre de battements comptés depuis minuit
à la cadence d'un battement tous les 1/18° de seconde.
════════════════════════════════════════════════════════════════════════════
_tval
convertit une chaîne en heure binaire
────────────────────────────────────────────────────────────────────────────
utilisation
int _tval (int fmt, const char *str, long *val)
paramètres
fmt format de conversion
str pointeur sur chaîne
val pointeur sur heure binaire
assertions
fmt format valide
str != 0
val != 0
description
_tval() convertit la chaîne str en une heure binaire selon le format de
conversion fmt.
En cas de conversion réussie, _tval() place l'heure binaire dans val et
renvoie une valeur non nulle. Dans le cas contraire, _tval() renvoie 0
sans modifier le contenu de val.
Le format de conversion fmt est le même que celui utilisé par _tstr().
voir aussi
_tstr()
════════════════════════════════════════════════════════════════════════════
_tver
vérifie la validité d'une heure classique
────────────────────────────────────────────────────────────────────────────
utilisation
int _tver (int hor, int min, int sec)
paramètres
hor heures
min minutes
sec secondes
description
_tver() vérifie la validité de l'heure classique (hor, min, sec).
_tver() renvoie une valeur non nulle en cas de format correct et 0 dans
le cas contraire.
════════════════════════════════════════════════════════════════════════════
────────────────────────────────────────────────────────────────────────────
utilisation
. .
paramètres
. .
assertions
. .
description
╒═══════════════════════════════════════════════════════════╕
├───────────────────────────────────────────────────────────┤
└───────────────────────────────────────────────────────────┘
voir aussi