EEPROM.get – הסבר ופרטים

- עמוד זה הוא חלק מהמדריך לפונקציות ארדואינו -

הפונקציה EEPROM.get(idx, t) משמשת לקריאת משתנים, ומבני נתונים סטטיים אחרים, מהזכרון הבלתי-נדיף מסוג EEPROM שבמיקרו-בקר הראשי בלוח הארדואינו.

פרמטרים

idx, מטיפוס int, הוא הכתובת ב-EEPROM בה מתחילים הנתונים. הטווח החוקי מתחיל ב-0, וברוב לוחות הארדואינו מסתיים ב-1023 (כולל). בלוח ארדואינו Mega, הטווח הוא עד 4095 (כולל).

t הוא שם המשתנה או מבנה הנתונים לתוכו יש לקרוא את המידע מה-EEPROM.

ערך חוזר

המידע שנקרא מה-EEPROM, באותו טיפוס משתנה או מבנה נתונים כמו t. כיוון שהמידע מועתק ממילא ישירות לתוך t, אין צורך להשתמש בערך החוזר הזה (ראו בדוגמאות)

דוגמאות

#include <EEPROM.h>
uint16_t x, y;
y = EEPROM.get(10, x); 
// Now y has the same value as x
EEPROM.get(88, x);
// Now x is probably different, y stays the same

הערות

  • אם ערך הפרמטר idx חורג בשלב כלשהו מגבולות הזכרון הפיזי, התוכנה “מגלגלת” אותו אוטומטית לתוך הגבולות. לדוגמה, בארדואינו Uno בו כתובות ה-EEPROM האמתיות הן בין 0 ל-1023 (כולל), פניה לכתובת 1024 – או קריאה של יותר מבייט יחיד מכתובת 1023 – תחזור בפועל לכתובת 0.
  • הקריאה מה-EEPROM מהירה, ואין מגבלה על מספר הקריאות (המגבלה ב-EEPROM היא על כתיבות בלבד).
  • גם אם המשתנה או מבנה הנתונים שנקראים גדולים יותר מבייט אחד, הכתובת idx היא ביחידות של בייט.
  • הפונקציה אינה בודקת בשום צורה אם המידע שנקרא תקין או הגיוני. זו אחריות המתכנת/ת.

קישורים רלוונטיים

בלוג אישי בנושאי מייקינג, תכנות, מיקרו-בקרים ואלקטרוניקה