rom/kernel/formatstr.c

   1 /*
   2     Copyright © 1995-2013, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6 */
   7
   8 #include <aros/kernel.h>
   9 #include <aros/libcall.h>
  10
  11 #include <stdarg.h>
  12 #include <stdio.h>
  13
  14 /*****************************************************************************
  15
  16     NAME */
  17 #include <proto/kernel.h>
  18
  19         AROS_LH3(int, KrnFormatStr,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(void *, putch, A0),
  23         AROS_LHA(const char *, format, A1),
  24         AROS_LHA(va_list, args, A2),
  25
  26 /*  LOCATION */
  27         APTR, KernelBase, 30, Kernel)
  28
  29 /*  FUNCTION
  30         Format a string using C printf() convention, using 'putch'
  31         as character output function.
  32
  33     INPUTS
  34         putch  - A pointer to the output function
  35         format - A format string
  36         args   - A list of arguments
  37
  38         A character output function needs to be declared as:
  39
  40         int myPutCh(int char, void *KernelBase)
  41
  42         It is expected to return 1 on success and 0 on failure.
  43
  44     RESULT
  45         Number of succesfully printed characters
  46
  47     NOTES
  48
  49     EXAMPLE
  50
  51     BUGS
  52
  53     SEE ALSO
  54
  55     INTERNALS
  56
  57 ******************************************************************************/
  58 {
  59     AROS_LIBFUNC_INIT
  60
  61     return __vcformat(KernelBase, putch, format, args);
  62
  63     AROS_LIBFUNC_EXIT
  64 }