newlib/libc/stdio/dprintf.c

   1 /* Copyright 2005, 2007 Shaun Jackman
   2  * Permission to use, copy, modify, and distribute this software
   3  * is freely granted, provided that this notice is preserved.
   4  */
   5
   6 /*
   7 FUNCTION
   8 <<dprintf>>, <<vdprintf>>---print to a file descriptor
   9
  10 INDEX
  11         dprintf
  12 INDEX
  13         _dprintf_r
  14 INDEX
  15         vdprintf
  16 INDEX
  17         _vdprintf_r
  18
  19 SYNOPSIS
  20         #include <stdio.h>
  21         #include <stdarg.h>
  22         int dprintf(int <[fd]>, const char *restrict <[format]>, ...);
  23         int vdprintf(int <[fd]>, const char *restrict <[format]>,
  24                         va_list <[ap]>);
  25         int _dprintf_r(struct _reent *<[ptr]>, int <[fd]>,
  26                         const char *restrict <[format]>, ...);
  27         int _vdprintf_r(struct _reent *<[ptr]>, int <[fd]>,
  28                         const char *restrict <[format]>, va_list <[ap]>);
  29
  30 DESCRIPTION
  31 <<dprintf>> and <<vdprintf>> allow printing a format, similarly to
  32 <<printf>>, but write to a file descriptor instead of to a <<FILE>>
  33 stream.
  34
  35 The functions <<_dprintf_r>> and <<_vdprintf_r>> are simply
  36 reentrant versions of the functions above.
  37
  38 RETURNS
  39 The return value and errors are exactly as for <<write>>, except that
  40 <<errno>> may also be set to <<ENOMEM>> if the heap is exhausted.
  41
  42 PORTABILITY
  43 This function is originally a GNU extension in glibc and is not portable.
  44
  45 Supporting OS subroutines required: <<sbrk>>, <<write>>.
  46 */
  47
  48 #include <_ansi.h>
  49 #include <reent.h>
  50 #include <stdio.h>
  51 #include <unistd.h>
  52 #include <stdarg.h>
  53 #include "local.h"
  54
  55 int
  56 _dprintf_r (struct _reent *ptr,
  57        int fd,
  58        const char *__restrict format, ...)
  59 {
  60         va_list ap;
  61         int n;
  62         _REENT_SMALL_CHECK_INIT (ptr);
  63         va_start (ap, format);
  64         n = _vdprintf_r (ptr, fd, format, ap);
  65         va_end (ap);
  66         return n;
  67 }
  68
  69 #ifdef _NANO_FORMATTED_IO
  70 int
  71 _diprintf_r (struct _reent *, int, const char *, ...)
  72        _ATTRIBUTE ((__alias__("_dprintf_r")));
  73 #endif
  74
  75 #ifndef _REENT_ONLY
  76
  77 int
  78 dprintf (int fd,
  79        const char *__restrict format, ...)
  80 {
  81   va_list ap;
  82   int n;
  83   struct _reent *ptr = _REENT;
  84
  85   _REENT_SMALL_CHECK_INIT (ptr);
  86   va_start (ap, format);
  87   n = _vdprintf_r (ptr, fd, format, ap);
  88   va_end (ap);
  89   return n;
  90 }
  91
  92 #ifdef _NANO_FORMATTED_IO
  93 int
  94 diprintf (int, const char *, ...)
  95        _ATTRIBUTE ((__alias__("dprintf")));
  96 #endif
  97 #endif /* ! _REENT_ONLY */