/** @file\r
Unicode and ASCII string primatives.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation<BR>\r
+ Copyright (c) 2006 - 2008, Intel Corporation<BR>\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
\r
**/\r
\r
-//\r
-// Include common header file for this module.\r
-//\r
+#include "BaseLibInternals.h"\r
\r
+#define QUOTIENT_MAX_UINTN_DIVIDED_BY_10 ((UINTN) -1 / 10)\r
+#define REMAINDER_MAX_UINTN_DIVIDED_BY_10 ((UINTN) -1 % 10)\r
\r
-#include "BaseLibInternals.h"\r
+#define QUOTIENT_MAX_UINTN_DIVIDED_BY_16 ((UINTN) -1 / 16)\r
+#define REMAINDER_MAX_UINTN_DIVIDED_BY_16 ((UINTN) -1 % 16)\r
+\r
+#define QUOTIENT_MAX_UINT64_DIVIDED_BY_10 ((UINT64) -1 / 10)\r
+#define REMAINDER_MAX_UINT64_DIVIDED_BY_10 ((UINT64) -1 % 10)\r
+\r
+#define QUOTIENT_MAX_UINT64_DIVIDED_BY_16 ((UINT64) -1 / 16)\r
+#define REMAINDER_MAX_UINT64_DIVIDED_BY_16 ((UINT64) -1 % 16)\r
\r
/**\r
Copies one Null-terminated Unicode string to another Null-terminated Unicode\r
@param Destination Pointer to a Null-terminated Unicode string.\r
@param Source Pointer to a Null-terminated Unicode string.\r
\r
- @return Destiantion\r
+ @return Destination pointing to the copied string.\r
\r
**/\r
CHAR16 *\r
// Destination cannot be NULL\r
//\r
ASSERT (Destination != NULL);\r
- ASSERT (((UINTN) Destination & 0x01) == 0);\r
+ ASSERT (((UINTN) Destination & BIT0) == 0);\r
\r
//\r
// Destination and source cannot overlap\r
ASSERT ((UINTN)(Source - Destination) > StrLen (Source));\r
\r
ReturnValue = Destination;\r
- while (*Source) {\r
+ while (*Source != 0) {\r
*(Destination++) = *(Source++);\r
}\r
*Destination = 0;\r
@param Source Pointer to a Null-terminated Unicode string.\r
@param Length Maximum number of Unicode characters to copy.\r
\r
- @return Destination\r
+ @return Destination pointing to the copied string.\r
\r
**/\r
CHAR16 *\r
// Destination cannot be NULL if Length is not zero\r
//\r
ASSERT (Destination != NULL);\r
- ASSERT (((UINTN) Destination & 0x01) == 0);\r
+ ASSERT (((UINTN) Destination & BIT0) == 0);\r
\r
//\r
// Destination and source cannot overlap\r
- // Q: Does Source have to be NULL-terminated?\r
//\r
ASSERT ((UINTN)(Destination - Source) > StrLen (Source));\r
ASSERT ((UINTN)(Source - Destination) >= Length);\r
UINTN Length;\r
\r
ASSERT (String != NULL);\r
- ASSERT (((UINTN) String & 0x01) == 0);\r
+ ASSERT (((UINTN) String & BIT0) == 0);\r
\r
for (Length = 0; *String != L'\0'; String++, Length++) {\r
//\r
\r
@param String Pointer to a Null-terminated Unicode string.\r
\r
- @return The size of String.\r
+ @return The size in bytes of String.\r
\r
**/\r
UINTN\r
@param FirstString Pointer to a Null-terminated Unicode string.\r
@param SecondString Pointer to a Null-terminated Unicode string.\r
\r
- @retval 0 FirstString is identical to SecondString.\r
- @retval !=0 FirstString is not identical to SecondString.\r
+ @retval 0 FirstString is identical to SecondString.\r
+ @return The first mismatched Unicode character in SecondString subtracted\r
+ from the first mismatched Unicode character in FirstString.\r
\r
**/\r
INTN\r
@param SecondString Pointer to a Null-terminated Unicode string.\r
@param Length Maximum number of Unicode characters to compare.\r
\r
- @retval 0 FirstString is identical to SecondString.\r
- @retval !=0 FirstString is not identical to SecondString.\r
+ @retval 0 FirstString is identical to SecondString.\r
+ @return The value returned is the first mismatched Unicode character in SecondString\r
+ subtracted from the first mismatched Unicode character in FirstString.\r
\r
**/\r
INTN\r
@param Destination Pointer to a Null-terminated Unicode string.\r
@param Source Pointer to a Null-terminated Unicode string.\r
\r
- @return Destination\r
+ @return Destination pointing to the concatenated Unicode string.\r
\r
**/\r
CHAR16 *\r
@param Length Maximum number of Unicode characters to concatenate from\r
Source.\r
\r
- @return Destination\r
+ @return Destination pointing to the concatenated Unicode string.\r
\r
**/\r
CHAR16 *\r
or String contains more than PcdMaximumUnicodeStringLength Unicode \r
characters not including the Null-terminator, then ASSERT().\r
\r
- @param String Pointer to a Null-terminated Unicode string.\r
+ @param String Pointer to a Null-terminated Unicode string.\r
@param SearchString Pointer to a Null-terminated Unicode string to search for.\r
\r
- @retval NULL If the SearchString does not appear in String.\r
- @retval !NULL If there is a match.\r
+ @retval NULL If the SearchString does not appear in String.\r
+ @return Pointer to the matching sub-string.\r
\r
**/\r
CHAR16 *\r
decimal character. The valid decimal character is from\r
L'0' to L'9'.\r
\r
-\r
@param Char The character to check against.\r
\r
@retval TRUE If the Char is a decmial character.\r
- @retval FALSE Otherwise.\r
+ @retval FALSE If the Char is not a decmial character.\r
\r
**/\r
-STATIC\r
BOOLEAN\r
+EFIAPI\r
InternalIsDecimalDigitCharacter (\r
IN CHAR16 Char\r
)\r
it maps to a valid small-case ASCII character.\r
\r
This internal function only deal with Unicode character\r
- which maps to a valid small-case ASII character, i.e.\r
+ which maps to a valid small-case ASCII character, i.e.\r
L'a' to L'z'. For other Unicode character, the input character\r
is returned directly.\r
\r
-\r
@param Char The character to convert.\r
\r
@retval LowerCharacter If the Char is with range L'a' to L'z'.\r
@retval Unchanged Otherwise.\r
\r
**/\r
-STATIC\r
CHAR16\r
+EFIAPI\r
InternalCharToUpper (\r
IN CHAR16 Char\r
)\r
\r
@param Char The character to convert.\r
\r
- @retval UINTN The numerical value converted.\r
+ @return The numerical value converted.\r
\r
**/\r
-STATIC\r
UINTN\r
+EFIAPI\r
InternalHexCharToUintn (\r
IN CHAR16 Char\r
)\r
@param Char The character to check against.\r
\r
@retval TRUE If the Char is a hexadecmial character.\r
- @retval FALSE Otherwise.\r
+ @retval FALSE If the Char is not a hexadecmial character.\r
\r
**/\r
-STATIC\r
BOOLEAN\r
+EFIAPI\r
InternalIsHexaDecimalDigitCharacter (\r
IN CHAR16 Char\r
)\r
\r
@param String Pointer to a Null-terminated Unicode string.\r
\r
- @retval UINTN \r
+ @return The value of type UINTN converted.\r
\r
**/\r
UINTN\r
// If the number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINTN_DIVIDED_BY_10) ||\r
- ((Result == QUIENT_MAX_UINTN_DIVIDED_BY_10) &&\r
- (*String - L'0') <= REMINDER_MAX_UINTN_DIVIDED_BY_10)\r
+ ASSERT ((Result < QUOTIENT_MAX_UINTN_DIVIDED_BY_10) ||\r
+ ((Result == QUOTIENT_MAX_UINTN_DIVIDED_BY_10) &&\r
+ (*String - L'0') <= REMAINDER_MAX_UINTN_DIVIDED_BY_10)\r
);\r
\r
Result = Result * 10 + (*String - L'0');\r
\r
@param String Pointer to a Null-terminated Unicode string.\r
\r
- @retval UINT64 \r
+ @return The value of type UINT64 converted.\r
\r
**/\r
UINT64\r
// If the number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINT64_DIVIDED_BY_10) || \r
- ((Result == QUIENT_MAX_UINT64_DIVIDED_BY_10) && \r
- (*String - L'0') <= REMINDER_MAX_UINT64_DIVIDED_BY_10)\r
+ ASSERT ((Result < QUOTIENT_MAX_UINT64_DIVIDED_BY_10) || \r
+ ((Result == QUOTIENT_MAX_UINT64_DIVIDED_BY_10) && \r
+ (*String - L'0') <= REMAINDER_MAX_UINT64_DIVIDED_BY_10)\r
);\r
\r
Result = MultU64x32 (Result, 10) + (*String - L'0');\r
\r
@param String Pointer to a Null-terminated Unicode string.\r
\r
- @retval UINTN\r
+ @return The value of type UINTN converted.\r
\r
**/\r
UINTN\r
}\r
\r
if (InternalCharToUpper (*String) == L'X') {\r
- ASSERT (*(String - 1) == L'0');\r
- if (*(String - 1) != L'0') {\r
+ ASSERT (*(String - 1) == L'0');\r
+ if (*(String - 1) != L'0') {\r
return 0;\r
}\r
//\r
// If the Hex Number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINTN_DIVIDED_BY_16) ||\r
- ((Result == QUIENT_MAX_UINTN_DIVIDED_BY_16) && \r
- (InternalHexCharToUintn (*String) <= REMINDER_MAX_UINTN_DIVIDED_BY_16))\r
+ ASSERT ((Result < QUOTIENT_MAX_UINTN_DIVIDED_BY_16) ||\r
+ ((Result == QUOTIENT_MAX_UINTN_DIVIDED_BY_16) && \r
+ (InternalHexCharToUintn (*String) <= REMAINDER_MAX_UINTN_DIVIDED_BY_16))\r
);\r
\r
Result = (Result << 4) + InternalHexCharToUintn (*String);\r
\r
@param String Pointer to a Null-terminated Unicode string.\r
\r
- @retval UINT64\r
+ @return The value of type UINT64 converted.\r
\r
**/\r
UINT64\r
}\r
\r
if (InternalCharToUpper (*String) == L'X') {\r
- ASSERT (*(String - 1) == L'0');\r
- if (*(String - 1) != L'0') {\r
+ ASSERT (*(String - 1) == L'0');\r
+ if (*(String - 1) != L'0') {\r
return 0;\r
}\r
//\r
// If the Hex Number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINT64_DIVIDED_BY_16)|| \r
- ((Result == QUIENT_MAX_UINT64_DIVIDED_BY_16) && \r
- (InternalHexCharToUintn (*String) <= REMINDER_MAX_UINT64_DIVIDED_BY_16))\r
+ ASSERT ((Result < QUOTIENT_MAX_UINT64_DIVIDED_BY_16)|| \r
+ ((Result == QUOTIENT_MAX_UINT64_DIVIDED_BY_16) && \r
+ (InternalHexCharToUintn (*String) <= REMAINDER_MAX_UINT64_DIVIDED_BY_16))\r
);\r
\r
Result = LShiftU64 (Result, 4);\r
@param Char The character to check against.\r
\r
@retval TRUE If the Char is a decmial character.\r
- @retval FALSE Otherwise.\r
+ @retval FALSE If the Char is not a decmial character.\r
\r
**/\r
-STATIC\r
BOOLEAN\r
+EFIAPI\r
InternalAsciiIsDecimalDigitCharacter (\r
IN CHAR8 Char\r
)\r
@param Char The character to check against.\r
\r
@retval TRUE If the Char is a hexadecmial character.\r
- @retval FALSE Otherwise.\r
+ @retval FALSE If the Char is not a hexadecmial character.\r
\r
**/\r
-STATIC\r
BOOLEAN\r
+EFIAPI\r
InternalAsciiIsHexaDecimalDigitCharacter (\r
IN CHAR8 Char\r
)\r
@param Source Pointer to a Null-terminated Unicode string.\r
@param Destination Pointer to a Null-terminated ASCII string.\r
\r
- @return Destination\r
+ @return Destination pointing to the converted ASCII string.\r
\r
**/\r
CHAR8 *\r
@param Destination Pointer to a Null-terminated ASCII string.\r
@param Source Pointer to a Null-terminated ASCII string.\r
\r
- @return Destination\r
+ @return Destination pointing to the copied string.\r
\r
**/\r
CHAR8 *\r
ASSERT ((UINTN)(Source - Destination) > AsciiStrLen (Source));\r
\r
ReturnValue = Destination;\r
- while (*Source) {\r
+ while (*Source != 0) {\r
*(Destination++) = *(Source++);\r
}\r
*Destination = 0;\r
@param Source Pointer to a Null-terminated ASCII string.\r
@param Length Maximum number of ASCII characters to copy.\r
\r
- @return Destination\r
+ @return Destination pointing to the copied string.\r
\r
**/\r
CHAR8 *\r
\r
ReturnValue = Destination;\r
\r
- while (*Source && Length > 0) {\r
+ while (*Source != 0 && Length > 0) {\r
*(Destination++) = *(Source++);\r
Length--;\r
}\r
@param FirstString Pointer to a Null-terminated ASCII string.\r
@param SecondString Pointer to a Null-terminated ASCII string.\r
\r
- @retval 0 FirstString is identical to SecondString.\r
- @retval !=0 FirstString is not identical to SecondString.\r
+ @retval 0 FirstString is identical to SecondString.\r
+ @return The first mismatched ASCII character in SecondString subtracted\r
+ from the first mismatched ASCII character in FirstString.\r
\r
**/\r
INTN\r
}\r
\r
/**\r
- Converts a lowercase Ascii character to upper one\r
+ Converts a lowercase Ascii character to upper one.\r
\r
If Chr is lowercase Ascii character, then converts it to upper one.\r
\r
If Value >= 0xA0, then ASSERT().\r
If (Value & 0x0F) >= 0x0A, then ASSERT().\r
\r
- @param chr one Ascii character\r
+ @param Chr one Ascii character\r
\r
@return The uppercase value of Ascii character \r
\r
**/\r
-STATIC\r
CHAR8\r
+EFIAPI\r
AsciiToUpper (\r
IN CHAR8 Chr\r
)\r
\r
@param Char The character to convert.\r
\r
- @retval UINTN The numerical value converted.\r
+ @return The numerical value converted.\r
\r
**/\r
-STATIC\r
UINTN\r
+EFIAPI\r
InternalAsciiHexCharToUintn (\r
IN CHAR8 Char\r
)\r
@param FirstString Pointer to a Null-terminated ASCII string.\r
@param SecondString Pointer to a Null-terminated ASCII string.\r
\r
- @retval 0 FirstString is identical to SecondString using case insensitive\r
- comparisons.\r
- @retval !=0 FirstString is not identical to SecondString using case\r
- insensitive comparisons.\r
+ @retval 0 FirstString is identical to SecondString using case insensitive\r
+ comparisons.\r
+ @return The first mismatched lower case ASCII character in SecondString subtracted\r
+ from the first mismatched lower case ASCII character in FirstString.\r
\r
**/\r
INTN\r
@param SecondString Pointer to a Null-terminated ASCII string.\r
@param Length Maximum number of ASCII characters to compare.\r
\r
- @retval 0 FirstString is identical to SecondString.\r
- @retval !=0 FirstString is not identical to SecondString.\r
+ @retval 0 FirstString is identical to SecondString.\r
+ @return The first mismatched ASCII character in SecondString subtracted from the\r
+ first mismatched ASCII character in FirstString.\r
\r
**/\r
INTN\r
@param Destination Pointer to a Null-terminated ASCII string.\r
@param Source Pointer to a Null-terminated ASCII string.\r
\r
- @return Destination\r
+ @return Destination pointing to the concatenated ASCII string.\r
\r
**/\r
CHAR8 *\r
@param Length Maximum number of ASCII characters to concatenate from\r
Source.\r
\r
- @return Destination\r
+ @return Destination pointing to the concatenated ASCII string.\r
\r
**/\r
CHAR8 *\r
@param SearchString Pointer to a Null-terminated ASCII string to search for.\r
\r
@retval NULL If the SearchString does not appear in String.\r
- @retval !NULL If there is a match.\r
+ @return Pointer to the matching sub-string.\r
\r
**/\r
CHAR8 *\r
\r
@param String Pointer to a Null-terminated ASCII string.\r
\r
- @retval UINTN \r
+ @return The value of type UINTN converted.\r
\r
**/\r
UINTN\r
//\r
// Ignore the pad spaces (space or tab)\r
//\r
- while ((*String == ' ') || (*String == '\t')) {\r
+ while ((*String == ' ') || (*String == '\t' )) {\r
String++;\r
}\r
\r
// If the number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINTN_DIVIDED_BY_10) ||\r
- ((Result == QUIENT_MAX_UINTN_DIVIDED_BY_10) && \r
- (*String - '0') <= REMINDER_MAX_UINTN_DIVIDED_BY_10)\r
+ ASSERT ((Result < QUOTIENT_MAX_UINTN_DIVIDED_BY_10) ||\r
+ ((Result == QUOTIENT_MAX_UINTN_DIVIDED_BY_10) && \r
+ (*String - '0') <= REMAINDER_MAX_UINTN_DIVIDED_BY_10)\r
);\r
\r
Result = Result * 10 + (*String - '0');\r
\r
@param String Pointer to a Null-terminated ASCII string.\r
\r
- @retval UINT64 \r
+ @return The value of type UINT64 converted.\r
\r
**/\r
UINT64\r
//\r
// Ignore the pad spaces (space or tab)\r
//\r
- while ((*String == ' ') || (*String == '\t')) {\r
+ while ((*String == ' ') || (*String == '\t' )) {\r
String++;\r
}\r
\r
// If the number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINT64_DIVIDED_BY_10) || \r
- ((Result == QUIENT_MAX_UINT64_DIVIDED_BY_10) && \r
- (*String - '0') <= REMINDER_MAX_UINT64_DIVIDED_BY_10)\r
+ ASSERT ((Result < QUOTIENT_MAX_UINT64_DIVIDED_BY_10) || \r
+ ((Result == QUOTIENT_MAX_UINT64_DIVIDED_BY_10) && \r
+ (*String - '0') <= REMAINDER_MAX_UINT64_DIVIDED_BY_10)\r
);\r
\r
Result = MultU64x32 (Result, 10) + (*String - '0');\r
\r
@param String Pointer to a Null-terminated ASCII string.\r
\r
- @retval UINTN\r
+ @return The value of type UINTN converted.\r
\r
**/\r
UINTN\r
//\r
// Ignore the pad spaces (space or tab) \r
//\r
- while ((*String == ' ') || (*String == '\t')) {\r
+ while ((*String == ' ') || (*String == '\t' )) {\r
String++;\r
}\r
\r
}\r
\r
if (AsciiToUpper (*String) == 'X') {\r
- ASSERT (*(String - 1) == '0');\r
- if (*(String - 1) != '0') {\r
+ ASSERT (*(String - 1) == '0');\r
+ if (*(String - 1) != '0') {\r
return 0;\r
}\r
//\r
// If the Hex Number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINTN_DIVIDED_BY_16) ||\r
- ((Result == QUIENT_MAX_UINTN_DIVIDED_BY_16) && \r
- (InternalAsciiHexCharToUintn (*String) <= REMINDER_MAX_UINTN_DIVIDED_BY_16))\r
+ ASSERT ((Result < QUOTIENT_MAX_UINTN_DIVIDED_BY_16) ||\r
+ ((Result == QUOTIENT_MAX_UINTN_DIVIDED_BY_16) && \r
+ (InternalAsciiHexCharToUintn (*String) <= REMAINDER_MAX_UINTN_DIVIDED_BY_16))\r
);\r
\r
Result = (Result << 4) + InternalAsciiHexCharToUintn (*String);\r
\r
@param String Pointer to a Null-terminated ASCII string.\r
\r
- @retval UINT64\r
+ @return The value of type UINT64 converted.\r
\r
**/\r
UINT64\r
//\r
// Ignore the pad spaces (space or tab) \r
//\r
- while ((*String == ' ') || (*String == '\t')) {\r
+ while ((*String == ' ') || (*String == '\t' )) {\r
String++;\r
}\r
\r
}\r
\r
if (AsciiToUpper (*String) == 'X') {\r
- ASSERT (*(String - 1) == '0');\r
- if (*(String - 1) != '0') {\r
+ ASSERT (*(String - 1) == '0');\r
+ if (*(String - 1) != '0') {\r
return 0;\r
}\r
//\r
// If the Hex Number represented by String overflows according \r
// to the range defined by UINTN, then ASSERT().\r
//\r
- ASSERT ((Result < QUIENT_MAX_UINT64_DIVIDED_BY_16) ||\r
- ((Result == QUIENT_MAX_UINT64_DIVIDED_BY_16) && \r
- (InternalAsciiHexCharToUintn (*String) <= REMINDER_MAX_UINT64_DIVIDED_BY_16))\r
+ ASSERT ((Result < QUOTIENT_MAX_UINT64_DIVIDED_BY_16) ||\r
+ ((Result == QUOTIENT_MAX_UINT64_DIVIDED_BY_16) && \r
+ (InternalAsciiHexCharToUintn (*String) <= REMAINDER_MAX_UINT64_DIVIDED_BY_16))\r
);\r
\r
Result = LShiftU64 (Result, 4);\r
@param Source Pointer to a Null-terminated ASCII string.\r
@param Destination Pointer to a Null-terminated Unicode string.\r
\r
- @return Destination\r
+ @return Destination pointing to the converted Unicode string.\r
\r
**/\r
CHAR16 *\r
\r
@param Value The 8-bit value to convert to BCD. Range 0..99.\r
\r
- @return The BCD value\r
+ @return The BCD value converted.\r
\r
**/\r
UINT8\r
\r
@param Value The 8-bit BCD value to convert to an 8-bit value.\r
\r
- @return The 8-bit value is returned.\r
+ @return The 8-bit decimal value converted.\r
\r
**/\r
UINT8\r
\r
@param Nibble The nibble which is in the low 4 bits of the input byte.\r
\r
- @retval CHAR16 The Unicode hexadecimal character.\r
+ @return The Unicode hexadecimal character.\r
\r
**/\r
CHAR16\r
/** \r
Convert binary buffer to a Unicode String in a specified sequence. \r
\r
- This function converts bytes in the binary Buffer Buf to a Unicode String Str. \r
+ This function converts bytes in the memory block pointed by Buffer to a Unicode String Str. \r
Each byte will be represented by two Unicode characters. For example, byte 0xA1 will \r
be converted into two Unicode character L'A' and L'1'. In the output String, the Unicode Character \r
for the Most Significant Nibble will be put before the Unicode Character for the Least Significant\r
the input buffer for a 64-bits unsigned integrer 0x12345678abcdef1234 will be converted to\r
a Unicode string equal to L"12345678abcdef1234".\r
\r
- @param String On input, String is pointed to the buffer allocated for the convertion.\r
- @param StringLen The Length of String buffer to hold the output String. The length must include the tailing '\0' character.\r
- The StringLen required to convert a N bytes Buffer will be a least equal to or greater \r
- than 2*N + 1.\r
- @param Buffer The pointer to a input buffer.\r
- @param BufferSizeInBytes Lenth in bytes of the input buffer.\r
+ @param String Pointer to the buffer allocated for the convertion.\r
+ @param StringLen On input: Pointer to length in bytes of buffer to hold the Unicode string.\r
+ On output:If return EFI_SUCCESS, pointer to length of Unicode string converted.\r
+ If return EFI_BUFFER_TOO_SMALL, pointer to length of string buffer desired.\r
+ @param Buffer The pointer to a input buffer.\r
+ @param BufferSizeInBytes Lenth in bytes of the input buffer.\r
\r
-\r
- @retval EFI_SUCCESS The convertion is successfull. All bytes in Buffer has been convert to the corresponding\r
- Unicode character and placed into the right place in String.\r
- @retval EFI_BUFFER_TOO_SMALL StringSizeInBytes is smaller than 2 * N + 1the number of bytes required to\r
- complete the convertion. \r
+ @retval EFI_SUCCESS The convertion is successfull. All bytes in Buffer has been convert to the corresponding\r
+ Unicode character and placed into the right place in String.\r
+ @retval EFI_BUFFER_TOO_SMALL StringSizeInBytes is smaller than 2 * N + 1the number of bytes required to\r
+ complete the convertion. \r
**/\r
RETURN_STATUS\r
EFIAPI\r
Unicode character is converted to a byte. For example, Unicode character\r
L'A' will be converted to 0x0A. \r
\r
- If Digit is NULL, then ASSERT.\r
+ If Digit is NULL, then ASSERT().\r
+ \r
+ @param Digit The output hexadecimal digit.\r
+ @param Char The input Unicode character.\r
\r
@retval TRUE Char is in the range of Hexadecimal number. Digit is updated\r
to the byte value of the number.\r
projects / mirror_edk2.git / blobdiff