MdePkg/Library/BaseLib/DivS64x64Remainder.c

   1 /** @file
   2   Math worker functions.
   3
   4   Copyright (c) 2006, Intel Corporation<BR>
   5   All rights reserved. This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 //
  16 // Include common header file for this module.
  17 //
  18 #include "CommonHeader.h"
  19
  20 #include "BaseLibInternals.h"
  21
  22 /**
  23   Divides a 64-bit signed integer by a 64-bit signed integer and generates a
  24   64-bit signed result and a optional 64-bit signed remainder.
  25
  26   This function divides the 64-bit signed value Dividend by the 64-bit signed
  27   value Divisor and generates a 64-bit signed quotient. If Remainder is not
  28   NULL, then the 64-bit signed remainder is returned in Remainder. This
  29   function returns the 64-bit signed quotient.
  30
  31   If Divisor is 0, then ASSERT().
  32
  33   @param  Dividend  A 64-bit signed value.
  34   @param  Divisor   A 64-bit signed value.
  35   @param  Remainder A pointer to a 64-bit signed value. This parameter is
  36                     optional and may be NULL.
  37
  38   @return Dividend / Divisor
  39
  40 **/
  41 INT64
  42 EFIAPI
  43 DivS64x64Remainder (
  44   IN      INT64                     Dividend,
  45   IN      INT64                     Divisor,
  46   OUT     INT64                     *Remainder  OPTIONAL
  47   )
  48 {
  49   ASSERT (Divisor != 0);
  50   return InternalMathDivRemS64x64 (Dividend, Divisor, Remainder);
  51 }