Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getdate, getdate_r - Conversion d'une chaîne de caractères en structure tm. [b][/b] [size=18] [b]Résumé[/b] [/size] [b]#define _XOPEN_SOURCE[/b] [b][/b] [b]#define _XOPEN_SOURCE_EXTENDED[/b] [b][/b] [b]#include <time.h>[/b] [b][i]struct tm getdate (const char string );[/i][/b] [b][i]extern int getdate_err;[/i][/b] 2 [b]#define _GNU_SOURCE[/b] [b][/b] [b]#include <time.h>[/b] [b][i]int getdate_r (const char * string , struct tm * res );[/i][/b] [b][/b] [size=18] [b]Description[/b] [/size] La fonction [b]getdate() [/b] convertit une chaîne de caractères pointée par [i]string[/i] en une structure tm qu'elle renvoie. Cette structure tm est susceptible d'être allouée de façon statique et d'être ainsi écrasée lors du prochain appel. Contrairement à [b]strptime (3),[/b] ( qui a un argument [i]format[/i] ), [b]getdate()[/b] utilise les formats présents dans le fichier dont le chemin d'accès complet est donné par la variable d'environnement [b]DATEMSK .[/b] La première ligne du fichier qui peut être mise en correspondance avec la chaîne passée en paramètre d'entrée est utilisée pour la conversion. La correspondance n'est pas sensible à la casse. Les espaces superflus, qu'ils soient dans le motif ou dans la chaîne à convertir, sont ignorés. Les paramètres de conversion qu'un motif peut contenir sont les mêmes que pour [b]strptime (3).[/b] Un indicateur de conversion supplémentaire est accepté : [b]%Z[/b] [table][row][col]    [/col][col]Nom du fuseau horaire.[/col][/row][/table]     Lorsque [b]%Z[/b] est spécifié, la valeur renvoyée est initialisée à l'heure sous forme structure tm correspondant à l'heure courante sous le fuseau horaire indiqué. Sinon, elle est initialisée à l'heure sous forme de structure tm correspondant à l'heure locale actuelle.     Lorsque seul le jour de la semaine est donné, le jour pris en compte sera le premier jour correspondant à partir d'aujourd'hui inclus.     Lorsque seul le mois est spécifié (et pas l'année), le mois pris en compte est le premier mois correspondant à partir du mois courant inclus. Si aucun jour n'est indiqué, le premier jour du mois est pris par défaut.     Lorsque les heures, minutes et secondes ne sont pas indiquées, l'heure courante (heures, minutes et secondes) est prise par défaut.     Si aucune date n'est indiquée, mais que l'on connaît l'heure, l'heure prise en compte sera la première occurrence de l'heure correspondante à partir de l'heure courante incluse. [size=18] [b]Valeur renvoyée[/b] [/size] En cas de succès, cette fonction renvoie un pointeur vers une structure [b]struct tm .[/b] sinon elle renvoie NULL et positionne la variable globale [b]getdate_err .[/b] La modification éventuelle de [i]errno[/i] est indéfinie. [b]getdate_err [/b] peut prendre les valeurs suivantes : [b]1[/b] [table][row][col]    [/col][col]La variable d'environnement DATEMSK vaut null ou n'est pas définie.[/col][/row][/table] [b]2[/b] [table][row][col]    [/col][col]Le fichier patron (template) ne peut être ouvert pour être lu.[/col][/row][/table] [b]3[/b] [table][row][col]    [/col][col]Impossible de lire l'état du fichier.[/col][/row][/table] [b]4[/b] [table][row][col]    [/col][col]Le fichier patron n'est pas un fichier régulier.[/col][/row][/table] [b]5[/b] [table][row][col]    [/col][col]Une erreur est survenue en cours de lecture du fichier patron.[/col][/row][/table] [b]6[/b] [table][row][col]    [/col][col]Echec d'allocation mémoire (pas assez de mémoire disponible).[/col][/row][/table] [b]7[/b] [table][row][col]    [/col][col]Il n'y a pas de ligne dans le fichier qui puisse être mise en correspondance avec l'entrée.[/col][/row][/table] [b]8[/b] [table][row][col]    [/col][col]Paramètres d'entrée invalides.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Puisque [b]getdate() [/b] n'est pas ré-entrante à cause de l'utilisation de [b]getdate_err[/b] et du tampon statique utilisé pour stocker le résultat renvoyé, la glibc fournit une variante utilisable en contexte multithread. La fonctionnalité est la même. Le résultat est renvoyé dans le tampon pointé par [i]res[/i] et, en cas d'erreur, le code de retour est différent de zéro avec les mêmes valeurs que celles données précédemment pour [b]getdate_err .[/b]     La spécification POSIX 1003.1-2001 pour [b]strptime()[/b] contient des spécifications de conversion utilisant les modificateurs [b]%E[/b] ou [b]%O[/b] alors que de tels modificateurs ne sont pas indiqués pour [b]getdate() .[/b] L'implantation glibc de [b]getdate()[/b] utilise [b]strptime()[/b] si bien que les deux fonctions supportent exactement les mêmes conversions automatiquement.     L'implantation glibc ne supporte pas l'indicateur de conversion : [b]%Z[/b] . [size=18] [b]Environnement[/b] [/size] [b]DATEMSK [/b] [table][row][col]    [/col][col]Fichier contenant les motifs de formatage.[/col][/row][/table] [b]TZ , LC_TIME [/b] [table][row][col]    [/col][col]Variables utilisées par [b]strptime()[/b].[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] ISO 9899, POSIX 1003.1-2001 [size=18] [b]Voir aussi[/b] [/size] [b]localtime (3),[/b] [b]strftime (3),[/b] [b]strptime (3),[/b] [b]time (3)[/b] [size=18] [b]Traduction[/b] [/size] Stéphan Rafin, 2002.
Fichier