- עמוד זה הוא חלק מהמדריך לפונקציות ארדואינו -
הפונקציה random([howsmall, ]howbig) מחזירה מספר שלם כלשהו בטווח שמוגדר בפרמטר(ים).
המספר אינו אקראי באמת אלא מחושב על פי אלגוריתם מיוחד, אך למטרות יומיומיות ניתן להתייחס אליו כאל מספר אקראי ממש. את תנאי ההתחלה לאלגוריתם החישוב אפשר להגדיר באמצעות הפונקציה randomSeed (תנאי התחלה זהים לאלגוריתם, כולל תנאי ברירת המחדל של ארדואינו, יגרמו להפקה של שרשרות מספרים “אקראיים” זהות).
פרמטרים
howsmall (אופציונלי) – מטיפוס long, הגבול המינימלי לערך שיתקבל מהפונקציה. הערך החוזר יהיה לכל הפחות ערך זה. אם פרמטר זה אינו נשלח לפונקציה במפורש, ברירת המחדל עבורו היא 0.
howbig – מטיפוס long, הגבול המקסימלי לערך שיתקבל מהפונקציה, ועוד אחד. במילים אחרות, הערך החוזר יהיה לכל היותר מספר זה פחות אחד.
ערך חוזר
מספר אקראי בטווח המבוקש, כלומר howsmall <= x < howbig. מטיפוס long.
דוגמאות
long x0To79 = random(80); long xThreeDigits = random(100, 1000);
הערות
- בגלל אי-תאימות בטיפוסי המשתנים בין הפונקציה random לבין הפונקציות שעליהן היא מתבססת, הטיפול במספרים שליליים אינו עקבי: אם random מקבלת רק פרמטר howbig וערכו שלילי, היא תחזיר ערכים אקראיים כאילו ערכו היה חיובי (לדוגמה, עבור random(-10) יתקבלו ערכים בין 0 ל-9, כולל).
- אם הוגדר במפורש ערך howsmall והוא גדול מערך howbig, התוצאה תהיה תמיד howsmall.