Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.atnf.csiro.au/people/mcalabre/WCS/wcslib/wcsprintf_8h.html
Дата изменения: Unknown Дата индексирования: Sun Apr 10 23:48:46 2016 Кодировка: Поисковые слова: earth's atmosphere |
WCSLIB
5.15
|
#include <stdio.h>
Go to the source code of this file.
Macros | |
#define | WCSPRINTF_PTR(str1, ptr, str2) |
Print addresses in a consistent way. More... | |
Functions | |
int | wcsprintf_set (FILE *wcsout) |
Set output disposition for wcsprintf() and wcsfprintf(). More... | |
int | wcsprintf (const char *format,...) |
Print function used by WCSLIB diagnostic routines. More... | |
int | wcsfprintf (FILE *stream, const char *format,...) |
Print function used by WCSLIB diagnostic routines. More... | |
const char * | wcsprintf_buf (void) |
Get the address of the internal string buffer. More... | |
Routines in this suite allow diagnostic output from celprt(), linprt(), prjprt(), spcprt(), tabprt(), wcsprt(), and wcserr_prt() to be redirected to a file or captured in a string buffer. Those routines all use wcsprintf() for output. Likewise wcsfprintf() is used by wcsbth() and wcspih(). Both functions may be used by application programmers to have other output go to the same place.
#define WCSPRINTF_PTR | ( | str1, | |
ptr, | |||
str2 | |||
) |
WCSPRINTF_PTR() is a preprocessor macro used to print addresses in a consistent way.
On some systems the "p" format descriptor renders a NULL pointer as the string "0x0". On others, however, it produces "0" or even "(nil)". On some systems a non-zero address is prefixed with "0x", on others, not.
The WCSPRINTF_PTR() macro ensures that a NULL pointer is always rendered as "0x0" and that non-zero addresses are prefixed with "0x" thus providing consistency, for example, for comparing the output of test programs.
int wcsprintf_set | ( | FILE * | wcsout | ) |
wcsprintf_set() sets the output disposition for wcsprintf() which is used by the celprt(), linprt(), prjprt(), spcprt(), tabprt(), wcsprt(), and wcserr_prt() routines, and for wcsfprintf() which is used by wcsbth() and wcspih().
[in] | wcsout | Pointer to an output stream that has been opened for writing, e.g. by the fopen() stdio library function, or one of the predefined stdio output streams - stdout and stderr. If zero (NULL), output is written to an internally-allocated string buffer, the address of which may be obtained by wcsprintf_buf(). |
int wcsprintf | ( | const char * | format, |
... | |||
) |
wcsprintf() is used by celprt(), linprt(), prjprt(), spcprt(), tabprt(), wcsprt(), and wcserr_prt() for diagnostic output which by default goes to stdout. However, it may be redirected to a file or string buffer via wcsprintf_set().
[in] | format | Format string, passed to one of the printf(3) family of stdio library functions. |
[in] | ... | Argument list matching format, as per printf(3). |
int wcsfprintf | ( | FILE * | stream, |
const char * | format, | ||
... | |||
) |
wcsfprintf() is used by wcsbth(), and wcspih() for diagnostic output which they send to stderr. However, it may be redirected to a file or string buffer via wcsprintf_set().
[in] | stream | The output stream if not overridden by a call to wcsprintf_set(). |
[in] | format | Format string, passed to one of the printf(3) family of stdio library functions. |
[in] | ... | Argument list matching format, as per printf(3). |
wcsprintf_buf | ( | void | ) |
wcsprintf_buf() returns the address of the internal string buffer created when wcsprintf_set() is invoked with its FILE* argument set to zero.