_putw
Zapisuje liczbę całkowitą w strumieniu.
Składnia
int _putw(
int binint,
FILE *stream
);
Parametry
binint
Liczba całkowita binarna, która ma być danymi wyjściowymi.
stream
Wskaźnik do FILE struktury.
Wartość zwracana
Zwraca zapisaną wartość. Wartość zwracana EOF może wskazywać błąd. Ponieważ EOF jest również wiarygodną wartością całkowitą, użyj polecenia ferror , aby zweryfikować błąd. Jeśli stream jest wskaźnikiem o wartości null, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonywanie jest dozwolone do kontynuowania, ta funkcja ustawia errno wartość EINVAL i zwraca wartość EOF.
Aby uzyskać informacje o tych i innych kodach błędów, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.
Uwagi
Funkcja _putw zapisuje wartość binarną typu int na bieżącej pozycji strumienia . _putw Nie wpływa na wyrównanie elementów w strumieniu ani nie zakłada żadnego specjalnego wyrównania. _putw Jest to przede wszystkim zgodność z poprzednimi bibliotekami. Mogą wystąpić problemy z przenośnością, _putw ponieważ rozmiar i int kolejność bajtów w różnych int systemach.
Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.
Wymagania
| Procedura | Wymagany nagłówek |
|---|---|
_putw |
<stdio.h> |
Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.
Biblioteki
Wszystkie wersje bibliotek czasu wykonywania języka C.
Przykład
// crt_putw.c
/* This program uses _putw to write a
* word to a stream, then performs an error check.
*/
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
unsigned u;
if( fopen_s( &stream, "data.out", "wb" ) )
exit( 1 );
for( u = 0; u < 10; u++ )
{
_putw( u + 0x2132, stream ); /* Write word to stream. */
if( ferror( stream ) ) /* Make error check. */
{
printf( "_putw failed" );
clearerr_s( stream );
exit( 1 );
}
}
printf( "Wrote ten words\n" );
fclose( stream );
}
Wynik
Wrote ten words