printf_p.c 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. /*
  2. * Copyright (C) 2001-2003 by egnite Software GmbH. All rights reserved.
  3. *
  4. * Redistribution and use in source and binary forms, with or without
  5. * modification, are permitted provided that the following conditions
  6. * are met:
  7. *
  8. * 1. Redistributions of source code must retain the above copyright
  9. * notice, this list of conditions and the following disclaimer.
  10. * 2. Redistributions in binary form must reproduce the above copyright
  11. * notice, this list of conditions and the following disclaimer in the
  12. * documentation and/or other materials provided with the distribution.
  13. * 3. Neither the name of the copyright holders nor the names of
  14. * contributors may be used to endorse or promote products derived
  15. * from this software without specific prior written permission.
  16. *
  17. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18. * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  20. * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  21. * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  22. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  23. * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  24. * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  25. * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  26. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
  27. * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28. * SUCH DAMAGE.
  29. *
  30. * For additional information see http://www.ethernut.de/
  31. *
  32. */
  33. /*
  34. * $Log$
  35. * Revision 1.1 2003/05/09 14:40:31 haraldkipp
  36. * Initial revision
  37. *
  38. * Revision 1.2 2003/04/21 16:53:21 harald
  39. * .cvsignore
  40. *
  41. * Revision 1.1 2003/02/04 17:49:08 harald
  42. * *** empty log message ***
  43. *
  44. */
  45. #include "nut_io.h"
  46. /*!
  47. * \addtogroup xgCrtStdio
  48. */
  49. /*@{*/
  50. /*!
  51. * \brief Print formatted output to the standard output stream.
  52. *
  53. * Similar to printf() except that the format string is located in
  54. * program memory.
  55. *
  56. * \param fmt Format string in program space containing conversion
  57. * specifications.
  58. *
  59. * \return The number of characters written or a negative value to
  60. * indicate an error.
  61. *
  62. * \warning Do not use this function with a debug device while running
  63. * in interrupt context.
  64. */
  65. int printf_P(PGM_P fmt, ...)
  66. {
  67. int rc;
  68. va_list ap;
  69. va_start(ap, fmt);
  70. rc = vfprintf_P(stdout, fmt, ap);
  71. va_end(ap);
  72. return rc;
  73. }
  74. /*@}*/