gmp_lib.mpn_sub_n Method

GMP Native Interface for .NET

gmp_libmpn_sub_n Method
Subtract {s2p, n} from {s1p, n}, and write the n least significant limbs of the result to rp.

Namespace:  Math.Gmp.Native
Assembly:  Math.Gmp.Native (in Math.Gmp.Native.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
public static mp_limb_t mpn_sub_n(
	mp_ptr rp,
	mp_ptr s1p,
	mp_ptr s2p,
	mp_size_t n
)
Public Shared Function mpn_sub_n ( 
	rp As mp_ptr,
	s1p As mp_ptr,
	s2p As mp_ptr,
	n As mp_size_t
) As mp_limb_t
public:
static mp_limb_t mpn_sub_n(
	mp_ptr^ rp, 
	mp_ptr^ s1p, 
	mp_ptr^ s2p, 
	mp_size_t n
)
static member mpn_sub_n : 
        rp : mp_ptr * 
        s1p : mp_ptr * 
        s2p : mp_ptr * 
        n : mp_size_t -> mp_limb_t 

Parameters

rp
Type: Math.Gmp.Nativemp_ptr
The result integer.
s1p
Type: Math.Gmp.Nativemp_ptr
The first operand integer.
s2p
Type: Math.Gmp.Nativemp_ptr
The second operand integer.
n
Type: Math.Gmp.Nativemp_size_t
The numbe rof limbs of s1p and s2p.

Return Value

Type: mp_limb_t
Return borrow, either 0 or 1.
Examples
// Create multi-precision operands, and expected result.
mp_ptr s1p = new mp_ptr(new uint[] { 0xffffffff, 0xffffffff });
mp_ptr s2p = new mp_ptr(new uint[] { 0x00000001, 0x00000000 });
mp_ptr rp = new mp_ptr(new uint[2]);
mp_ptr result = new mp_ptr(new uint[] { 0xfffffffe, 0xffffffff });

// Set rp = s1 - s2.
mp_limb_t borrow = gmp_lib.mpn_sub_n(rp, s1p, s2p, rp.Size);

// Assert result of operation.
Assert.IsTrue(borrow == 0);
Assert.IsTrue(rp.SequenceEqual(result));

// Release unmanaged memory.
gmp_lib.free(rp, s1p, s2p, result);
' Create multi-precision operands, and expected result.
Dim s1p As New mp_ptr(New UInteger() { &HffffffffUI, &HffffffffUI})
Dim s2p As New mp_ptr(New UInteger() { &H1, &H0})
 Dim rp As New mp_ptr(New UInteger(1) { })
Dim result As New mp_ptr(New UInteger() { &HfffffffeUI, &HffffffffUI})

' Set rp = s1 - s2.
Dim borrow As mp_limb_t = gmp_lib.mpn_sub_n(rp, s1p, s2p, rp.Size)

' Assert result of operation.
Assert.IsTrue(borrow = 0)
Assert.IsTrue(rp.SequenceEqual(result))

' Release unmanaged memory.
gmp_lib.free(rp, s1p, s2p, result)

No code example is currently available or this language may not be supported.

No code example is currently available or this language may not be supported.

See Also