rom/kernel/formatstr.c

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