التعامل مع الأرقام في كوكب Kawkab
يمكنك استيراد كلاس Number
من كوكب Kawkab كما يلي:
import { number } from "kawkab";
تحتوي كلاس Number
على العديد من الدوال التي تسهل التعامل مع الأرقام. فيما يلي توثيق لكل دالة مع أمثلة على كيفية استخدامها:
1. add(a: number, b: number): number
يضيف رقمين معًا. مثال:
const result = number.add(5, 3);
console.log(result); // النتيجة: 8
2. subtract(a: number, b: number): number
يطرح رقمًا من آخر. مثال:
const result = number.subtract(10, 4);
console.log(result); // النتيجة: 6
3. multiply(a: number, b: number): number
يضاعف رقمين. مثال:
const result = number.multiply(3, 4);
console.log(result); // النتيجة: 12
4. divide(a: number, b: number): number
يقسم رقمًا على آخر. إذا كان المقسوم عليه صفرًا، سيتم طرح خطأ. مثال:
const result = number.divide(20, 5);
console.log(result); // النتيجة: 4
مثال في حال كان المقسوم عليه صفر:
try {
number.divide(10, 0);
} catch (error) {
console.error(error.message); // "Division by zero."
}
5. remainder(a: number, b: number): number
يحسب باقي القسمة. مثال:
const result = number.remainder(17, 5);
console.log(result); // النتيجة: 2
6. isEven(num: number): boolean
يتحقق ما إذا كان الرقم زوجيًا. مثال:
console.log(number.isEven(4)); // النتيجة: true
console.log(number.isEven(7)); // النتيجة: false
7. isOdd(num: number): boolean
يتحقق ما إذا كان الرقم فرديًا. مثال:
console.log(number.isOdd(3)); // النتيجة: true
console.log(number.isOdd(8)); // النتيجة: false
8. isPositive(num: number): boolean
يتحقق ما إذا كان الرقم موجبًا. مثال:
console.log(number.isPositive(5)); // النتيجة: true
console.log(number.isPositive(-2)); // النتيجة: false
9. isNegative(num: number): boolean
يتحقق ما إذا كان الرقم سالبًا. مثال:
console.log(number.isNegative(-3)); // النتيجة: true
console.log(number.isNegative(1)); // النتيجة: false
10. isZero(num: number): boolean
يتحقق ما إذا كان الرقم صفرًا. مثال:
console.log(number.isZero(0)); // النتيجة: true
console.log(number.isZero(1)); // النتيجة: false
11. abs(num: number): number
يحسب القيمة المطلقة للرقم. مثال:
console.log(number.abs(-5)); // النتيجة: 5
console.log(number.abs(3)); // النتيجة: 3
12. round(num: number): number
يقرب الرقم إلى أقرب عدد صحيح. مثال:
console.log(number.round(3.7)); // النتيجة: 4
console.log(number.round(3.2)); // النتيجة: 3
13. ceil(num: number): number
يقرب الرقم إلى أعلى عدد صحيح. مثال:
console.log(number.ceil(3.1)); // النتيجة: 4
console.log(number.ceil(3.9)); // النتيجة: 4
14. floor(num: number): number
يقرب الرقم إلى أسفل عدد صحيح. مثال:
console.log(number.floor(3.9)); // النتيجة: 3
console.log(number.floor(3.1)); // النتيجة: 3
15. min(a: number, b: number): number
يعيد أصغر رقم من بين رقمين. مثال:
console.log(number.min(5, 3)); // النتيجة: 3
console.log(number.min(-1, 1)); // النتيجة: -1
16. max(a: number, b: number): number
يعيد أكبر رقم من بين رقمين. مثال:
console.log(number.max(5, 3)); // النتيجة: 5
console.log(number.max(-1, 1)); // النتيجة: 1
17. random(min: number, max: number): number
ينشئ عددًا عشوائيًا بين قيمتين محددتين. مثال:
console.log(number.random(1, 10)); // عدد عشوائي بين 1 و 10
18. degToRad(degrees: number): number
يحويل الدرجات إلى راديان. مثال:
console.log(number.degToRad(180)); // النتيجة: 3.141592653589793
19. radToDeg(radians: number): number
يحويل الراديان إلى درجات. مثال:
console.log(number.radToDeg(Math.PI)); // النتيجة: 180
20. format(num: number, precision: number = 2): string
يُنسق الرقم بدقة معينة (الدقة الافتراضية هي 2). مثال:
console.log(number.format(3.14159)); // النتيجة: "3.14"
console.log(number.format(3.14159, 4)); // النتيجة: "3.1416"
21. inRange(num: number, min: number, max: number): boolean
يتحقق ما إذا كان الرقم ضمن نطاق محدد. مثال:
console.log(number.inRange(5, 1, 10)); // النتيجة: true
console.log(number.inRange(15, 1, 10)); // النتيجة: false