MdePkg: Apply uncrustify changes

[mirror_edk2.git] / MdePkg / Library / UefiMemoryLib / MemLibGeneric.c

/** @file\r
  Architecture Independent Base Memory Library Implementation.\r
\r
  The following BaseMemoryLib instances contain the same copy of this file:\r
    BaseMemoryLib\r
    PeiMemoryLib\r
    UefiMemoryLib\r
\r
  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "MemLibInternals.h"\r
\r
/**\r
  Fills a target buffer with a 16-bit value, and returns the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to fill.\r
  @param  Length  The count of 16-bit value to fill.\r
  @param  Value   The value with which to fill Length bytes of Buffer.\r
\r
  @return Buffer\r
\r
**/\r
VOID *\r
EFIAPI\r
InternalMemSetMem16 (\r
  OUT     VOID    *Buffer,\r
  IN      UINTN   Length,\r
  IN      UINT16  Value\r
  )\r
{\r
  for ( ; Length != 0; Length--) {\r
    ((UINT16 *)Buffer)[Length - 1] = Value;\r
  }\r
\r
  return Buffer;\r
}\r
\r
/**\r
  Fills a target buffer with a 32-bit value, and returns the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to fill.\r
  @param  Length  The count of 32-bit value to fill.\r
  @param  Value   The value with which to fill Length bytes of Buffer.\r
\r
  @return Buffer\r
\r
**/\r
VOID *\r
EFIAPI\r
InternalMemSetMem32 (\r
  OUT     VOID    *Buffer,\r
  IN      UINTN   Length,\r
  IN      UINT32  Value\r
  )\r
{\r
  for ( ; Length != 0; Length--) {\r
    ((UINT32 *)Buffer)[Length - 1] = Value;\r
  }\r
\r
  return Buffer;\r
}\r
\r
/**\r
  Fills a target buffer with a 64-bit value, and returns the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to fill.\r
  @param  Length  The count of 64-bit value to fill.\r
  @param  Value   The value with which to fill Length bytes of Buffer.\r
\r
  @return Buffer\r
\r
**/\r
VOID *\r
EFIAPI\r
InternalMemSetMem64 (\r
  OUT     VOID    *Buffer,\r
  IN      UINTN   Length,\r
  IN      UINT64  Value\r
  )\r
{\r
  for ( ; Length != 0; Length--) {\r
    ((UINT64 *)Buffer)[Length - 1] = Value;\r
  }\r
\r
  return Buffer;\r
}\r
\r
/**\r
  Set Buffer to 0 for Size bytes.\r
\r
  @param  Buffer Memory to set.\r
  @param  Length The number of bytes to set\r
\r
  @return Buffer\r
\r
**/\r
VOID *\r
EFIAPI\r
InternalMemZeroMem (\r
  OUT     VOID   *Buffer,\r
  IN      UINTN  Length\r
  )\r
{\r
  return InternalMemSetMem (Buffer, Length, 0);\r
}\r
\r
/**\r
  Compares two memory buffers of a given length.\r
\r
  @param  DestinationBuffer The first memory buffer\r
  @param  SourceBuffer      The second memory buffer\r
  @param  Length            The length of DestinationBuffer and SourceBuffer memory\r
                            regions to compare. Must be non-zero.\r
\r
  @return 0                 All Length bytes of the two buffers are identical.\r
  @retval Non-zero          The first mismatched byte in SourceBuffer subtracted from the first\r
                            mismatched byte in DestinationBuffer.\r
\r
**/\r
INTN\r
EFIAPI\r
InternalMemCompareMem (\r
  IN      CONST VOID  *DestinationBuffer,\r
  IN      CONST VOID  *SourceBuffer,\r
  IN      UINTN       Length\r
  )\r
{\r
  while ((--Length != 0) &&\r
         (*(INT8 *)DestinationBuffer == *(INT8 *)SourceBuffer))\r
  {\r
    DestinationBuffer = (INT8 *)DestinationBuffer + 1;\r
    SourceBuffer      = (INT8 *)SourceBuffer + 1;\r
  }\r
\r
  return (INTN)*(UINT8 *)DestinationBuffer - (INTN)*(UINT8 *)SourceBuffer;\r
}\r
\r
/**\r
  Scans a target buffer for an 8-bit value, and returns a pointer to the\r
  matching 8-bit value in the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to scan.\r
  @param  Length  The count of 8-bit value to scan. Must be non-zero.\r
  @param  Value   The value to search for in the target buffer.\r
\r
  @return The pointer to the first occurrence or NULL if not found.\r
\r
**/\r
CONST VOID *\r
EFIAPI\r
InternalMemScanMem8 (\r
  IN      CONST VOID  *Buffer,\r
  IN      UINTN       Length,\r
  IN      UINT8       Value\r
  )\r
{\r
  CONST UINT8  *Pointer;\r
\r
  Pointer = (CONST UINT8 *)Buffer;\r
  do {\r
    if (*(Pointer++) == Value) {\r
      return --Pointer;\r
    }\r
  } while (--Length != 0);\r
\r
  return NULL;\r
}\r
\r
/**\r
  Scans a target buffer for a 16-bit value, and returns a pointer to the\r
  matching 16-bit value in the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to scan.\r
  @param  Length  The count of 16-bit value to scan. Must be non-zero.\r
  @param  Value   The value to search for in the target buffer.\r
\r
  @return The pointer to the first occurrence or NULL if not found.\r
\r
**/\r
CONST VOID *\r
EFIAPI\r
InternalMemScanMem16 (\r
  IN      CONST VOID  *Buffer,\r
  IN      UINTN       Length,\r
  IN      UINT16      Value\r
  )\r
{\r
  CONST UINT16  *Pointer;\r
\r
  Pointer = (CONST UINT16 *)Buffer;\r
  do {\r
    if (*(Pointer++) == Value) {\r
      return --Pointer;\r
    }\r
  } while (--Length != 0);\r
\r
  return NULL;\r
}\r
\r
/**\r
  Scans a target buffer for a 32-bit value, and returns a pointer to the\r
  matching 32-bit value in the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to scan.\r
  @param  Length  The count of 32-bit value to scan. Must be non-zero.\r
  @param  Value   The value to search for in the target buffer.\r
\r
  @return The pointer to the first occurrence or NULL if not found.\r
\r
**/\r
CONST VOID *\r
EFIAPI\r
InternalMemScanMem32 (\r
  IN      CONST VOID  *Buffer,\r
  IN      UINTN       Length,\r
  IN      UINT32      Value\r
  )\r
{\r
  CONST UINT32  *Pointer;\r
\r
  Pointer = (CONST UINT32 *)Buffer;\r
  do {\r
    if (*(Pointer++) == Value) {\r
      return --Pointer;\r
    }\r
  } while (--Length != 0);\r
\r
  return NULL;\r
}\r
\r
/**\r
  Scans a target buffer for a 64-bit value, and returns a pointer to the\r
  matching 64-bit value in the target buffer.\r
\r
  @param  Buffer  The pointer to the target buffer to scan.\r
  @param  Length  The count of 64-bit value to scan. Must be non-zero.\r
  @param  Value   The value to search for in the target buffer.\r
\r
  @return The pointer to the first occurrence or NULL if not found.\r
\r
**/\r
CONST VOID *\r
EFIAPI\r
InternalMemScanMem64 (\r
  IN      CONST VOID  *Buffer,\r
  IN      UINTN       Length,\r
  IN      UINT64      Value\r
  )\r
{\r
  CONST UINT64  *Pointer;\r
\r
  Pointer = (CONST UINT64 *)Buffer;\r
  do {\r
    if (*(Pointer++) == Value) {\r
      return --Pointer;\r
    }\r
  } while (--Length != 0);\r
\r
  return NULL;\r
}\r
\r
/**\r
  Checks whether the contents of a buffer are all zeros.\r
\r
  @param  Buffer  The pointer to the buffer to be checked.\r
  @param  Length  The size of the buffer (in bytes) to be checked.\r
\r
  @retval TRUE    Contents of the buffer are all zeros.\r
  @retval FALSE   Contents of the buffer are not all zeros.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
InternalMemIsZeroBuffer (\r
  IN CONST VOID  *Buffer,\r
  IN UINTN       Length\r
  )\r
{\r
  CONST UINT8  *BufferData;\r
  UINTN        Index;\r
\r
  BufferData = Buffer;\r
  for (Index = 0; Index < Length; Index++) {\r
    if (BufferData[Index] != 0) {\r
      return FALSE;\r
    }\r
  }\r
\r
  return TRUE;\r
}\r