Chapitre précédentRetour au sommaireChapitre suivant

Documentation VISION (VAPI)

Dernière mise à jour : 26/08/18

Télécharger la doc

LOGGING INTERFACE

 

Résumé
Préfixe de l'interface Lo
Nombre de fonctions 2
Description Ensemble de fonctions permettant d'envoyer des informations à un fichier de logging

 

Prototype long cdecl LoDoLog(unsigned long level, char* format, ...)
Paramètres level: bitmask composant le niveau de logging du message: LL_FATAL, LL_ERROR, LL_WARNING, LL_INFO, LL_PERF, LL_MEM, LL_GW2, LL_GW1, LL_DEBUG,LL_KCODE,  LL_TMP2, LL_TMP1
format: chaine de formatage des donneés passées ensuite (identique à format de sprintf)
...: liste dynamique des paramètres à passer (cf. 'C' ellipsis)
Retour Nombre d'octets écrits dans le fichier de logging
Description Permet d'envoyer un message vers le fichier de logging typiquement à des fins de debug, d'informations de performance ou d'erreur.
Notez que si le paramètre level n'est pas dans le bitmask en cours pour le logging VISION (voir fonction suivante), cette fonction retournera tout de suite sans procéder à un formatage style printf qui pourrait s'avérer couteux en temps CPU.
Remarques Exemple d'utilisation:
Vapi->LoDoLog(LL_DEBUG, "%ld pixels computed or deduced", np) ;
Version VAPI 1.04 ou supérieure

 

Prototype unsigned long cdecl LoGetLogLevel(void)
Paramètres Aucun
Retour Le bitmask de valeurs LL_... actuellement utilisé par VISION
Description Permet de connaitre le niveau de logging actuel afin de ne pas effectuer de calcul inutile si le niveau en cours implique que le prochain appel à LoDoLog n'écrira rien dans le fichier de logging.
Remarques N'utilisez cette fonction que si vous avez des calculs un peu lourd à effectuer avant d'appeler LoDoLog. LoDoLog ne fera pas de formatage inutile si le niveau de logging est insuffisant pour générer un message quelconque dans le fichier de logging.
Version VAPI 1.04 ou supérieure

 



Chapitre précédentRetour au sommaireChapitre suivant

Documentation VISION (VAPI)


Télécharger la doc

LOGGING INTERFACE