ForHosting KIT · النصوص والذكاء الاصطناعي

نقل صفوف وأعمدة CSV

يتحول جدول عناوينه name,age,city وصفوفه Ada,36,London وBob,41,Paris إلى name,Ada,Bob ثم age,36,41 ثم city,London,Paris: يصبح كل صف عمودًا. وتُكمَّل الصفوف القصيرة بخلايا فارغة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

بيانات CSV: name,age,city Ada,36,London Bob,41,Paris

تحصل على

بيانات CSV: name,Ada,Bob age,36,41 city,London,Paris
الصفوف: 3
الأعمدة: 3
الصفوف الأصلية: 3

نقل جدول CSV يعني أن كل صف يصبح عمودًا وكل عمود يصبح صفًا، فيتحول التصدير العريض إلى طويل والطويل إلى عريض دون إعادة كتابة الخلايا يدويًا. يستخدم المحللون هذا القلب عندما تصل الورقة بمقاييس في صفوف بدل الأعمدة، أو عندما تريد أداة الرسوم السلاسل في العمود الأول، أو عندما يلزم فك تخطيط يشبه المحور قبل الدمج. تحلل هذه القدرة CSV بأسلوب RFC 4180، وتملأ الصفوف القصيرة لتصبح الشبكة مستطيلة، وتُبدّل الفهارس، وتعيد كتابة الجدول المنقول بنفس الفاصل والاقتباس الصحيح.

معنى نقل صفوف وأعمدة ملف CSV

ملف CSV شبكة شبه مستطيلة: سجلات تفصلها فواصل أسطر وحقول يفصلها فاصل، غالبًا فاصلة. نقل هذه الشبكة هو نفس تبديل الشكل المعروف من الجبر الخطي، مطبّقًا على خلايا نصية لا على أرقام. يصبح صف الإدخال الأول عمود الإخراج الأول؛ ويصبح عمود الإدخال الأول صف الإخراج الأول.

جدول ثلاثة في اثنين يصبح اثنين في ثلاثة. الرؤوس ليست حالة خاصة: إن كان الصف الأول name وage وcity انتقلت تلك التسميات إلى العمود الأول من النتيجة، وهو ما تطلبه معظم عمليات البحث عن «اقلب ورقة الحساب هذه». لا يصح التعريف إلا عندما يشترك كل صف في عدد الأعمدة نفسه.

غالبًا ما تكون التصديرات الحقيقية متعرجة — سطر ينقصه الحقل الفارغ الختامي، وآخر يحمل فاصلة زائدة — لذا تملأ هذه الأداة الصفوف القصيرة بسلاسل فارغة حتى أعرض صف، بدل اختراع بيانات أو إسقاط خلايا. تتبع الحقول المقتبسة RFC 4180: تبقى الخلية التي تحتوي الفاصل أو علامة اقتباس مزدوجة أو فاصل سطر خلية واحدة، وتُكتب علامة الاقتباس المضمّنة علامتي اقتباس. فضّل صفحة الهبوط transpose-csv-rows-and-columns هذه عندما تكون النية قلب الاتجاه فقط.

عقد الإدخال وقواعد الاقتباس وحقول الاستجابة

القيمة الافتراضية للحقل الاختياري delimiter هي الفاصلة؛ استخدم حرفًا واحدًا أو التهجئة الشائعة لعلامة الجدولة مع TSV. يُقتبس الحقل عند الإخراج فقط إذا احتوى الفاصل أو علامة اقتباس أو CR أو LF، فتبقى المعرّفات البسيطة مضغوطة. تُتخطى الأسطر الفارغة في المصدر؛ وتُحفظ الخلايا الفارغة، بما فيها خلية فارغة بادئة بعد القلب.

مثال: name,age ثم Ada,36 تصبح name,Ada في صف النتيجة الأول وage,36 في الثاني. استخدم csv عندما تحتاج ملفًا للتنزيل أو اللصق؛ واستخدم cells عندما سيرسم عميل جدولًا دون إعادة التحليل.

الاستخدام اليومي والحدود العملية للأداة

استدعِ أداة نقل CSV المجانية في المتصفح عندما تحتاج قلب جدول واجبات أو تصدير CRM أو دفق مقاييس دون فتح ورقة حساب أو كتابة سكربت لمرة واحدة. مسار عمل شائع يلصق تصديرًا عريضًا تكون الأشهر فيه في الأعلى، وينقله ليصبح كل شهر صفًا، ثم يغذي النتيجة رسمًا أو دمجًا. مسار آخر يبني تثبيتات حتمية: قدّم عينة معروفة بحقل مقتبس يحتوي فاصلة، وثبّت الحقلين csv وcells، واجعل التكامل المستمر يفشل إن أساء إعادة هيكلة لاحقة معالجة الاقتباس أو الملء.

اقرن هذه النقطة النهائية بـ extract-csv-column أو filter-csv أو csv-to-json عندما تكون الخطوة التالية قائمة حقل واحد أو تصفية صفوف أو مصفوفة كائنات، لكن أبقِ نقل CSV صفحة هبوط مستقلة حتى لا تختلط نية قلب الاتجاه بتحويلات تعيد تسمية الأعمدة أو تحسبها. لا تتوقع كشفًا تلقائيًا للفاصل ولا استدلال أنواع ولا محرك جداول محورية كاملًا مع تجميعات؛ فتلك مسائل أخرى.

حالات الاستخدام

اقلب تصديرًا شهريًا عريضًا

الصق ورقة يكون كل شهر فيها عمودًا، وانقلها ليصبح كل شهر صفًا، ثم أدخِل الجدول الطويل إلى رسم أو عملية دمج.

أصلح تفريغ استبيان جانبيًا

تُخرج أدوات الاستبيان أحيانًا مستجيبًا واحدًا في كل عمود. انقل ملف CSV ليصبح كل شخص صفًا قبل التحليل.

الأسئلة الشائعة

كيف أنقل صفوف وأعمدة ملف CSV؟

حقل csv في الاستجابة هو الجدول المقلوب؛ وcells هي الشبكة نفسها كمصفوفات. القيمة الافتراضية لـ delimiter الاختياري هي الفاصلة.

ماذا يحدث لصف الرأس؟

يصبح الصف الأول العمود الأول. تنتقل تسميات مثل name وage وcity إلى عمود الإخراج الأول، وهو القلب المعتاد لورقة الحساب.

كيف تُعالَج الصفوف غير المتساوية؟

تُملأ الصفوف القصيرة بسلاسل فارغة حتى أعرض صف ليبقى النقل مستطيلًا. لا تُسقط خلايا ولا تُخترع قيم سوى تلك الفراغات.

هل يحتفظ بالفواصل داخل الحقول المقتبسة؟

نعم. يتبع التحليل والكتابة RFC 4180: يجوز أن تحتوي الحقول المقتبسة الفاصل وعلامات الاقتباس (مضاعفة) وفواصل الأسطر.

هل يمكن قلب الجداول المفصولة بفاصلة منقوطة أو بعلامة جدولة؟

نعم. اختر الفاصل المناسب، والفاصلة هي الخيار الافتراضي. وتستخدم النتيجة الفاصل نفسه، ولا تضع علامات الاقتباس إلا حول الخلايا التي تحتاج إليها.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/str/csv-transpose

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/str/csv-transpose \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,age,city\nAda,36,London\nBob,41,Paris"}'

const res = await fetch("https://api.kit.forhosting.com/str/csv-transpose", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/csv-transpose",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/csv-transpose", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"name,age,city\\nAda,36,London\\nBob,41,Paris"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"name,age,city\nAda,36,London\nBob,41,Paris"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/csv-transpose", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.csv_transpose",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

يفشل الإدخال الفارغ والاقتباس غير المغلق والجداول المفرطة الحجم بـ invalid_input بدل شبكة ناقصة صامتة. يشترك ودجت المتصفح المجاني وواجهة API المدفوعة مسبقًا في وحدة حتمية واحدة. تُفوتر استدعاءات API الناجحة بمبلغ $0.002؛ ولا تُفوتر إخفاقات التحقق.

معنى نقل صفوف وأعمدة ملف CSV

لا تستخدمها لتصفية الصفوف أو إعادة تسمية أعمدة كثيرة أو دمج ملفين أو تحويل جدول كامل إلى JSON متداخل؛ فتلك نوايا منتج منفصلة. المسار حتمي بالكامل: النص CSV نفسه والفاصل نفسه ينتجان دائمًا JSON نفسه بلا شبكة ولا بذرة عشوائية ولا ساعة جدارية.

عقد الإدخال وقواعد الاقتباس وحقول الاستجابة

أرسل جسم JSON بالحقل النصي الإلزامي csv مضبوطًا على نص الجدول غير الفارغ. تُقبل الأسماء البديلة text وinput وdata وsource وcontent وvalue لجسم CSV. غياب csv، وcsv الفارغ، وcsv غير النصي، وفاصل ليس حرفًا واحدًا تمامًا، وفاصل هو علامة اقتباس أو سطر جديد، والحقول المقتبسة غير المغلقة، والجداول التي تتجاوز حدود الحجم الموثّقة ترفع جميعها invalid_input برسالة تسمّي المشكلة، ولا تُفوتر تلك الإخفاقات على واجهة API المدفوعة مسبقًا. عند النجاح تتضمن الاستجابة csv كنص الجدول المنقول بفواصل أسطر LF واقتباس RFC 4180، وcells كالشبكة نفسها على هيئة مصفوفات، وrows وcols لشكل النتيجة، وoriginal_rows وoriginal_cols لشكل الإدخال (original_cols هو أقصى عرض قبل الملء)، وdelimiter يعيد الفاصل المستخدم، وmethod دائمًا csv_transpose.

استخدام واجهة API والتسعير ومسارات العمل والحدود العملية

استخدم واجهة KIT المدفوعة مسبقًا عندما يحتاج نظام إدارة محتوى أو خطوة ETL أو إطار QA أو تطبيق تدريس أو عميل جوّال نفس العقد برصيد قدره $0.002 لكل عنصر ناجح؛ ولا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك للطلب. يمكن لمن ينشرون حزم SDK توثيق csv كحقل إلزامي، وعرض مثال نجاح بصف رأس، ومثال خطأ لغياب csv حتى يرى المكاملون وجهي العقد. أبقِ الحمولات ضمن أحجام مستندات عادية تناسب عزل Worker، لا تفريغات مستودعات بعدة ميغابايت.

حالات التكامل

تثبيتات golden لمحلّلات CSV

تثبّت سكربتات التكامل المستمر عينة مقتبسة متعرجة وتتحقق من csv وcells بعد النقل حتى لا يتراجع الاقتباس والملء في صمت.

أسئلة تقنية

هل أداة نقل CSV مجانية؟

تعمل أداة المتصفح مجانًا على جهازك. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل عنصر ناجح؛ ولا تُفوتر الإدخال غير الصالح.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

معنى نقل صفوف وأعمدة ملف CSV

عقد الإدخال وقواعد الاقتباس وحقول الاستجابة

الاستخدام اليومي والحدود العملية للأداة

حالات الاستخدام

اقلب تصديرًا شهريًا عريضًا

أصلح تفريغ استبيان جانبيًا

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

معنى نقل صفوف وأعمدة ملف CSV

عقد الإدخال وقواعد الاقتباس وحقول الاستجابة

استخدام واجهة API والتسعير ومسارات العمل والحدود العملية

حالات التكامل

تثبيتات golden لمحلّلات CSV

أسئلة تقنية

شكرًا