From 1106ffe1c04bfb1984d3233bd156d2b975429625 Mon Sep 17 00:00:00 2001 From: eric_tian Date: Tue, 9 Sep 2008 06:22:30 +0000 Subject: [PATCH] Function description in baselib.h is not clear. change it to comply with Doxgen format. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5862 6f19259b-4bc3-4df7-8a09-765794883524 --- MdePkg/Include/Library/BaseLib.h | 319 +++++++++++++++--------------- MdePkg/Library/BaseLib/CheckSum.c | 33 ++-- MdePkg/Library/BaseLib/String.c | 34 ++-- 3 files changed, 191 insertions(+), 195 deletions(-) diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/BaseLib.h index b2db844fc9..3d7afd4649 100644 --- a/MdePkg/Include/Library/BaseLib.h +++ b/MdePkg/Include/Library/BaseLib.h @@ -15,16 +15,14 @@ #ifndef __BASE_LIB__ #define __BASE_LIB__ -// -// Definitions for architecture specific types -// These include SPIN_LOCK and BASE_LIBRARY_JUMP_BUFFER -// - /// -/// SPIN_LOCK +/// Definitions for SPIN_LOCK /// typedef volatile UINTN SPIN_LOCK; +// +// Definitions for architecture specific types +// #if defined (MDE_CPU_IA32) /// /// IA32 context buffer used by SetJump() and LongJump() @@ -271,8 +269,8 @@ StrSize ( @param FirstString Pointer to a Null-terminated Unicode string. @param SecondString Pointer to a Null-terminated Unicode string. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -309,8 +307,8 @@ StrCmp ( @param SecondString Pointer to a Null-terminated Unicode string. @param Length Maximum number of Unicode characters to compare. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -430,7 +428,7 @@ StrnCat ( @param SearchString Pointer to a Null-terminated Unicode string to search for. @retval NULL If the SearchString does not appear in String. - @retval !NULL If there is a match. + @return others If there is a match. **/ CHAR16 * @@ -627,7 +625,7 @@ NibbleToHexChar ( /** Convert binary buffer to a Unicode String in a specified sequence. - This function converts bytes in the binary Buffer Buf to a Unicode String Str. + This function converts bytes in the memory block pointed by Buffer to a Unicode String Str. Each byte will be represented by two Unicode characters. For example, byte 0xA1 will be converted into two Unicode character L'A' and L'1'. In the output String, the Unicode Character for the Most Significant Nibble will be put before the Unicode Character for the Least Significant @@ -716,6 +714,10 @@ HexStringToBuf ( If Digit is NULL, then ASSERT. + @param Digit The output hexadecimal digit. + + @param Char The input Unicode character. + @retval TRUE Char is in the range of Hexadecimal number. Digit is updated to the byte value of the number. @retval FALSE Char is not in the range of Hexadecimal number. Digit is keep @@ -901,8 +903,8 @@ AsciiStrSize ( @param FirstString Pointer to a Null-terminated ASCII string. @param SecondString Pointer to a Null-terminated ASCII string. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -936,10 +938,10 @@ AsciiStrCmp ( @param FirstString Pointer to a Null-terminated ASCII string. @param SecondString Pointer to a Null-terminated ASCII string. - @retval 0 FirstString is identical to SecondString using case insensitive - comparisons. - @retval !=0 FirstString is not identical to SecondString using case - insensitive comparisons. + @retval 0 FirstString is identical to SecondString using case insensitive + comparisons. + @return others FirstString is not identical to SecondString using case + insensitive comparisons. **/ INTN @@ -974,8 +976,8 @@ AsciiStriCmp ( @param SecondString Pointer to a Null-terminated ASCII string. @param Length Maximum number of ASCII characters for compare. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -1081,11 +1083,11 @@ AsciiStrnCat ( String contains more than PcdMaximumAsciiStringLength Unicode characters not including the Null-terminator, then ASSERT(). - @param String Pointer to a Null-terminated ASCII string. - @param SearchString Pointer to a Null-terminated ASCII string to search for. + @param String Pointer to a Null-terminated ASCII string. + @param SearchString Pointer to a Null-terminated ASCII string to search for. @retval NULL If the SearchString does not appear in String. - @retval !NULL If there is a match. + @return others If there is a match. **/ CHAR8 * @@ -3270,8 +3272,8 @@ InterlockedCompareExchangePointer ( If Buffer is NULL, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer . + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer . @return Sum The sum of Buffer with carry bits dropped during additions. @@ -3296,9 +3298,8 @@ CalculateSum8 ( If Buffer is NULL, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -3324,8 +3325,8 @@ CalculateCheckSum8 ( If Length is not aligned on a 16-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -3352,8 +3353,8 @@ CalculateSum16 ( If Length is not aligned on a 16-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -3379,8 +3380,8 @@ CalculateCheckSum16 ( If Length is not aligned on a 32-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -3407,8 +3408,8 @@ CalculateSum32 ( If Length is not aligned on a 32-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -3434,8 +3435,8 @@ CalculateCheckSum32 ( If Length is not aligned on a 64-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -3462,8 +3463,8 @@ CalculateSum64 ( If Length is not aligned on a 64-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -3476,9 +3477,9 @@ CalculateCheckSum64 ( ); -// -// Base Library CPU Functions -// +/// +/// Base Library CPU Functions +/// typedef VOID (EFIAPI *SWITCH_STACK_ENTRY_POINT)( @@ -4915,12 +4916,10 @@ AsmSwitchStackAndBackingStore ( IN VOID *NewBsp ); - -// -// Bugbug: This call should be removed after -// the PalCall Instance issue has been fixed. -// /** + @todo This call should be removed after the PalCall + Instance issue has been fixed. + Performs a PAL call using static calling convention. An internal function to perform a PAL call using static calling convention. @@ -4946,124 +4945,122 @@ PalCallStatic ( #elif defined (MDE_CPU_IA32) || defined (MDE_CPU_X64) -// -// IA32 and X64 Specific Functions -// -// -// Byte packed structure for 16-bit Real Mode EFLAGS -// +/// +/// IA32 and X64 Specific Functions +/// Byte packed structure for 16-bit Real Mode EFLAGS +/// typedef union { struct { - UINT32 CF:1; // Carry Flag - UINT32 Reserved_0:1; // Reserved - UINT32 PF:1; // Parity Flag - UINT32 Reserved_1:1; // Reserved - UINT32 AF:1; // Auxiliary Carry Flag - UINT32 Reserved_2:1; // Reserved - UINT32 ZF:1; // Zero Flag - UINT32 SF:1; // Sign Flag - UINT32 TF:1; // Trap Flag - UINT32 IF:1; // Interrupt Enable Flag - UINT32 DF:1; // Direction Flag - UINT32 OF:1; // Overflow Flag - UINT32 IOPL:2; // I/O Privilege Level - UINT32 NT:1; // Nested Task - UINT32 Reserved_3:1; // Reserved + UINT32 CF:1; /// Carry Flag + UINT32 Reserved_0:1; /// Reserved + UINT32 PF:1; /// Parity Flag + UINT32 Reserved_1:1; /// Reserved + UINT32 AF:1; /// Auxiliary Carry Flag + UINT32 Reserved_2:1; /// Reserved + UINT32 ZF:1; /// Zero Flag + UINT32 SF:1; /// Sign Flag + UINT32 TF:1; /// Trap Flag + UINT32 IF:1; /// Interrupt Enable Flag + UINT32 DF:1; /// Direction Flag + UINT32 OF:1; /// Overflow Flag + UINT32 IOPL:2; /// I/O Privilege Level + UINT32 NT:1; /// Nested Task + UINT32 Reserved_3:1; /// Reserved } Bits; UINT16 Uint16; } IA32_FLAGS16; -// -// Byte packed structure for EFLAGS/RFLAGS -// 32-bits on IA-32 -// 64-bits on X64. The upper 32-bits on X64 are reserved -// +/// +/// Byte packed structure for EFLAGS/RFLAGS +/// 32-bits on IA-32 +/// 64-bits on X64. The upper 32-bits on X64 are reserved +/// typedef union { struct { - UINT32 CF:1; // Carry Flag - UINT32 Reserved_0:1; // Reserved - UINT32 PF:1; // Parity Flag - UINT32 Reserved_1:1; // Reserved - UINT32 AF:1; // Auxiliary Carry Flag - UINT32 Reserved_2:1; // Reserved - UINT32 ZF:1; // Zero Flag - UINT32 SF:1; // Sign Flag - UINT32 TF:1; // Trap Flag - UINT32 IF:1; // Interrupt Enable Flag - UINT32 DF:1; // Direction Flag - UINT32 OF:1; // Overflow Flag - UINT32 IOPL:2; // I/O Privilege Level - UINT32 NT:1; // Nested Task - UINT32 Reserved_3:1; // Reserved - UINT32 RF:1; // Resume Flag - UINT32 VM:1; // Virtual 8086 Mode - UINT32 AC:1; // Alignment Check - UINT32 VIF:1; // Virtual Interrupt Flag - UINT32 VIP:1; // Virtual Interrupt Pending - UINT32 ID:1; // ID Flag - UINT32 Reserved_4:10; // Reserved + UINT32 CF:1; /// Carry Flag + UINT32 Reserved_0:1; /// Reserved + UINT32 PF:1; /// Parity Flag + UINT32 Reserved_1:1; /// Reserved + UINT32 AF:1; /// Auxiliary Carry Flag + UINT32 Reserved_2:1; /// Reserved + UINT32 ZF:1; /// Zero Flag + UINT32 SF:1; /// Sign Flag + UINT32 TF:1; /// Trap Flag + UINT32 IF:1; /// Interrupt Enable Flag + UINT32 DF:1; /// Direction Flag + UINT32 OF:1; /// Overflow Flag + UINT32 IOPL:2; /// I/O Privilege Level + UINT32 NT:1; /// Nested Task + UINT32 Reserved_3:1; /// Reserved + UINT32 RF:1; /// Resume Flag + UINT32 VM:1; /// Virtual 8086 Mode + UINT32 AC:1; /// Alignment Check + UINT32 VIF:1; /// Virtual Interrupt Flag + UINT32 VIP:1; /// Virtual Interrupt Pending + UINT32 ID:1; /// ID Flag + UINT32 Reserved_4:10; /// Reserved } Bits; UINTN UintN; } IA32_EFLAGS32; -// -// Byte packed structure for Control Register 0 (CR0) -// 32-bits on IA-32 -// 64-bits on X64. The upper 32-bits on X64 are reserved -// +/// +/// Byte packed structure for Control Register 0 (CR0) +/// 32-bits on IA-32 +/// 64-bits on X64. The upper 32-bits on X64 are reserved +/// typedef union { struct { - UINT32 PE:1; // Protection Enable - UINT32 MP:1; // Monitor Coprocessor - UINT32 EM:1; // Emulation - UINT32 TS:1; // Task Switched - UINT32 ET:1; // Extension Type - UINT32 NE:1; // Numeric Error - UINT32 Reserved_0:10; // Reserved - UINT32 WP:1; // Write Protect - UINT32 Reserved_1:1; // Reserved - UINT32 AM:1; // Alignment Mask - UINT32 Reserved_2:10; // Reserved - UINT32 NW:1; // Mot Write-through - UINT32 CD:1; // Cache Disable - UINT32 PG:1; // Paging + UINT32 PE:1; /// Protection Enable + UINT32 MP:1; /// Monitor Coprocessor + UINT32 EM:1; /// Emulation + UINT32 TS:1; /// Task Switched + UINT32 ET:1; /// Extension Type + UINT32 NE:1; /// Numeric Error + UINT32 Reserved_0:10; /// Reserved + UINT32 WP:1; /// Write Protect + UINT32 Reserved_1:1; /// Reserved + UINT32 AM:1; /// Alignment Mask + UINT32 Reserved_2:10; /// Reserved + UINT32 NW:1; /// Mot Write-through + UINT32 CD:1; /// Cache Disable + UINT32 PG:1; /// Paging } Bits; UINTN UintN; } IA32_CR0; -// -// Byte packed structure for Control Register 4 (CR4) -// 32-bits on IA-32 -// 64-bits on X64. The upper 32-bits on X64 are reserved -// +/// +/// Byte packed structure for Control Register 4 (CR4) +/// 32-bits on IA-32 +/// 64-bits on X64. The upper 32-bits on X64 are reserved +/// typedef union { struct { - UINT32 VME:1; // Virtual-8086 Mode Extensions - UINT32 PVI:1; // Protected-Mode Virtual Interrupts - UINT32 TSD:1; // Time Stamp Disable - UINT32 DE:1; // Debugging Extensions - UINT32 PSE:1; // Page Size Extensions - UINT32 PAE:1; // Physical Address Extension - UINT32 MCE:1; // Machine Check Enable - UINT32 PGE:1; // Page Global Enable - UINT32 PCE:1; // Performance Monitoring Counter - // Enable - UINT32 OSFXSR:1; // Operating System Support for - // FXSAVE and FXRSTOR instructions - UINT32 OSXMMEXCPT:1; // Operating System Support for - // Unmasked SIMD Floating Point - // Exceptions - UINT32 Reserved_0:2; // Reserved - UINT32 VMXE:1; // VMX Enable - UINT32 Reserved_1:18; // Reseved + UINT32 VME:1; /// Virtual-8086 Mode Extensions + UINT32 PVI:1; /// Protected-Mode Virtual Interrupts + UINT32 TSD:1; /// Time Stamp Disable + UINT32 DE:1; /// Debugging Extensions + UINT32 PSE:1; /// Page Size Extensions + UINT32 PAE:1; /// Physical Address Extension + UINT32 MCE:1; /// Machine Check Enable + UINT32 PGE:1; /// Page Global Enable + UINT32 PCE:1; /// Performance Monitoring Counter + /// Enable + UINT32 OSFXSR:1; /// Operating System Support for + /// FXSAVE and FXRSTOR instructions + UINT32 OSXMMEXCPT:1; /// Operating System Support for + /// Unmasked SIMD Floating Point + /// Exceptions + UINT32 Reserved_0:2; /// Reserved + UINT32 VMXE:1; /// VMX Enable + UINT32 Reserved_1:18; /// Reseved } Bits; UINTN UintN; } IA32_CR4; -// -// Byte packed structure for an IDTR, GDTR, LDTR descriptor -/// @bug How to make this structure byte-packed in a compiler independent way? -// +/// +/// Byte packed structure for an IDTR, GDTR, LDTR descriptor +/// @todo How to make this structure byte-packed in a compiler independent way? +/// #pragma pack (1) typedef struct { UINT16 Limit; @@ -5077,30 +5074,30 @@ typedef struct { #define IA32_IDT_GATE_TYPE_INTERRUPT_32 0x8E #define IA32_IDT_GATE_TYPE_TRAP_32 0x8F -// -// Byte packed structure for an Interrupt Gate Descriptor -// +/// +/// Byte packed structure for an Interrupt Gate Descriptor +/// typedef union { struct { - UINT32 OffsetLow:16; // Offset bits 15..0 - UINT32 Selector:16; // Selector - UINT32 Reserved_0:8; // Reserved - UINT32 GateType:8; // Gate Type. See #defines above - UINT32 OffsetHigh:16; // Offset bits 31..16 + UINT32 OffsetLow:16; /// Offset bits 15..0 + UINT32 Selector:16; /// Selector + UINT32 Reserved_0:8; /// Reserved + UINT32 GateType:8; /// Gate Type. See #defines above + UINT32 OffsetHigh:16; /// Offset bits 31..16 } Bits; UINT64 Uint64; } IA32_IDT_GATE_DESCRIPTOR; -// -// Byte packed structure for an FP/SSE/SSE2 context -// +/// +/// Byte packed structure for an FP/SSE/SSE2 context +/// typedef struct { UINT8 Buffer[512]; } IA32_FX_BUFFER; -// -// Structures for the 16-bit real mode thunks -// +/// +/// Structures for the 16-bit real mode thunks +/// typedef struct { UINT32 Reserved1; UINT32 Reserved2; @@ -5164,9 +5161,9 @@ typedef union { IA32_BYTE_REGS H; } IA32_REGISTER_SET; -// -// Byte packed structure for an 16-bit real mode thunks -// +/// +/// Byte packed structure for an 16-bit real mode thunks +/// typedef struct { IA32_REGISTER_SET *RealModeState; VOID *RealModeBuffer; @@ -7221,10 +7218,6 @@ AsmPrepareAndThunk16 ( IN OUT THUNK_CONTEXT *ThunkContext ); -#else - -#endif - #endif diff --git a/MdePkg/Library/BaseLib/CheckSum.c b/MdePkg/Library/BaseLib/CheckSum.c index 8612c7c392..78ff00c451 100644 --- a/MdePkg/Library/BaseLib/CheckSum.c +++ b/MdePkg/Library/BaseLib/CheckSum.c @@ -31,8 +31,8 @@ If Buffer is NULL, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer . + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer . @return Sum The sum of Buffer with carry bits dropped during additions. @@ -70,9 +70,8 @@ CalculateSum8 ( If Buffer is NULL, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -107,8 +106,8 @@ CalculateCheckSum8 ( If Length is not aligned on a 16-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -152,8 +151,8 @@ CalculateSum16 ( If Length is not aligned on a 16-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -189,8 +188,8 @@ CalculateCheckSum16 ( If Length is not aligned on a 32-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -234,8 +233,8 @@ CalculateSum32 ( If Length is not aligned on a 32-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. @@ -271,8 +270,8 @@ CalculateCheckSum32 ( If Length is not aligned on a 64-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the sum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the sum operation. + @param Length The size, in bytes, of Buffer. @return Sum The sum of Buffer with carry bits dropped during additions. @@ -316,8 +315,8 @@ CalculateSum64 ( If Length is not aligned on a 64-bit boundary, then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). - @param Buffer Pointer to the buffer to carry out the checksum operation. - @param Length The size, in bytes, of Buffer. + @param Buffer Pointer to the buffer to carry out the checksum operation. + @param Length The size, in bytes, of Buffer. @return Checksum The 2's complement checksum of Buffer. diff --git a/MdePkg/Library/BaseLib/String.c b/MdePkg/Library/BaseLib/String.c index 6b68bb2eec..2379c23450 100644 --- a/MdePkg/Library/BaseLib/String.c +++ b/MdePkg/Library/BaseLib/String.c @@ -229,8 +229,8 @@ StrSize ( @param FirstString Pointer to a Null-terminated Unicode string. @param SecondString Pointer to a Null-terminated Unicode string. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -279,8 +279,8 @@ StrCmp ( @param SecondString Pointer to a Null-terminated Unicode string. @param Length Maximum number of Unicode characters to compare. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -438,7 +438,7 @@ StrnCat ( @param SearchString Pointer to a Null-terminated Unicode string to search for. @retval NULL If the SearchString does not appear in String. - @retval !NULL If there is a match. + @return others If there is a match. **/ CHAR16 * @@ -1265,8 +1265,8 @@ AsciiStrSize ( @param FirstString Pointer to a Null-terminated ASCII string. @param SecondString Pointer to a Null-terminated ASCII string. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -1362,10 +1362,10 @@ InternalAsciiHexCharToUintn ( @param FirstString Pointer to a Null-terminated ASCII string. @param SecondString Pointer to a Null-terminated ASCII string. - @retval 0 FirstString is identical to SecondString using case insensitive - comparisons. - @retval !=0 FirstString is not identical to SecondString using case - insensitive comparisons. + @retval 0 FirstString is identical to SecondString using case insensitive + comparisons. + @return others FirstString is not identical to SecondString using case + insensitive comparisons. **/ INTN @@ -1420,8 +1420,8 @@ AsciiStriCmp ( @param SecondString Pointer to a Null-terminated ASCII string. @param Length Maximum number of ASCII characters to compare. - @retval 0 FirstString is identical to SecondString. - @retval !=0 FirstString is not identical to SecondString. + @retval 0 FirstString is identical to SecondString. + @return others FirstString is not identical to SecondString. **/ INTN @@ -1568,7 +1568,7 @@ AsciiStrnCat ( @param SearchString Pointer to a Null-terminated ASCII string to search for. @retval NULL If the SearchString does not appear in String. - @retval !NULL If there is a match. + @return others If there is a match. **/ CHAR8 * @@ -2103,7 +2103,7 @@ NibbleToHexChar ( /** Convert binary buffer to a Unicode String in a specified sequence. - This function converts bytes in the binary Buffer Buf to a Unicode String Str. + This function converts bytes in the memory block pointed by Buffer to a Unicode String Str. Each byte will be represented by two Unicode characters. For example, byte 0xA1 will be converted into two Unicode character L'A' and L'1'. In the output String, the Unicode Character for the Most Significant Nibble will be put before the Unicode Character for the Least Significant @@ -2278,6 +2278,10 @@ HexStringToBuf ( L'A' will be converted to 0x0A. If Digit is NULL, then ASSERT. + + @param Digit The output hexadecimal digit. + + @param Char The input Unicode character. @retval TRUE Char is in the range of Hexadecimal number. Digit is updated to the byte value of the number.