الدالة ftruncate()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تقلِّص الدالة ftruncate()‎ حجم الملف إلى حجم محدَّد.

الوصف

bool ftruncate ( resource $handle , int $size )

تقلِّص هذه الدالة حجم الملف الذي يشير إليه المورد handle إلى الحجم size المعطى.

المعاملات

handle

مؤشِّر (pointer) يشير إلى ملف.

ملاحظة: يجب أن يُفتح الملف في وضع الكتابة.

size

الحجم المراد تقليص الملف إليه.

ملاحظة: إن كان الحجم size المُعطى أكبر من حجم الملف، فسيُمدَّد حجم الملف إلى الحجم size بإضافة بايتات فارغة (null bytes) إليه. أمَّا إن كان الحجم size أصغر من حجم الملف، فسيُقلَّص حجم الملف إلى تلك القيمة.

القيم المعادة

تُعاد القيمة TRUE عند نجاح العمليَّة. خلا ذلك، تُعاد القيمة FALSE.

أمثلة

المثال 1: استعمال الدالة ftruncate()‎

<?php
$filename = 'lorem_ipsum.txt';

$handle = fopen($filename, 'r+');
ftruncate($handle, rand(1, filesize($filename)));
rewind($handle);
echo fread($handle, filesize($filename));
fclose($handle);
?>

ملاحظات

لن يُغيَّر مؤشِّر الملف.

انظر أيضًا

• الدالة fopen()‎: تفتح ملفًا أو عنوان URL.
• الدالة rewind()‎: تبحث عن مؤشِّر الملف الحالي ثمَّ تعيد ضبط موقعه.

مصادر

• صفحة الدالة ftruncate في توثيق PHP الرسمي.