« WriteConsole, funkcja »
Zapisuje łańcuch znaków do bufora ekranu konsoli. (funkcja)
Logowanie
Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Zapomniałem hasła
Polska dokumentacja C++ » Biblioteki C/C++ » WinAPI » Konsola
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

WriteConsole

[funkcja] Zapisuje łańcuch znaków do bufora ekranu konsoli.

Składnia

C/C++
#include <windows.h>

BOOL WINAPI WriteConsole(
HANDLE hConsoleOutput,
const VOID * lpBuffer,
DWORD nNumberOfCharsToWrite,
LPDWORD lpNumberOfCharsWritten,
LPVOID lpReserved
);

Argumenty

ArgumentOpis
hConsoleInputUchwyt do bufora wejściowego konsoli. Uchwyt musi mieć dostęp GENERIC_WRITE.
lpBufferWskaźnik do bufora zawierającego dane zapisywane do bufora ekranu konsoli. Miejsce w pamięci na ten bufor jest alokowane na stercie dla procesu zajmującego 64 KB pamięci. Maksymalny rozmiar bufora zależy od użycia sterty.
nNumberOfCharsToWriteLiczba znaków do zapisania. Jeśli rozmiar bufora określony przez wartość tego argumentu przekracza rozmiar dostępny na stercie, funkcja zakończy się z błędem ERROR_NOT_ENOUGH_MEMORY.
lpNumberOfCharsWrittenWskaźnik do zmiennej pobierającej liczbę zapisanych znaków.
lpReservedZarezerwowany argument, musi mieć wartość NULL.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję » WinAPI ♦ GetLastError.

Dodatkowe informacje

Funkcja zapisuje znaki do bufora ekranu konsoli zaczynając od obecnej pozycji kursora. Pozycja kursora zostanie zmieniona podczas zapisywania danych. Znaki są zapisywane przy użyciu atrybutów kolorów tła i tekstu powiązanych z buforem ekranu konsoli. Wszystkie tryby wejściowe zmieniające działanie funkcji WriteFile mają ten sam wpływ na tą funkcję. Ta funkcja pozwala na używanie zarówno znaków w formacie ANSI, jak również Unicode. Jest to związane z obecną stroną kodową konsoli. Domyślna strona kodowa jest stroną kodową OEM. Do zmiany strony kodowej służą funkcje » WinAPI ♦ SetConsoleCP oraz » WinAPI ♦ SetConsoleOutputCP. Można również użyć polecenia
chcp
 lub
mode con cp select=id_strony_kodowej
. Funkcja zakończy się niepowodzeniem, jeśli zostanie wywołana ze standardowym uchwytem do pliku. W niektórych przypadkach funkcja może sprawdzić, czy uchwyt do wyjścia jest uchwytem powiązanym z konsolą. Jeśli uchwyt jest uchwytem do konsoli, zostanie wywołana ta funkcja. Jeśli uchwyt nie jest ucwytem do konsoli, wyjście zostanie przekierowane i wtedy należy wywołać funkcję WriteFile. Należy pamiętać, aby przed zapisaniem pliku tekstowego w formacie Unicode ustawić właściwą kolejność bajtów.

Wymagania

Minimalny system klientaWindows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serweraWindows 2000 Server (tylko aplikacje biurowe).
NagłówekWincon.h (dołącza Windows.h)
BibliotekaKernel32.lib
DLLKernel32.dll
UNICODEWriteConsoleW
ANSIWriteConsoleA

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.
Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.
© Wszelkie prawa zastrzeżone 2005-2024