Mohab: Arabic Translation for createDirectory Page

2025-04-09T02:29:16Z

Arabic Translation for createDirectory Page

New page

__NOTOC__
{{Useful_Function}}
تقوم هذه الوظيفة بإنشاء مجلد في المسار المحدد ضمن نظام ملفات المصدر(الريسورس) ، يتم إنشاء المجلدات تلقائيًا عند إنشاء ملف بداخلها، وتعمل هذه الوظيفة على تسهيل هذه العملية من خلال إنشاء ملف مؤقت ثم حذفه.

==الصيغة==
<syntaxhighlight lang="lua">bool createDirectory ( string directoryPath )</syntaxhighlight>

===المعاملات المطلوبة===
‫‫*'''directoryPath:''' سلسلة نصية تمثل مسار المجلد المراد إنشاؤه بالنسبة إلى مجلد الجذر الخاص بالمصدر (مثل `"myfolder"` أو `"myfolder/subfolder"`).‬

===القيم المعادة===
‫تُعيد القيمة `true` إذا تم إنشاء المجلد بنجاح، و`false` إذا فشل الإنشاء أو إذا تم تمرير معاملات غير صالحة.‬

==الكود==
'''أداة إنشاء المجلدات'''

<syntaxhighlight lang="lua">
function createDirectory(directoryPath)
-- التحقق مما إذا كان المسار مقدمًا وأنه عبارة عن سلسلة نصية
if not directoryPath or type(directoryPath) ~= "string" then
outputDebugString("خطأ: المسار المقدم غير صالح", 1)
return false
end

-- التأكد من أن المسار ينتهي بشرطة مائلة للأمام `/`
if not directoryPath:match("/$") then
directoryPath = directoryPath .. "/"
end

‫-- يتطلب نظام ملفات MTASA إنشاء ملف لتكوين المجلد تلقائيًا‬
local tempFilePath = directoryPath .. "temp.txt"
local file = fileCreate(tempFilePath)

if file then
-- كتابة شيء ما في الملف (اختياري، ولكنه ممارسة جيدة لضمان الإنشاء)
fileWrite(file, "ملف مؤقت لإنشاء المجلد")
fileClose(file)

-- حذف الملف المؤقت للحفاظ على المجلد نظيفًا
fileDelete(tempFilePath)

outputDebugString("تم إنشاء المجلد: " .. directoryPath)
return true
else
outputDebugString("فشل في إنشاء المجلد: " .. directoryPath, 1)
return false
end
end
</syntaxhighlight>

<section name="Function source" class="server" show="true">
‫هذه الوظيفة هي طريقة بسيطة وفعالة لإنشاء المجلدات في MTASA. تعتمد على سلوك نظام ملفات MTASA الذي يقوم بإنشاء المجلدات تلقائيًا عند إنشاء ملف داخلها. يتم إنشاء ملف مؤقت ثم حذفه لتبقى المجلدات فارغة وجاهزة للاستخدام.
‬</section>

==الاستخدام==
‫يوضح هذا المثال كيفية استدعاء وظيفة `createDirectory` لإنشاء مجلد وتوفير ملاحظات في وحدة تحكم الخادم.‬
<syntaxhighlight lang="lua">
‫-- إنشاء مجلد باسم `"logs"` داخل مجلد المصدر
‬local success = createDirectory("logs")
if success then
outputConsole("تم إنشاء المجلد 'logs' بنجاح!")
else
outputConsole("فشل في إنشاء المجلد 'logs'.")
end

‫-- إنشاء هيكل مجلد متداخل مثل
`"data/user/files"`‬local nestedSuccess = createDirectory("data/user/files")
if nestedSuccess then
outputConsole("تم إنشاء المجلد المتداخل 'data/user/files' بنجاح!")
else
outputConsole("فشل في إنشاء المجلد المتداخل 'data/user/files'.")
end
</syntaxhighlight>

==ملاحظات==
* ‫يجب كتابة هذه الوظيفة في سكريبت على جانب الخادم(سيرفر سايد) لأن عمليات نظام الملفات مثل `fileCreate` و`fileWrite` و`fileClose` و`fileDelete` مقيدة بجانب الخادم(سيرفر سايد) في MTASA لأسباب أمنية وللتنسيق.‬
* ‫مسار المجلد يكون بالنسبة إلى مجلد الجذر الخاص بالمصدر (مثل `:resourceName/directoryPath/`).‬
* ‫تأكد من أن المصدر لديه تصاريح ملفات مناسبة في ملف `meta.xml`:‬
<syntaxhighlight lang="xml">
<meta>
<script src="yourscript.lua" type="server" />
<file src="*" />
</meta>
</syntaxhighlight>

''المؤلف'': Mohab

==أنظر أيضاً==
{{AR/Useful_Functions}}
[[en:createDirectory]]

AR/createDirectory - Revision history

Mohab: Arabic Translation for createDirectory Page