scuffed-code/icu4c/source/extra/ustdio/uprintf.h
2000-05-18 22:08:39 +00:00

96 lines
3.2 KiB
C

/*
*******************************************************************************
*
* Copyright (C) 1998-1999, International Business Machines
* Corporation and others. All Rights Reserved.
*
*******************************************************************************
*
* File uprintf.h
*
* Modification History:
*
* Date Name Description
* 11/19/98 stephen Creation.
* 03/12/99 stephen Modified for new C API.
*******************************************************************************
*/
#ifndef UPRINTF_H
#define UPRINTF_H
#include "unicode/utypes.h"
#include "unicode/ustdio.h"
#include "ufmt_cmn.h"
/**
* Struct encapsulating a single uprintf format specification.
*/
struct u_printf_spec_info {
UChar fSpec; /* Conversion specification */
int32_t fPrecision; /* Precision */
int32_t fWidth; /* Width */
UChar fPadChar; /* Padding character */
UBool fAlt; /* # flag */
UBool fSpace; /* Space flag */
UBool fLeft; /* - flag */
UBool fShowSign; /* + flag */
UBool fZero; /* 0 flag */
UBool fIsLongDouble; /* L flag */
UBool fIsShort; /* h flag */
UBool fIsLong; /* l flag */
UBool fIsLongLong; /* ll flag */
};
typedef struct u_printf_spec_info u_printf_spec_info;
/**
* A u_printf info function.
* A u_printf info is reponsible for reporting to u_printf how many
* arguments are required for the <TT>u_printf_spec_info</TT> <TT>info</TT>,
* and what their types are.
* @param info A pointer to a <TT>u_print_info</TT> struct containing
* information on the format specification.
* @param argtypes The array to receive the types of arguments specified
* by <TT>info</TT>.
* @param n The number of available slots in the array <TT>argtypes</TT>
* @return The number of arguments required by <TT>info</TT>.
*/
typedef int32_t (*u_printf_info) (const u_printf_spec_info *info,
int32_t *argtypes,
int32_t n);
/**
* A u_printf handler function.
* A u_printf handler is responsible for handling a single u_printf
* format specification, for example 'd' or 's'.
* @param stream The UFILE to which to write output.
* @param info A pointer to a <TT>u_printf_spec_info</TT> struct containing
* information on the format specification.
* @param args A pointer to the argument data
* @return The number of Unicode characters written to <TT>stream</TT>.
*/
typedef int32_t (*u_printf_handler) (UFILE *stream,
const u_printf_spec_info *info,
const ufmt_args *args);
/**
* Register a uprintf handler function with uprintf.
* @param spec The format specififier handled by the handler <TT>func</TT>.
* @param info A pointer to the <TT>uprintf_info</TT> function used
* to determine how many arguments are required for <TT>spec</TT>, and
* what their types are.
* @param handler A pointer to the <TT>uprintf_handler</TT> function.
* @return 0 if successful
*/
int32_t
u_printf_register_handler(UChar spec,
u_printf_info info,
u_printf_handler handler);
#endif