ثَبَّتَ

npm install --save bn.js

الاستخدام

 const BN = require ( 'bn.js' ) ;

var a = new BN ( 'dead' , 16 ) ;
var b = new BN ( '101010' , 2 ) ;

var res = a . add ( b ) ;
console . log ( res . toString ( 10 ) ) ;  // 57047

ملاحظة : الكسور العشرية غير مدعومة في هذه المكتبة.

الرعاة

الكشفية APM يتم دعم عملي مفتوح المصدر من قبل Scout APM والجهات الراعية الأخرى.

التدوين

البادئات

هناك عدة بادئات للتعليمات التي تؤثر على طريقة عملها. فيما يلي قائمة بها حسب ترتيب ظهورها في اسم الوظيفة:

i - تنفيذ العملية في مكانها، وتخزين النتيجة في الكائن المضيف (الذي تم استدعاء الطريقة عليه). يمكن استخدامه لتجنب تكاليف تخصيص الأرقام
u - غير موقعة، تجاهل إشارة المعاملات عند إجراء العملية، أو قم دائمًا بإرجاع قيمة موجبة. تنطبق الحالة الثانية على عمليات التخفيض مثل mod() . في مثل هذه الحالات، إذا كانت النتيجة سلبية - فسيتم إضافة modulo إلى النتيجة لجعلها إيجابية

الإصلاحات اللاحقة

n - يجب أن تكون وسيطة الدالة عبارة عن رقم JavaScript عادي. الكسور العشرية غير مدعومة. يجب أن يكون الرقم الذي تم تمريره أصغر من 0x4000000 (67_108_864). وإلا فسيتم طرح خطأ.
rn - كل من الوسيطة وقيمة الإرجاع للدالة عبارة عن أرقام JavaScript عادية. الكسور العشرية غير مدعومة.

أمثلة

a.iadd(b) - إجراء عملية الجمع على a و b ، وتخزين النتيجة في a
a.umod(b) - تقليل a b ، وإرجاع قيمة موجبة
a.iushln(13) - إزاحة أجزاء من a بمقدار 13

تعليمات

يتم وضع البادئات/اللاحقات بين قوسين في نهاية السطر. endian - يمكن أن يكون إما le (endian الصغير) أو be (endian الكبير).

المرافق

a.clone() - رقم الاستنساخ
a.toString(base, length) - تحويل إلى سلسلة أساسية ولوحة بأصفار
a.toNumber() - تحويل إلى رقم Javascript (يقتصر على 53 بت)
a.toJSON() - تحويل إلى سلسلة سداسية عشرية متوافقة مع JSON (الاسم المستعار لـ toString(16) )
a.toArray(endian, length) - قم بالتحويل إلى byte Array ، واختياريًا لوحة الصفر إلى الطول، مع الرمي إذا تجاوز بالفعل
a.toArrayLike(type, endian, length) - قم بالتحويل إلى مثيل من type ، والذي يجب أن يتصرف مثل Array
a.toBuffer(endian, length) - تحويل إلى Node.js Buffer (إن وجد). length بالبايت. للتوافق مع browserify والأدوات المشابهة، استخدم هذا بدلاً من ذلك: a.toArrayLike(Buffer, endian, length)
a.bitLength() - احصل على عدد البتات المشغولة
a.zeroBits() - عدد الإرجاع للبتات الصفرية اللاحقة الأقل أهمية (على سبيل المثال: 1010000 يحتوي على 4 بتات صفرية)
a.byteLength() - يُرجع عدد البايتات المشغولة
a.isNeg() - صحيح إذا كان الرقم سالبًا
a.isEven() - لا توجد تعليقات
a.isOdd() - لا توجد تعليقات
a.isZero() - لا توجد تعليقات
a.cmp(b) - مقارنة الأرقام وإرجاع -1 (a < b) أو 0 (a == b) أو 1 (a > b) اعتمادًا على نتيجة المقارنة ( ucmp , cmpn )
a.lt(b) - a من b ( n )
a.lte(b) - a من أو يساوي b ( n )
a.gt(b) - a من b ( n )
a.gte(b) - a من أو يساوي b ( n )
a.eq(b) - a يساوي b ( n )
a.toTwos(width) - تحويل إلى تمثيل مكمل لاثنين، حيث width هو عرض البت
a.fromTwos(width) - تحويل من التمثيل المكمل لاثنين، حيث width هو عرض البت
BN.isBN(object) - يُرجع صحيحًا إذا كان object المقدم عبارة عن مثيل BN.js
BN.max(a, b) - يُرجع a إذا a أكبر من b
BN.min(a, b) - يُرجع a إذا a أقل من b

الحساب

a.neg() - علامة النفي ( i )
a.abs() - القيمة المطلقة ( i )
a.add(b) - إضافة ( i , n , in )
a.sub(b) - الطرح ( i , n , in )
a.mul(b) - اضرب ( i , n , in )
a.sqr() - مربع ( i )
a.pow(b) - ارفع a إلى قوة b
a.div(b) - قسمة ( divn , idivn )
a.mod(b) - reduct ( u , n ) (لكن لا يوجد umodn )
a.divmod(b) - حاصل القسمة والمعامل الناتج عن القسمة
a.divRound(b) - التقسيم المدور

عمليات البت

a.or(b) - أو ( i ، u ، iu )
a.and(b) - و ( i , u , iu , andln ) (ملاحظة: سيتم استبدال andln بـ andn في المستقبل)
a.xor(b) - xor ( i , u , iu )
a.setn(b, value) - اضبط البت المحدد على value
a.shln(b) - التحول لليسار ( i , u , iu )
a.shrn(b) - إزاحة لليمين ( i , u , iu )
a.testn(b) - اختبار إذا تم تعيين البت المحدد
a.maskn(b) - بتات واضحة ذات فهارس أعلى أو تساوي b ( i )
a.bincn(b) - أضف 1 << b إلى الرقم
a.notn(w) - not (للعرض المحدد بواسطة w ) ( i )

تخفيض

a.gcd(b) - GCD
a.egcd(b) - نتائج GCD الموسعة ( { a: ..., b: ..., gcd: ... } )
a.invm(b) - معكوس a b

تخفيض سريع

عند إجراء الكثير من عمليات الاختزال باستخدام نفس المعامل، قد يكون من المفيد استخدام بعض الحيل: مثل ضرب مونتغمري، أو استخدام خوارزمية خاصة لميرسين الأولي.