.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2001, Andries E. Brouwer <aeb@cwi.nl>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asprintf 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
asprintf, vasprintf \- اطبع إلى سلسلة محارف مخصصة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#define _GNU_SOURCE\fP         /* انظر feature_test_macros(7) */
\fB#include <stdio.h>\fP
.P
\fBint asprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB, ...);\fP
\fBint vasprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB,\fP
\fB              va_list \fP\fIap\fP\fB);\fP
.fi
.SH الوصف
الدالتان \fBasprintf\fP() و \fBvasprintf\fP() هما نظيرتا \fBsprintf\fP(3) و
\fBvsprintf\fP(3)، باستثناء أنهما تخصصان سلسلة كبيرة بما يكفي لاستيعاب المخرجات
بما في ذلك البايت الفارغ الختامي (\[aq]\[rs]0\[aq])، وتعيدان مؤشرًا إليها
عبر الوسيط الأول. يجب تمرير هذا المؤشر إلى \fBfree\fP(3) لتحرير التخزين المخصص
عندما لا يعود مطلوبًا.
.SH "قيمة الإرجاع"
عند النجاح، تُعيد هاتان الدالتان عدد البايتات المطبوعة، تمامًا مثل
\fBsprintf\fP(3). عند الخطأ، يُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ، وتكون
محتويات \fIstrp\fP غير معرفة.
.SH الأخطاء
انظر \fBsprintf\fP(3) و\fBmalloc\fP(3).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBasprintf\fP(),
\fBvasprintf\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
.TE
.SH الإصدارات
يضبط تطبيق FreeBSD \fIstrp\fP إلى NULL عند الخطأ.
.SH المعايير
جنو، بي إس دي (BSD).
.SH "انظر أيضًا"
\fBfree\fP(3), \fBmalloc\fP(3), \fBprintf\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 .