tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add full description of the Format string to the file header of the Print Library 

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6903 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
mdkinney 2008-12-07 22:56:33 +00:00
parent 9bfdfa522d
commit b7ca87839d
1 changed files with 152 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

152
MdePkg/Include/Library/PrintLib.h
View File

@ -11,6 +11,158 @@ http://opensource.org/licenses/bsd-license.php
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
The Print Library functions provide a simple means to produce formatted output
strings. Many of the output functions use a format string to describe how to
format the output of variable arguments. The format string consists of normal
text and argument descriptors. There are no restrictions for how the normal
text and argument descriptors can be mixed. A normal text character '\n' must
always be converted to '\n\r'. This does not follow the ANSI C standard for
sprint(). The format of argument descriptors is described below. The ANSI C
standard for sprint() has been followed for some of the format types, and has
not been followed for others. The exceptions are noted below.
%[flags][width][.precision]type
[flags]:
- -
- The field is left justified. If not flag is not specified, then the
field is right justified.
- space
- Prefix a space character to a number. Only valid for types X, x, and d.
- +
- Prefix a plus character to a number. Only valid for types X, x, and d.
If both space and + are specified, then space is ignored.
- 0
- Pad with 0 characters to the left of a number. Only valid for types
X, x, and d.
- ,
- Place a comma every 3rd digit of the number. Only valid for type d.
If 0 is also specified, then 0 is ignored.
- L, l
- The number being printed is a UINT64. Only valid for types X, x, and d.
If this flag is not specified, then the number being printed is a int.
- NOTE: All invalid flags are ignored.
[width]:
- *
- The width of the field is specified by a UINTN argument in the
argument list.
- number
- The number specified as a decimal value represents the width of
the field.
- NOTE: If [width] is not specified, then a field width of 0 is assumed.
[.precision]:
- *
- The prevision of the field is specified by a UINTN argument in the
argument list.
- number
- The number specified as a decimal value represents the precision of
the field.
- NOTE: If [.precision] is not specified, then a precision of 0 is assumed.
type:
- %
- Print a %%.
- c
- The argument is a Unicode character. ASCII characters can be printed
using this type too by making sure bits 8..15 of the argument are set to 0.
- x
- The argument is a hexadecimal number. The characters used are 0..9 and
A..F. If the flag ‘L’ is not specified, then the argument is assumed
to be an int. This does not follow ANSI C.
- X
- The argument is a hexadecimal number and the number is padded with
zeros. This is equivalent to a format string of “0x”. If the flag
'L' is not specified, then the argument is assumed to be an int.
This does not follow ANSI C.
- d
- The argument is a decimal number. If the flag 'L' is not specified,
then the argument is assumed to be an int.
- p
- The argument is a pointer that is a (VOID *), and it is printed as a
hexadecimal number The characters used are 0..9 and A..F.
- a
- The argument is a pointer to an ASCII string.
This does not follow ANSI C.
- S, s
- The argument is a pointer to a Unicode string.
This does not follow ANSI C.
- g
- The argument is a pointer to a GUID structure. The GUID is printed
in the format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.
This does not follow ANSI C.
- t
- The argument is a pointer to an EFI_TIME structure. The time and
date are printed in the format “mm/dd/yyyy hh:mm”, where mm is the
month zero padded, dd is the day zero padded, yyyy is the year zero
padded, hh is the hour zero padded, and mm is minutes zero padded.
This does not follow ANSI C.
- r
- The argument is a RETURN_STATUS value. This value is converted to
a string following the table below. This does not follow ANSI C.
- RETURN_SUCCESS
- "Success"
- RETURN_LOAD_ERROR
- "Load Error"
- RETURN_INVALID_PARAMETER
- "Invalid Parameter"
- RETURN_UNSUPPORTED
- "Unsupported"
- RETURN_BAD_BUFFER_SIZE
- "Bad Buffer Size"
- RETURN_BUFFER_TOO_SMALL
- "Buffer Too Small"
- RETURN_NOT_READY
- "Not Ready"
- RETURN_DEVICE_ERROR
- "Device Error"
- RETURN_WRITE_PROTECTED
- "Write Protected"
- RETURN_OUT_OF_RESOURCES
- "Out of Resources"
- RETURN_VOLUME_CORRUPTED
- "Volume Corrupt"
- RETURN_VOLUME_FULL
- "Volume Full"
- RETURN_NO_MEDIA
- "No Media"
- RETURN_MEDIA_CHANGED
- "Media changed"
- RETURN_NOT_FOUND
- "Not Found"
- RETURN_ACCESS_DENIED
- "Access Denied"
- RETURN_NO_RESPONSE
- "No Response"
- RETURN_NO_MAPPING
- "No mapping"
- RETURN_TIMEOUT
- "Time out"
- RETURN_NOT_STARTED
- "Not started"
- RETURN_ALREADY_STARTED
- "Already started"
- RETURN_ABORTED
- "Aborted"
- RETURN_ICMP_ERROR
- "ICMP Error"
- RETURN_TFTP_ERROR
- "TFTP Error"
- RETURN_PROTOCOL_ERROR
- "Protocol Error"
- RETURN_WARN_UNKNOWN_GLYPH
- "Warning Unknown Glyph"
- RETURN_WARN_DELETE_FAILURE
- "Warning Delete Failure"
- RETURN_WARN_WRITE_FAILURE
- "Warning Write Failure"
- RETURN_WARN_BUFFER_TOO_SMALL
- "Warning Buffer Too Small"
**/
#ifndef __PRINT_LIB_H__