|
T
X
T
_
D
E
B
U
G
P
R
I
N
T
F
(
)
| | | | |
SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English
PORTA - TXT_#?
----------------------------------------------------------------------------
NAME
txt_debugprintf() - Produces output according to the
formating options and sends it over
the built-in serial port.
SYNOPSIS
txt_debugprintf(maxwrite, fmt, ...);
__nifunc __interrupt LONG txt_debugprintf(
LONG, const UBYTE *, ...);
FUNCTION
This func. wraps 'txt_vcbpsnprintf()' to form something
like 'kprintf()'.
INPUTS
maxwrite - Maximum write size.
fmt - Formatting string.
... - Additional arguments.
RETURNS
Returns what 'txt_vpsnprintf()' returns(amount of text
transferred).
BASES
None.
NOTES
This function acts and behaves like 'kprintf()' so progs
like: 'sushi' or 'sashimi' allow redirection.
This func. is guaranteed to return after 'maxwrite' bytes
of potential garbage.
Warning! This function may arbitrate with 'Disable()' /
'Enable()' pair ! See 'Makefile'.
See 'txt_vpsnprintf()' for available formatting options.
Beware! Using '%b' with BCPL data on stack may result in
address mess! All addresses to be BCPLed must be multiple
of 4! See 'testsuite/textfuncs-test.c' for more details.
Can be used without defining and initialising any bases,
and/or without opening any libraries.
If is safe to call this function from tasks and software
interrupts. It is even safe to allow others to call this
function from your context.
Variable list 'txt_vdebugprintf()' exists.
SEE ALSO
txt_vcbpsnprintf(), txt_vpsnprintf()
EXAMPLE
...
txt_debugprintf(32,
"my task: 0x%08lx\n", (ULONG)FindTask(NULL));
BUGS
None known.
----------------------------------------------------------------------------
| |
| |
