_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

Zobacz też

We/Wy strumienia
_getw