.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1990-1991, The Regents of the University of California.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fseek 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
fgetpos, fseek, fsetpos, ftell, rewind \- إعادة وضع دفق
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdio.h>\fP
.P
\fBint fseek(FILE *\fP\fIstream\fP\fB, long \fP\fIoffset\fP\fB, int \fP\fIwhence\fP\fB);\fP
\fBlong ftell(FILE *\fP\fIstream\fP\fB);\fP
.P
\fBvoid rewind(FILE *\fP\fIstream\fP\fB);\fP
.P
\fBint fgetpos(FILE *restrict \fP\fIstream\fP\fB, fpos_t *restrict \fP\fIpos\fP\fB);\fP
\fBint fsetpos(FILE *\fP\fIstream\fP\fB, const fpos_t *\fP\fIpos\fP\fB);\fP
.fi
.SH الوصف
تضبط دالة \fBfseek\fP()  مؤشر موضع الملف للدفق المشار إليه بـ \fIstream\fP.  يُحصل
على الموضع الجديد، المُقاس بالبايتات، بإضافة \fIoffset\fP بايت إلى الموضع
المُحدد بـ \fIwhence\fP.  إذا ضُبط \fIwhence\fP على \fBSEEK_SET\fP أو \fBSEEK_CUR\fP أو
\fBSEEK_END\fP، يكون الإزاحة نسبية إلى بداية الملف أو مؤشر الموضع الحالي أو
نهاية الملف، على التوالي.  يُزيل استدعاء ناجح لدالة \fBfseek\fP()  مؤشر نهاية
الملف للدفق ويُلغي أي تأثيرات لدالة \fBungetc\fP(3)  على نفس الدفق.
.P
تحصل دالة \fBftell\fP()  على القيمة الحالية لمؤشر موضع الملف للدفق المشار إليه
بـ \fIstream\fP.
.P
تضبط دالة \fBrewind\fP()  مؤشر موضع الملف للدفق المشار إليه بـ \fIstream\fP إلى
بداية الملف.  وهي مكافئة لـ:
.P
.RS
(void) fseek(stream, 0L, SEEK_SET)
.RE
.P
باستثناء أنه يُمسح أيضًا مؤشر الخطأ للدفق (انظر \fBclearerr\fP(3)).
.P
دالتا \fBfgetpos\fP()  و \fBfsetpos\fP()  هما واجهتان بديلتان مكافئتان لـ
\fBftell\fP()  و \fBfseek\fP()  (مع ضبط \fIwhence\fP على \fBSEEK_SET\fP)، حيث تضبطان
وتخزنان القيمة الحالية لإزاحة الملف في أو من الكائن المشار إليه بـ \fIpos\fP.
في بعض الأنظمة غير UNIX، قد يكون كائن \fIfpos_t\fP كائنًا معقدًا وقد تكون هاتان
الروتينان الطريقة الوحيدة لإعادة وضع دفق نصي بشكل محمول.
.P
إذا أشار الدفق إلى ملف عادي وكانت إزاحة الدفق الناتجة تتجاوز حجم الملف،
فستمتد الكتابات اللاحقة الملف بفجوة، حتى الإزاحة، قبل إيداع أي بيانات.  انظر
\fBlseek\fP(2)  للتفاصيل حول دلالات البحث في الملف.
.SH "قيمة الإرجاع"
لا تُرجع دالة \fBrewind\fP()  أي قيمة.  عند الإكمال الناجح، تُرجع \fBfgetpos\fP()
و \fBfseek\fP() و \fBfsetpos\fP()  القيمة 0، وتُرجع \fBftell\fP()  الإزاحة الحالية.
وإلا، تُرجع \-1 ويُضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
لم يكن معامل \fIwhence\fP لدالة \fBfseek\fP()  هو \fBSEEK_SET\fP أو \fBSEEK_END\fP أو
\fBSEEK_CUR\fP.  أو: ستكون إزاحة الملف الناتجة سالبة.
.TP 
\fBESPIPE\fP
وصف الملف الأساسي لـ \fIstream\fP غير قابل للبحث (مثلًا، يشير إلى أنبوب أو FIFO
أو مقبس).
.P
قد تفشل دوال \fBfgetpos\fP() و \fBfseek\fP() و \fBfsetpos\fP() و \fBftell\fP()  وتضبط
\fIerrno\fP لأي من الأخطاء المُحددة للروتينات \fBfflush\fP(3) و \fBfstat\fP(2) و
\fBlseek\fP(2) و \fBmalloc\fP(3).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBfseek\fP()،
\fBftell\fP()،
\fBrewind\fP()،
\fBfgetpos\fP()،
\fBfsetpos\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C89.
.SH "انظر أيضًا"
\fBlseek\fP(2), \fBfseeko\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .