Provided by:
manpages-pl-dev_20060617-3_all 
NAZWA
getdate() - przeksztalca lacuch w struktur struct tm
SK/LADNIA
#define _XOPEN_SOURCE
#define _XOPEN_SOURCE_EXTENDED
#include <time.h>
struct tm *getdate (const char *string);
extern int getdate_err;
#define _GNU_SOURCE
#include <time.h>
int getdate_r (const char *string, struct tm *res);
OPIS
Funkcja getdate() przeksztalca lacuch wskazywany przez string w
struktur tm, ktora jest zwracana. Zwracana struktura tm moe si
znajdowa w pamici statycznej, wobec czego zostanie nadpisana przez
nastpne wywolanie funkcji.
W odronieniu od strptime(3), (ktora posiada argument format), getdate()
posluguje si formatami znajdujcymi si w pliku, do ktorego pelna cieka
jest podana w zmiennej rodowiskowej DATEMSK. Do konwersji stosowana
jest pierwsza z linii pliku, ktora pasuje do zadanego lacucha.
Podczas dopasowywania ignorowana jest wielko liter. Ignorowane s rownie
nadmiarowe biale znaki, zarowno we wzorcu, jak i w przeksztalcanym
lacuchu.
Specyfikacje przeksztalce, ktore mog by zawarte we wzorcu s takie same,
jak dla strptime(3). Akceptowana jest jedna dodatkowa specyfikacja
przeksztalcenia:
%Z Nazwa strefy czasowej.
Gdy podano %Z, zwracana warto jest inicjalizowana jako rozloony czas
biecy w podanej strefie czasowej. W przeciwnym przypadku, jest
inicjalizowana jako rozloony czas odpowiadajcy biecemu czasowi
lokalnemu.
Gdy podany jest tylko dzie tygodnia, brany jest pierwszy taki dzie
przypadajcy w dniu biecym lub poniej.
Gdy podany jest jedynie miesic (bez roku), brany jest pierwszy taki
miesic przypadajcy w miesicu biecym lub po nim. Gdy nie podano dnia,
brany jest pierwszy dzie miesica.
Gdy nie podano godziny, minuty ani sekundy, brana jest bieca godzina,
minuta i sekunda.
Gdy nie podano daty, ale znana jest godzina, brana jest pierwsza taka
godzina przypadajca w biecej godzinie lub poniej.
WARTO ZWRACANA
Po pomylnym zakoczeniu funkcja ta zwraca wskanik do struktury struct
tm. W przeciwnym razie, zwraca NULL i ustawia zmienn globaln
getdate_err. Zmiany errno nie s okrelone. Zdefiniowano nastpujce
wartoci getdate_err:
1 Zmienna rodowiska DATEMSK ma warto pust lub nie jest zdefiniowana.
2 Nie udalo si otworzy pliku wzorcow w trybie do odczytu.
3 Nie udalo si pobra informacji o stanie.
4 Plik wzorcow nie jest zwyklym plikiem.
5 Wystpil bld podczas odczytu pliku wzorcow.
6 Nie udalo si przydzieli pamici (brak dostpnej pamici).
7 Brak w pliku linii pasujcej do podanych danych.
8 Niewlaciwa specyfikacja wejciowa.
UWAGI
Jako e funkcja getdate() nie jest wielowejciowa ze wzgldu na
korzystanie z getdate_err i statycznego bufora do zwracania wyniku,
glibc udostpnia jej wariant przystosowany do wielowtkowoci. Obie
funkcje zapewniaj t sam funkcjonalno. Wynik jest zwracany w buforze
wskazywanym przez res, a w przypadku bldu, zwracana jest niezerowa
warto, taka sama jak podano powyej dla getdate_err.
Specyfikacja POSIX 1003.1-2001 dla strptime() zawiera specyfikacje
przeksztalce korzystajce z modyfikatorow %E lub %O, podczas gdy takie
specyfikacje nie zostaly podane dla getdate(). Implementacja w glibc
realizuje getdate() za pomoc strptime(), wic, automatycznie, obie
funkcje wspieraj te same specyfikacje przeksztalce.
Implementacja w glibc nie wspiera specyfikacji przeksztalcenia %Z.
RODOWISKO
DATEMSK
Plik zawierajcy wzorce formatow.
TZ, LC_TIME
Zmienne uywane przez strptime().
ZGODNE Z
ISO 9899, POSIX 1003.1-2001
ZOBACZ TAKE
localtime(3), strftime(3), strptime(3), time(3)
INFORMACJE O T/LUMACZENIU
Powysze tlumaczenie pochodzi z nieistniejcego ju Projektu Tlumaczenia
Manuali i moe nie by aktualne. W razie zauwaenia ronic midzy powyszym
opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji,
prosimy o zapoznanie si z oryginaln (angielsk) wersj strony podrcznika.
2001-12-26 GETDATE(3)