SW006014 Microchip Technology, SW006014 Datasheet - Page 93

• Manufacturer Part Number: SW006014
• Description: C COMPILER MPLAB FOR PIC24 MCU
• Manufacturer: Microchip Technology
• Type: MPLAB® C Compilerr
• Series: PIC24r

Specifications of SW006014

• Supported Families: PIC24
• Core Architecture: PIC
• Kit Contents: Software And Docs
• Mcu Supported Families: PIC24
• Tool Function: Compiler
• Tool Type: Compiler
• Processor Series: PIC24
• Lead Free Status / RoHS Status: Not applicable / Not applicable
• For Use With/related Products: PIC24
• Lead Free Status / Rohs Status: Lead free / RoHS Compliant

© 2008 Microchip Technology Inc.
vsprintf
Description:
Include:
Prototype:
Arguments:
Return Value:
Remarks:
Example:
Prints formatted text to a string using a variable length argument list
<stdio.h>
<stdarg.h>
int vsprintf(char *s, const char *format, va_list
ap);
s
format
ap
Returns number of characters stored in s excluding the terminating null
character.
The format argument has the same syntax and use that it has in
printf.
To access the variable length argument list, the ap variable must be ini-
tialized by the macro va_start and may be reinitialized by additional
calls to va_arg. This must be done before the vsprintf function is
called. Invoke va_end after the function returns. For more details see
stdarg.h
#include <stdio.h>
#include <stdarg.h>
void errmsg(const char *fmt, ...)
{
}
int main(void)
{
}
Output:
Error: The letter 'a' is not an integer value.
Error: Requires 3 or more characters.
va_list ap;
char buf[100];
va_start(ap, fmt);
vsprintf(buf, fmt, ap);
va_end(ap);
printf("Error: %s", buf);
int num = 3;
errmsg("The letter '%c' is not %s\n", 'a',
errmsg("Requires %d%s\n", num,
"an integer value.");
" or more characters.\n");
storage string for output
format control string
pointer to a list of arguments
/* for vsprintf, printf */
/* for va_start,
/* va_list, va_end
DS51456E-page 89
*/
*/