عرض مصدر Python/dbm/open

<noinclude>{{DISPLAYTITLE:الدالة <code>dbm.open()‎</code> في بايثون}}</noinclude>
‎
تفتح الدالة الملف المعطى وتعيد كائنًا موافقًا له.

== البنية العامة ==

<syntaxhighlight lang="python3">
dbm.open(file, flag='r', mode=0o666)
</syntaxhighlight>
== المعاملات ==

=== <code>file</code> ===
إن كان ملف قاعدة البيانات موجودًا أصلًا، فستستخدم الدالة <code>[[Python/dbm/whichdb|whichdb()‎]]</code> لتحديد نوعه والوحدة المناسبة للاستخدام، أما إن لم يكن الملف موجودًا فستستخدم الدالة أول وحدة قابلة للاستيراد من الوحدات <code>[[Python/dbm.gnu|dbm.gnu]]</code> أو <code>[[Python/dbm.ndbm|dbm.ndbm]]</code> أو <code>[[Python/dbm.dumb|dbm.dumb]]</code>.

=== <code>flag</code> ===
يأخذ المعامل الاختياري <code>flag</code> إحدى القيم التالية:
{| class="wikitable"
!القيمة
!الوصف
|-
|<code>'r'</code>
|فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية).
|-
|<code>'w'</code>
|فتح قاعدة البيانات للكتابة والقراءة.
|-
|<code>'c'</code>
|فتح قاعدة البيانات للكتابة والقراءة، وإنشائها في حال عدم وجودها.
|-
|<code>'n'</code>
|تنشئ الدالة قاعدة بيانات جديدة وفارغة، وتفتحها للكتابة والقراءة.
|}

=== <code>mode</code> ===
المعامل الاختياري <code>mode</code> هو وضع يونكس Unix mode للملف المعطى، ويستخدم بعد إنشاء قاعدة البيانات فقط. يأخذ هذا المعامل القيمة الثمانية الافتراضية <code>0o666</code> (وسيجري تعديله بواسطة الأمر <code>umask</code>).

== القيمة المعادة ==
تفتح الدالة الملف المعطى وتعيد كائنًا موافقًا له.

يدعم الكائن المعاد بواسطة الدالة <code>open()</code>‎ نفس الوظائف التي تدعمها [[Python/dict|القواميس]]، ويمكن تخزين المفاتيح وقيمها المقابلة واسترجاعها وحذفها، ويمكن استخدام العامل <code>in</code> والتابع [[Python/dict/keys|<code>keys()</code>‎]] كذلك، إضافة إلى التابعين <code>[[Python/dict/get|get()‎]]</code> و <code>[[Python/dict/setdefault|setdefault()]]‎</code>.

'''ملاحظة:''' أصبح بالإمكان استخدام التابعين <code>[[Python/dict/get|get()‎]]</code>  و <code>[[Python/dict/setdefault|setdefault()]]‎</code> في جميع وحدات قواعد البيانات.

تخزن المفاتيح والقيم دائمًا كبايتات، وهذا يعني أنّ السلاسل النصية تحوّل ضمنيًا إلى الترميز الافتراضي قبل تخزينها.

يمكن استخدام هذه الكائنات مع عبارة <code>with</code>، والتي ستغلق هذه الكائنات تلقائيًا بعد الانتهاء منها.

'''ملاحظة:''' في الإصدار 3.4 أضيف دعم لبروتوكول إدارة السياق context management protocol إلى الكائنات المعادة من الدالة <code>open()‎</code>.

== أمثلة ==

في المثال التالي تضاف بعض أسماء الاستضافات والعناوين المرتبطة بها إلى قاعدة البيانات، ثم تطبع محتوياتها في المخرجات:

<syntaxhighlight lang="python3">
import dbm

# فتح قاعدة البيانات وإنشاؤها إن دعت الحاجة إلى ذلك
with dbm.open('cache', 'c') as db:

    # حفظ بعض البيانات
    db[b'hello'] = b'there'
    db['www.python.org'] = 'Python Website'
    db['www.cnn.com'] = 'Cable News Network'

    # لاحظ أن المفاتيح تعدّ بايتات الآن.‏
    assert db[b'www.python.org'] == b'Python Website'
    # لاحظ كيف أنّ القيم الآن أصبحت بايتات.
    assert db['www.cnn.com'] == b'Cable News Network'

    # يمكن استخدام التوابع المستخدمة مع القواميس.‏
    print(db.get('python.org', b'not present'))

    # يؤدي تخزين مفاتيح أو قيم غير نصية إلى إطلاق استثناء
    # TypeError غالبًا ما يكون من نوع
    db['www.yahoo.com'] = 4

# with تغلق قاعدة البيانات تلقائيًا عند الخروج من عبارة
</syntaxhighlight>

== انظر أيضًا ==
*الدالة <code>[[Python/dbm.gnu|dbm.gnu.open()‎]]</code> : تفتح الدالة قاعدة بيانات gdbm وتعيد كائن <code>gdbm</code>.
*الدالة <code>[[Python/dbm.ndbm|dbm.ndbm.open()‎]]</code> : تفتح الدالة قاعدة بيانات dbm وتعيد كائن <code>ndbm</code>.
*الدالة <code>[[Python/dbm.dumb|dbm.dumb.open()‎]]</code> : تفتح الدالة قاعدة بيانات dumbdbm وتعيد كائن <code>dumbdbm</code>.
== مصادر ==
[https://docs.python.org/3/library/dbm.html#dbm.open صفحة Interfaces to Unix “databases”‎ في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]