puts(3)

الاسم
fputc, fputs, putc, putchar, puts - إخراج المحارف والسلاسل

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <stdio.h>

int fputc(int c, FILE *stream);
int putc(int c, FILE *stream);
int putchar(int c);

int fputs(const char *restrict s, FILE *restrict stream);
int puts(const char *s);

الوصف
تكتب الدالة fputc() المحرف c، المُحوَّل إلى unsigned char، إلى stream.

putc() مكافئة لـ fputc() باستثناء أنها قد تُنفَّذ كماكرو تُقيِّم stream أكثر من مرة.

putchar(c) مكافئة لـ putc(c, stdout).

تكتب الدالة fputs() السلسلة s إلى stream، دون بايت الصفر الختامي ('\0').

تكتب الدالة puts() السلسلة s وسطر جديد تالٍ إلى stdout.

يمكن خلط استدعاءات الدوال الموصوفة هنا مع بعضها البعض ومع استدعاءات دوال إخراج أخرى من مكتبة stdio لنفس دفق الإخراج.

للحصول على نظائر غير مقفلة، انظر unlocked_stdio(3).

قيمة الإرجاع
تُرجع fputc() و putc() و putchar() المحرف المكتوب كـ unsigned char مُحوَّل إلى int أو EOF عند الخطأ.

تُرجع puts() و fputs() عددًا غير سالب عند النجاح، أو EOF عند الخطأ.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
fputc()، fputs()، putc()، putchar()، puts() | سلامة الخيوط | MT-Safe

المعايير
C11, POSIX.1-2008.

التاريخ
POSIX.1-2001، C89، C99.

العلل
لا يُنصح بخلط استدعاءات دوال الإخراج من مكتبة stdio مع استدعاءات منخفضة المستوى لـ write(2) لواصف الملف المرتبط بنفس دفق الإخراج؛ ستكون النتائج غير محددة وعلى الأرجح ليست ما تريده.

انظر أيضًا
write(2)، ferror(3)، fgets(3)، fopen(3)، fputwc(3)، fputws(3)، fseek(3)، fwrite(3)، putwchar(3)، scanf(3)، unlocked_stdio(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.