SOL_OS API reference

Solar_OS API Reference

PROC Str_Printf CDECL
	USES	ecx,edx,ebx,esi,edi
	ARG	dest_str_ptr, format_str_ptr, params

This function will print and convert a series of values and strings into a destination string as controled by a format string.

It generates ASCII null terminated strings.

Arguments:

Argument	Type	Description
dest_str_ptr	dword	pointer to destination string
format_str_ptr	dword	pointer to format string
params	dword(s)	first item from a variable number of arguments

Returns:

formated null terminated string located at dest_str_ptr

Posible Errors:

destination string does not have enough space
unknown format code
wrong number of parameters

Known format codes:

Format codes start with the ASCII "%" character. If you need to output the "%" then use "%%". Only a limited set of formats is curently implemented.

Format code Param Type Description

%x dword - value 32 bits hexadecimal number

%u dword - value decimal unsigned number

%s dword - string ptr inserts a string

%% nothing outputs a single "%"

Format code	Param Type	Description
%x	dword - value	32 bits hexadecimal number
%u	dword - value	decimal unsigned number
%s	dword - string ptr	inserts a string
%%	nothing	outputs a single "%"

Remarks: