Narzędzia użytkownika

Narzędzia witryny


klasy_bazowe_dla_strumieni

Różnice

Różnice między wybraną wersją a wersją aktualną.

Odnośnik do tego porównania

Both sides previous revision Previous revision
Next revision
Previous revision
klasy_bazowe_dla_strumieni [2008/12/13 17:17]
siemionides
klasy_bazowe_dla_strumieni [2008/12/14 21:23] (aktualna)
siemionides
Linia 15: Linia 15:
  
  
-=== ios_base ====+==== Klasa ios_base ​=====
 ios_base (Input Output State) jest podstawową klasą bazową dla pojęcia strumienia i operacji z nim związnych. Dostarcza pojęcie //flagi stanu formatowania//,​ a także narzędzi do jego wykorzystania. ​ ios_base (Input Output State) jest podstawową klasą bazową dla pojęcia strumienia i operacji z nim związnych. Dostarcza pojęcie //flagi stanu formatowania//,​ a także narzędzi do jego wykorzystania. ​
  
Linia 106: Linia 106:
 Przykład w postaci sformatowanej tabelki odpowiadającej sformatowanemu wyjściu:\\ Przykład w postaci sformatowanej tabelki odpowiadającej sformatowanemu wyjściu:\\
 <code cpp> <code cpp>
- hex oct dec + hex oct dec 
- flaga ustawiona 0xa4c 077 32 +flaga ustawiona 0xa4c 077 32 
- flaga nieustawiona a4c 77 32+flaga nieustawiona a4c 77 32
 </​code>​ </​code>​
   
Linia 118: Linia 118:
  
 <code cpp> <code cpp>
- double m = 7.14 double n = 4 int k = 4 + double m = 7.14 double n = 4 int k = 4 
- flaga ustawiona 7.140000 4.000000 4 +flaga ustawiona 7.140000 4.000000 4 
- flaga nieustawiona 7.14 4 4+flaga nieustawiona 7.14 4 4
 </​code>​ </​code>​
  
Linia 153: Linia 153:
  
 ==ios_base::​adjustfield== ==ios_base::​adjustfield==
-Ta maska (pole) odpowiada za zagadnienie justowania, reprezentuje trzy wspomniane już flagi:+Ta maska (pole) odpowiada za zagadnienie justowania, reprezentuje trzy wspomniane już flagi:\\
 ''​ ''​
 ios_base::​left /​ /    justowanie lewe \\ ios_base::​left /​ /    justowanie lewe \\
Linia 162: Linia 162:
  
 ==ios_base::​basefield== ==ios_base::​basefield==
-Ta maska (pole) odpowiada za zagadnienia typu konwersji, reprezentuje flagi: +Ta maska (pole) odpowiada za zagadnienia typu konwersji, reprezentuje flagi:\\ 
--ios_base::​dec //​konwersja decymalna  +''​ 
--ios_base::​oct //​konwersja oktalna +ios_base::​dec /​ /    konwersja decymalna\\  
--ios_base::​hex //​konwersja heksadecymalna+ios_base::​oct /​ /    konwersja oktalna\\ 
 +ios_base::​hex /​ /    konwersja heksadecymalna 
 +''​ 
 + 
 +==ios_base::​floatfield== 
 +Ta maska (pole) odpowiada za typ notacji, reprezentuje flagi:\\ 
 +''​ 
 +ios_base::​scientific /​ /    notacja naukowa (wykładnicza)\\ 
 +ios_base::​fixed  ​       / /    notacja zwykla 
 +''​ 
 + 
 + 
 + 
 +=== Opis metod klasy ios_base === 
 + 
 +==ios_base::​fmtflags setf(fmtflags ktore_flagi)== 
 +Funkcja ta umożliwia ustawienie w słowie stanu tych flag, które przysłaliśmy we wzorze jako argument. Funkcja, jako rezultat, zwraca dotychczasowy stan wszystkich flag formatowania. \\ 
 +Typ fmtflags jest typem flag w klasie ios_base, poglądowo można śmiało przyjąć, że jest to inna nazwa na typ int, zaś poszczególne flagi są bitami wchodzącymi w skład tego typu.\\ 
 +  
 +<code cpp> 
 +//​przykład 
 +cin.setf(ios::​skipws);​ // ustawia flagę skipws odpowiadającą za ignorowanie białych znaków  
 + // przez strumień wejściowy cin. Inne flagi pozostają bez zmian. 
 +cin.setf(ios::​skipws | ios::​boolalpha) // ustawia jednocześnie obie flagi 
 +</​code>​ 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 +==ios_base::​fmtflags setf(ftmflags flaga, fmtflags nazwa_pola)== 
 +Funkcją można szybko ustawić flagę należącą do grupy flag zwanej "​maską"​ bądź "​polem"​. Istnieją trzy maski (opis niżej). Jedna z nich, odpowiadająca konwersji liczb to ios_base::​basefield,​ w której skład wchodzą flagi ios_base::​dec,​ ios_base::​hex,​ ios_baze::​oct. Flagi wchodzące w skład danej "​maski"​ muszą być ustawione jako jedyne w grupie. \\ 
 +Np. mając strumień wypisujący dane w zapisie szesnastkowym,​ a chcąc, żeby wypisywał w zapisie dziesiątkowym,​ możemy zrobić np. tak \\ 
 + 
 +<code cpp> 
 +//​przykład 
 +cout.setf(ios_base::​dec);​ 
 +cout.unsetf(ios_base::​hex);​ 
 +</​code>​ 
 +\\ 
 +bądź, z wykorzystaniem funkcji setf(flaga, nazwa_pola) : 
 + 
 +<code cpp> 
 +//​przykład 
 +cout.setf(ios_base::​dec,​ ios_base::​basefield);​ //​ ustawia flagę ios_base::​dec,​ dbając o 
 +                                                // wyłączenie pozostałych flag wchodzących  
 +                                                // w skład pola ios_base::​basefield 
 +</​code>​  
 + 
 + 
 + 
 +Dodatkowo, omawianą funkcją można skasować wszystkie flagi należące do tego pola, powracajac do sytuacji domniemanej. Robi się to podając jako pierwszy argument wartość zero. 
 + 
 +<code cpp> 
 +//​przykład 
 +cout.setf(0,​ ios::​basefield);​ //​ skasowanie wszystkich flag 
 +</​code>​ 
 + 
 + 
 + 
 + 
 + 
 + 
 +==ios_base::​fmtflags unsetf(fmtflags flagi)== 
 +Funckja ta jako rezultat zwraca wartość typu fmtflags opisującą dotychczasowy stan wszystkich flag formatowania. Funkcja ta sprawia, że wybrana flaga zostaje skasowana (zdjęta), a inne zaś nietknięte. 
 + 
 +<code cpp> 
 +//​przykład 
 +cin.unsetf(ios::​skipws);​ //​skasowanie flagi ios::​skipws 
 +</​code>​ 
 +  
 + 
 + 
 +==ios_base::​fmtflags flags(fmtflags zestaw)== 
 +Funkcja, jako rezultat, zwraca wartość typu fmtflags, obrazującą dotychczasoy stan wszystkich flag formatowania.\\ 
 +Jako argument przyjmuje zestaw funkcji, który można podać za pomocą OR-owania kilku flag. Ustawia wówczas te flagi, które mają byc ustawione (obecne w zestawie), zerując zaś pozostałe zdejmuje.\\ 
 +Główna różnica pomiędzy funkcją flags() a funkcjami setf() oraz unsetf() jest taka, że flags() wpływa na pozostałe flagi, nie tylko na te podane jako argument zestaw (pozostałe są wyłączana) 
 + 
 +<code cpp> 
 +//​przykład 
 +cin.flags(ios_base::​skipsw) // zdejmuje wszystkie flagi, ustawia tylko flagę  
 +                                // ios_base::​skipsw  
 +</​code>​ 
 + 
 + 
 + 
 + 
 + 
 + 
 +==ios_base::​fmtflags flags()== 
 +Zwraca wartość typu ftmflags zawierającą informację o wszystkich obecnie używanych flagach. Przydatne do sprawdzenia ustawienie jednej flagi bądź zapisu ustawień, celem późnniejszego do nich powrotu. 
 + 
 +<code cpp> 
 +//​przykład1 
 +if(cout.flags() & ios_base::​fixed) 
 + cout << "Flaga fixed jest ustawiona!";​ 
 +</​code>​ 
 + 
 +<code cpp> 
 +//​przykład2 
 +ftmflags stare_ustawienia = cout.flas();​ // zapisuje ustawienia flag strumienia cout 
 +  
 +cout.setf(ios_base::​fixed);​ 
 +cout.setf(ios_base::​skipsw);​ //​ włączenie różnych flag 
 +// ... 
 + 
 +cout.flags(stare_ustawienia) //​ przywrocenie poprzednich ustawien 
 +</​code>​ 
 + 
 + 
 +==ios_base::​streamsize width() const== 
 +Funkcja ta zwraca obowiązującą właśnie szerokość pola, na którym wypisywana jest ze strumienia jakaś liczba. 
 + 
 + 
 +==ios_base::​width(streamsize())== 
 +Funkcja określa minimalną szerokość pola, na którym ma być wypisana dana liczba.\\ 
 +Określenie tej liczby dotyczy tylko najbliższej operacji we/wy związanej ze strumieniem,​ dla którego zostaje ona podana. 
 + 
 +<code cpp> 
 +//​przykład 
 +int liczba = 107; 
 +cout << "​Wypisz:​ " << liczba << "​\nWypisz:";​ 
 +cout.width(7);​ //​określenie nowej szerokości pola liczby 
 +cout << liczba << ":"​ << endl; 
 +</​code>​ 
 + 
 +Po uruchomieniu tego przykładu na ekranie pojawi się 
 + 
 +<code cpp> 
 +//​przykład  
 +Wypis:​107:​ 
 +Wypis: ​   107: 
 +</​code>​ 
 + 
 +W przypadku wczytywania danych ustawienie szerokości funkcją width() nie ma wpływu na wczytywane liczby, zaś zmieni sposób wczytywania ciągu znaków (tekstu). Dzięki temu można np. zapobiec przekroczeniu rozmiaru tablicy przeznaczonej do przyjęcia znaków, jak w poniższym przykładzie : 
 + 
 +<code cpp> 
 +//​przykład 
 +char napis[7]; 
 +cin.width(sizeof(napis));​ //​ określenie szerokości (długości) pobieranego ciągu znaków 
 + 
 +cin >> napis; 
 +</​code>​ 
 + 
 +Warto zauważyć, że w powyższym przykładzie zostanie wczytanych 6 znaków, a nie 7, ponieważ C-stringi (char napis[7]) muszą posiadać na końcu znak null, który jest tam automatycznie dodawany. 
 + 
 + 
 + 
 +==ios_base::​streamsize precision() const== 
 +Funkcja ta zwraca obecną dokładność wypisywania liczb zmiennoprzecinkowych.\\ 
 +Domyślnie ta dokładność wynosi 6.\\ 
 + 
 +Uwaga. Patrz flagi ios_base::​fixed oraz ios_base:​scientific 
 + 
 + 
 + 
 + 
 +==ios_base::​streamsize precision(streamsize)== 
 +Funkcja ta przyjmuje jako argument wartość streamsize (przyjmijmy,​ że jest to inna nazwa typu int), która oznacza nową dokładność wypisywania liczb zmiennoprzecinkowych. Zwracana wartość jest równa starszej, zastępowanej dokładności wypisywania liczb zmiennoprzecinkowych. 
 + 
 +<code cpp> 
 +//​przykład 
 +double x = 72.123456789;​ 
 + y = 10.55; 
 + z = 2; 
 +  
 +cout << "​Obecna dokładność = " << (cout.precision()) << endl; 
 +cout << "​Domniemany : " << "​x="​ << x << " y=" << y << " z=" << z << endl; 
 + //​Wypisze x=72.1235 y=10.55 z=2 
 +cout.precision(2);​ 
 +cout << "Po zmianie : " << "​x="​ << x << " y=" << y << " z=" << z << endl; 
 + //​Wypisze x=72 y=11 z=2  
 +</​code>​ 
 + 
 + 
 + 
 + 
 +==== Klasa basic_os ==== 
 +Klasa dziedzicząca po ios_base. 
 + 
 +=== Spis omówionych definicji metod klasy basic_os === 
 +''​ 
 +basic_os::​char fill(char c)\\ 
 +basic_os::​char fill()\\ 
 + 
 +basic_ios:: bool good() / /opis we flagach stanów \\ 
 +basic_ios::​bool eof()\\ 
 +basic_ios::​bool fail()\\ 
 +basic_ios::​bool bad()\\ 
 +''​ 
 +=== Omówienie metod klasy basic_os === 
 +==basic_os::​char fill(char c)== 
 +Funkcja ta zmienia znak wypełniający miejsce pozostale przy wypisywaniu liczby na pole o większej ilości znaków, niż długość liczby, np. liczba jest dwucyfrowa, a ma byc wypisana na 7 miejscach (zostało to ustalone za pomocą, więc pozostale miejsca są domyslnie wypełniane spacjami. Nowy znak dopełniający miejsce w takich przypadkach jest właśnie argumentem tej funkcji. \\ 
 +Wartość zwracana jest wypełniającym znakiem, obowiązującym do momentu wywołania tej funkcji.\\ 
 + 
 +<code cpp> 
 +int liczba = 1024; 
 +cout.width(9);​ 
 +cout.fill('​*'​);​ 
 +cout << "​Liczba:"​ << liczba << ":"​ << endl;  
 +</​code>​ 
 +Wywolanie powyższego przykładu zaowocuje pojawieniem się na ekranie następującej sekwencji 
 +<code cpp> 
 +Liczba:​*****1024:​ 
 +</​code>​ 
 + 
 + 
 + 
 + 
 + 
 + 
 +==basic_os:​char fill()== 
 +Funkcja ta zwraca znak używany obecnie jako wypełnienie pozostałego miejsca przy wypisywaniu liczby na pole o większej ilości znaków niż długość liczby. 
 + 
 +  
 +==== Klasa ios ==== 
 +Klasa dziedzicząca po basic_ios.\\ 
 + 
 + 
 +=== Spis omówionych elementów składowych === 
 +''​ 
 +ios::​goodbit\\ 
 +ios::​eofbit\\ 
 +ios::​badbit\\ 
 +ios::​failbit\\ 
 +''​ 
 +==== Klasa istream ==== 
 + 
 +Obiekty klasy ''​istream''​ są strumieniami uzywanymi do odczytu i interpretacji sekwencji znakowych, które pojawiły się na wejściu strumienia (urzadzenia wejścia, dysk twardy, nasłuch poleceń sieciowego protokołu). \\ 
 +Klasa ''​istream''​ dziedziczy po klasie ''​ios''​ (a przez to po ''​basic_os''​ oraz ''​ios_basse''​. 
 +=== Spis omówionych definicji metod klasy istream === 
 +''​ 
 +istream::​int get()          \\ 
 +istream::​istream&​ get (char& c) \\ 
 +istream::​istream&​ get(char* s, streamsize n) \\ 
 +istream::​istream&​ get (char* s, streamsize n, char delim)\\ 
 + 
 +istream::​istream&​ getline (char* s, streamsize n )      \\ 
 +istream::​istream&​ getline (char* s, streamsize n, char delim ) 
 +istream::​streamsize gcount() const            \\ 
 +istream::​istream& ​ ignore ( streamsize n = 1, int delim = EOF ) \\ 
 +istream:: int peek() \\ 
 +istream::​istream & read (char *gdzie, streamsize n)\\ 
 +istream::​stremsize readsome(char* s, streamsize n)\\ 
 +istream::​istream & putback(char c) \\ 
 +istream::​istream & unget()\\ 
 +''​ 
 + 
 +=== Omówienie metod klasy istream === 
 + 
 +== istream::​int get() == 
 +Pobiera jeden znak ze strumienia i zwraca jego wartosc rzutowana na typ integer. 
 + 
 +<code cpp> 
 +//​przyklad 
 +char c, str[256]; 
 +ifstream is; 
 + 
 +cout << "Wpisz nazwe pliku istniejacego w biezacym katalogu";​ 
 +cin.get (str,​256);​ 
 + 
 +is.open (str); ​       // otwieranie pliku 
 + 
 +while (is.good()) ​    // petla trwajaca ile sie da 
 +
 +  c = is.get(); ​      // pobierza znak z pliku 
 +  cout << c; 
 +
 + 
 +is.close(); ​          // zamykanie pliku 
 +</​code>​ 
 + 
 +== istream::​istream&​ get (char& c) == 
 +Pobiera ze strumienia jeden znak i przechowuje go w zmiennej, do ktorej zostala podana referencja c. 
 + 
 + 
 +==istream&​ get(char* s, streamsize n)== 
 +Pobiera ze strumienia n-1 znakow badz pobiera je do momentu wystapienia znaku  ogranicznika (domyslnie znak konca wiersza '​\n'​) i lokuje je do tablicy rozpoczynającej się s. w momencie natrafienia na znak ogranicznika,​ jest on automatycznie dodawany do tablicy s. 
 + 
 + 
 +==istream&​ get (char* s, streamsize n, char delim)== 
 +Podobnie jak wyżej, z tymże przyjmuje znak ogranicznika w argumencie delim. 
 + 
 + 
 +==istream&​ get(streambuf&​ sb)==  
 +Pobiera ze strumienia znaki i lokuje je w buforze strumieniowym sb do momentu napotkania znaku ogranicznika (domyslnie znak konca wiersza '​\n'​) badz znaku konca pliku. 
 + 
 + 
 +==istream&​ get(streambuff&​ sb, char delim)== 
 +Podobnie jak wyżej, z tymże przyjmuje znak ogranicznika w argumencie delim. 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 +==istream&​ getline (char* s, streamsize n )== 
 +Pobiera (n-1) znakow ze strumienia wejsciowego i lokuje je do tablicy rozpoczynajacej sie s. 
 + 
 + 
 +==istream&​ getline (char* s, streamsize n, char delim )== 
 +Pobiera (n-1) znakow ze strumienia wejsciowego badz pobiera je do momentu napotkania znaku ogranicznika delim i lokuje je do tablicy rozpoczynajacej sie s. 
 + 
 +<code cpp> 
 +//​przyklad 
 +void uzyj_getline_gcout() 
 +
 + char tab[10]; 
 + cout << "Podaj tekst o dlugosc do 10 znakow :" << endl; 
 + cin.getline(tab,​ 10); 
 + cout << tab << endl <<"​A operowales przed chwila na ilosci znakow wynoszacej :  " << cin.gcount() << endl; 
 +
 +</​code>​ 
 + 
 + 
 +==istream::​streamsize gcount() const== 
 + 
 +Zwraca ilość znaków wyciągniętych ze strumienia wejściowego podczas istotniej operacji pobrania z niego niesformatowanych danych. 
 + 
 +Przyklad powyzej, z getline() 
 + 
 + 
 +==istream::​istream& ​ ignore ( streamsize n = 1, int delim = EOF )== 
 +Pobiera ze strumienia wejsciowego ilosc znakow podana przez argument n i pomija je. Pobieranie zatrzymuje sie w momencie napotkania na znak ogranicznika delim. 
 + 
 +<code cpp> 
 +//przyklad  
 +char first, last; 
 + 
 +cout << "Podaj imie i nazwisko: "; 
 + 
 +first=cin.get();​ 
 +cin.ignore(256,'​ '); 
 + 
 +last=cin.get();​ 
 + 
 +cout << "Twoje inicjaly to  " << first << last << endl; 
 +</​code>​ 
 + 
 + 
 + 
 + 
 +==istream:: int peek()== 
 + 
 +Odczytuje i zwraca kolejny znak ze strumienia, bez usuwania go stamtąd. 
 + 
 +<code cpp> 
 +//​przyklad 
 +char c; 
 +int n; 
 +char str[256]; 
 + 
 +cout << "Wpisz liczbe lub slowo: "; 
 +c=cin.peek();​ 
 + 
 +if ( (c >= '​0'​) && (c <= '​9'​) ) 
 +
 +  cin >> n; 
 +  cout << "​Wpisales liczbe ​ " << n << endl; 
 +}else{ 
 +  cin >> str; 
 +  cout << " Wpisales slowo " << str << endl; 
 +
 +</​code>​ 
 + 
 + 
 + 
 + 
 +==istream::​istream & read (char *gdzie, streamsize n)== 
 + 
 +Domeną zastosowań tej funkcji są binarne operacje wejścia - wyjścia. Wczytuje ona ze strumienia n znakow i umieszcza je do tablicy, której pierwszy element znajduje się pod adresem gdzie. Nie interesuje jej, czy wczytujemy dane binarne czy teksty. Niezależnie od tego, czy ze strumienia wyjmowane będą znaki alfanumeryczne,​ czy też znaki nowej linii, czy końca pliku - będą one umieszczane we wskazanym miejscu pamięci. Nadaje się np. do wczytywania danych binarnych z pliku dyskowego. 
 +W czasie przesyłania znaków ze strumienia może nastąpić bład - np. zażądaliśmy wczytania 50 znaków, a jest ich w strumieniu tylko 30. Zapali się wówczas flaga ios::​eofbit. Żeby sprawdzić, ile znakow zostało wczytanych, warto użyć funkcji istream::​gcount();​ 
 + 
 +<code cpp> 
 +//​przyklad 
 +char napis[10];​ 
 + 
 +for(int i = 0; i <10; i++) napis[i] = '​0';​ //"​czyszczenie"​ tablicy 
 + 
 +cout << "​Zawartosc tablicy przed : " << napis << endl; 
 +cout << "​Wczytam tylko 4 bajty, napisz cos : "; 
 + 
 +cin.read(napis,​ 4); 
 + 
 +cout << "​Wczytane bajty : " << napis << endl; 
 + 
 +return 0; 
 +</​code>​ 
 + 
 + 
 + 
 +==istream::​stremsize readsome(char* s, streamsize n)== 
 +Działa podobnie jak funkcja read(), z tymże jeżeli znaków w strumieniu jest mniej, niż zażądaliśmy,​ to wczytuje tylko tyle, ile ich jest, bez sygnalizacji błędu.\\ 
 +Zwraca ilość wczytanych znaków. Jeżeli bufor jest pusty, nic nie wczytuje i zwraca zero. 
 +  
 + 
 + 
 +==istream::​istream & putback(char c)== 
 +Pozwala na włożenie z powrotem do strumienia znaku, który został z niego wyjęty. 
 +Wartym odnotowania jest fakt, że standard nie definiuje tego, co by się stało gdybyśmy spróbowali wrzucić do strumienia inny znak, niż został przed chwilą z niego wyczytany. 
 + 
 +<code cpp> 
 +//​przyklad 
 +char c,z; 
 + 
 +cin >> c; 
 + 
 +cout << "​Przeczytany c=" << c << endl; 
 + 
 +cin.putback(c);​ 
 +cin >> z; 
 + 
 +cout << "​Przeczytany z=" << z << endl; 
 + 
 +return 0; 
 + 
 +</​code>​ 
 + 
 + 
 +==istream::​istream & unget()== 
 +Rożni się od funkcji istream::​putback() tym, że przyjmuje znaku, który trzeba włożyć z powrotem"​ do struminia - powinien on być automatycznie rozpoznany przez strumień, przez co jest bezpieczniejsza,​ niż istream::​putback();​ 
 + 
 +==== Klasa ostream ==== 
 +Obiekty klasy ''​ostream''​ są  strumianimy używanymi do wypisywania i formatowania sekwencji znakowych na wyjściu strumienia (ekran, plik na dysku itp). 
 + 
 +=== Spis definicji omówionych metod klasy ostream === 
 +''​ 
 +ostream::​ostream & put(char c);\\ 
 +ostream::​ostream & write(const char* s, streamsize n) 
 +''​ 
 + 
 +=== Omówienie metod klasy ostream === 
 + 
 +==ostream::​ostream & put(char c)== 
 +Służy do wstawienia do strumienia pojedynczego znaku c.\\ 
 +Zwraca jako wynik referencję do strumienia wyjsciowego,​ co pozwala na kaskadowe łączenie użycia tej funkcji, jak w przykładzie.\\ 
 +Czasami wstawienie znaków do strumienia może się nie powieść, np. podczas wstawiania znaków do strumienia płynącego do pliku dyskowego - np. dysk uległ zapełnieniu. Wówczas funkcja zwraca, zamiast refencji - zero.\\ 
 +  
 + 
 +<code cpp> 
 +char napis[] = "​kocham zpr";​ 
 +int i = 0; 
 +do{ 
 + cout.put(napis[i]).put('​-'​);​  
 +}while(napis[++i]);​ 
 +</​code>​ 
 +Efektem działania podanego przekładu będzie wyświetlenie na ekranie 
 +<code cpp> 
 +k-o-c-h-a-m- -z-p-r- 
 +</​code>​ 
 + 
 + 
 + 
 +==ostream::​ostream & write(const char* s, streamsize n)== 
 +Funkcja służy do wstawienia do strumienia żądanej liczby bajtów. \\ 
 +Pierwszy argument jest wskaźnikiem do tablicy char, z której mają być pobrane bajty w celu wstawienia ich do strumienia. Drugi argument definiuje liczbę bajtów (począwszy od miejsca wskazywanego wskaźnikiem),​ które mają być wstawione do strumienia.\\ 
 + 
 + 
 +<code cpp> 
 +char napis[] = "​Rembrandt";​ 
 +int i = 0; 
 +  
 +cout.write(napis+3,​ 4) //​wypisze na ekranie "​bran";​ 
 +</​code>​ 
 + 
 + 
 + 
 + 
 +===== Flagi stanu błędów strumienia ===== 
 +W każdym obiekcie klasy IOSTREAM jest znajduje się słowo odpowiadające za stan błedu strumienia. Jeżeli następuje jakiś błąd pracy strumienia - w tym słowie ustawiany jest bit odpowiadający za daną kategorię blędu. Te kategorie błędów określone są typem całkowitym zdefiniowanym w klasie ''​ios_base''​ :  
 + 
 + 
 +==== ios_base::​enum iostate ==== 
 + 
 +''​ 
 +ios_base::​enum iostate\\ 
 +
 + goodbit = 0,\\ 
 + eofbit ​ = 1,\\ 
 + failbit = 2,\\ 
 + ​ badbit ​ = 4\\ 
 +}; 
 +''​ 
 + 
 +=== ios::​goodbit === 
 +Wartość tego bitu wynosi 0, czyli nie jest to żadna flaga błedu. Stan goodbit jest wtedy, kiedy wszystkie pozostałe flagi są wyzerowane. 
 + 
 +=== ios::​eofbit=== 
 +Flaga ta ustawiana jest wtedy, gdy podczas czytania napotkany został koniec pliku (EOF) 
 + 
 +=== ios::​failbit === 
 +Ustawienie tej flagi oznacza, że jakaś operacja we/wy nie powiodła się. Strumień tkwi w stanie błędu, jednak po wyzerowaniu tej flagi nadaje się do pracy. 
 + 
 +=== ios::badbit === 
 +ustawienie tej flagi oznacza, że nastąpił jakiś powazny błąd naruszający budowę samego strumiania. Dalsza praca z tym strumieniem nie jest już możliwa. 
 + 
 + 
 +==== Funkcje do pracy na flagach błędu ==== 
 +Funkcje te są metodami klasy BASIC_IOS, która jest bezpośrednio pochodna po klasie IOS_BASE, zaś jest bazową klasą dla IOS, dlatego każdy obiekt klasy IOSTREAM posiada dostęp do tych funkcji. 
 + 
 +=== Spis definicji omówionych funkcji do pracy na flagach błędu === 
 +''​ 
 +basic_ios:: bool good(); \\ 
 +basic_ios::​bool eof(); \\ 
 +basic_ios::​bool fail();\\ 
 +basic_ios::​bool bad();\\ 
 +''​ 
 + 
 +=== Omówienie funkcji do pracy na flagach błędu === 
 + 
 + 
 +== basic_ios:: bool good() == 
 +Zwraca wartość true, jeżeli wszystko jest w porządku, czyli żaden z bitów błędu nie jest ustawiony, np. 
 +<code cpp> 
 +char znak; 
 +do{ 
 + cin >> znak; 
 + cout << znak;  
 +}while(cin.good());​ 
 +</​code>​ 
 +Powyższa pętla będzie się wykonywała dopóki nie nastąpi błąd strumienia cin. 
 + 
 + 
 + 
 +==basic_ios::​bool eof()== 
 +Zwraca wartość true, jeżeli jest ustawiona flaga IOS::​eofbit,​ czyli przy operacji wczytywania został napotkany koniec pliku, np. 
 + 
 +<code cpp> 
 +char dane[1000];​ 
 +ifstream s("​wtorek.tmp",​ ios::in | ios::​binary);​ //zakladamy istnienie pliku wtorek.tmp w katalogu,  
 +                                                //w ktorym znajduje sie plik wykonywalny 
 +s.read(dane,​ sizeof(dane));​ 
 +if(s.eof()) 
 +  cout << "​Napotakny EOF przed wczytaniem wszystkich danych"​ << endl; 
 +else 
 +  cout << "​Wszystkie dane wczytane O.K" 
 +</​code>​ 
 + 
 + 
 + 
 + 
 +==basic_ios::​bool fail()== 
 +Zwraca wartość true, gdy failbit lub badbit są ustawione.  
 + 
 +<code cpp> 
 +int liczba; 
 +cin >> liczba; 
 +if(cin.fail()) 
 +  cout << "Zle podana liczba !!" << endl; 
 +</​code>​ 
 +Powyższy przykład pozwala na wychwycenie złego (nieoczekiwanego) ciągu znaków w strumieniu, np. tekstu w momencie oczekiwania na liczbę. 
 + 
 + 
 + 
 +==basic_ios::​bool bad()== 
 +Zwraca wartość true, gdy flaga badbit jest ustawiona, czyli w momencie poważnego uszkodzenia strumienia. 
 + 
 + 
 + 
 +===Ręczne ustawianie i kasowanie flag błędu strumienia=== 
 +Robimy to wtedy, gdy sami chcemy zdecydować o tym, co jest popawną, a co niepoprawną operacją we/wy. Przydaje się to w przypadku operacji we/wy z obiektami typu zdefiniowanego przez użytkownika.\\ 
 + 
 + 
 +w klasie IOS_BASE znajdują się następujące funkcje przydatne przy omawianym zagadnieniu : 
 + 
 +''​ 
 +ios_base::​io_state rdstate(); \\ 
 +ios_base::​void clear(io_state = ios::​goodbit);​ \\ 
 +ios_base::​void setstate(io_state stan); \\ 
 +''​ 
 + 
 + 
 +==ios_base::​io_state rdstate()== 
 +Zwraca jako rezultat słowo typu io_state obrazujące stan flag błędu danego strumienia. 
 + 
 +<code cpp> 
 +if(cin.rdstate() & ios:​failbit) 
 +  cout << "Flaga failbit jest ustawiona"​ << endl; 
 +</​code>​ 
 +Potega funkcji rdstate() tkwi w możliwości całościowego poznania biężącego słowa stanu, które następnie można modyfikować,​ np. za pomocą funkcji clear(). 
 + 
 + 
 +==ios_base::​void clear(io_state = ios::​goodbit)== 
 +Działanie tej funkcji jest takie, że argument będący słowem stanu błędów strumienia (io_state) zastępuje całkowicie dotychczasowe słowo stanu błędów strumienia, wszystkie flagi na raz. Wartość domniemana oznacza, że w nowym słowie żadna flaga błędu nie jest ustawiona. 
 + 
 +<code cpp> 
 +//​przyklad 
 +cin.clear(0);​ //​kasuje wszystkie flagi błędu 
 +cin.clear();​ //​kasuje wszystkie flagi błędu 
 +cin.clear(ios::​eofbit);​ //​ustawia w strumieniu cin flagę eofbit, kasując inne 
 +cin.clear(ios::​eofbit | ios::​failbit);//​ ustawia w strumieniu flagi eofbit i  ​   
 +                                    // failbit  
 +</​code>​ 
 + 
 +<code cpp> 
 +//​przyklad2 
 +io_state slowo_stanu;​ 
 +slowo_stanu = wejscie.rdstate();​ //​odczytanie dotychczasowego stanu 
 +  
 +slowo_stanu |= ios::​eofbit;​ //"​dopalenie"​ flagi ios::​eofbit 
 +wejscie.clear(slowo_stanu);​ //"​podrzucenie"​ noweo slowa stanu 
 +</​code>​ 
 +Powyzszy przyklad dokleja flage ''​ios::​eofbit''​ do bieżącego słowa stanu 
 + 
 + 
 +==ios_base::​void setstate(io_state stan)== 
 +Funkcja ta ułatwia "​dopalenie"​ jednej flagi do biężącego słowa stanu. 
 +Jej definicja to: 
 +<code cpp> 
 +//​definicja 
 +void setstate(io_state f) 
 +
 + clear(rdstate() | f); 
 +
 +</​code>​ 
  
-ios_base::​floatfield 
- Ta maska (pole) odpowiada za typ notacji, reprezentuje flagi: 
- -ios_base::​scientific //​notacja naukowa (wykładnicza) 
- -ios_base::​fixed //​notacja zwykla 
  
  
klasy_bazowe_dla_strumieni.1229185027.txt.gz · ostatnio zmienione: 2008/12/13 17:17 przez siemionides