]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Library/BaseLib/Ia32/DivS64x64Remainder.c
MdePkg: Replace BSD License with BSD+Patent License
[mirror_edk2.git] / MdePkg / Library / BaseLib / Ia32 / DivS64x64Remainder.c
index 219f48f32126ffa5aef6e16d929274deeee5c9ab..4e64964042518f00e2188d91e4f2b714cd1a7a7c 100644 (file)
@@ -1,34 +1,43 @@
 /** @file\r
   Integer division worker functions for Ia32.\r
 \r
-  Copyright (c) 2006, 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
-  http://opensource.org/licenses/bsd-license.php\r
+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+  SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+**/\r
 \r
-  Module Name:  DivS64x64Remainder.c\r
+#include "BaseLibInternals.h"\r
 \r
-**/\r
+/**\r
+  Worker function that Divides a 64-bit signed integer by a 64-bit signed integer and\r
+  generates a  64-bit signed result and a optional 64-bit signed remainder.\r
+\r
+  This function divides the 64-bit signed value Dividend by the 64-bit\r
+  signed value Divisor and generates a 64-bit signed quotient. If Remainder\r
+  is not NULL, then the 64-bit signed remainder is returned in Remainder.\r
+  This function returns the 64-bit signed quotient.\r
 \r
-#include "../BaseLibInternals.h"\r
+  @param  Dividend  A 64-bit signed value.\r
+  @param  Divisor   A 64-bit signed value.\r
+  @param  Remainder A pointer to a 64-bit signed value. This parameter is\r
+                    optional and may be NULL.\r
 \r
+  @return Dividend / Divisor\r
+\r
+**/\r
 INT64\r
 EFIAPI\r
 InternalMathDivRemS64x64 (\r
   IN      INT64                     Dividend,\r
   IN      INT64                     Divisor,\r
-  OUT     INT64                     *Remainder\r
+  OUT     INT64                     *Remainder  OPTIONAL\r
   )\r
 {\r
   INT64                             Quot;\r
 \r
   Quot = InternalMathDivRemU64x64 (\r
-           Dividend >= 0 ? Dividend : -Dividend,\r
-           Divisor >= 0 ? Divisor : -Divisor,\r
+           (UINT64) (Dividend >= 0 ? Dividend : -Dividend),\r
+           (UINT64) (Divisor >= 0 ? Divisor : -Divisor),\r
            (UINT64 *) Remainder\r
            );\r
   if (Remainder != NULL && Dividend < 0) {\r