فقط ستون‌های موردنیاز CSV را نگه دارید

نام ستون در نهایت به یک جایگاه می‌رسد

جدول جداشده دنباله‌ای از ردیف‌هاست و هر ردیف دنباله‌ای از فیلدها. ردیف عنوان برای این جایگاه‌ها نام می‌گذارد، اما دادهٔ زیر هر نام همچنان به یک موقعیت ثابت وابسته است. انتخاب Email یعنی یافتن موقعیت یکتای این عنوان و برداشتن همان موقعیت از تک‌تک ردیف‌های بعدی.

اگر عنوان تکرار شود، نام به‌تنهایی کافی نیست:

Name,Email,Email
Ada,home@example.test,work@example.test

در این نمونه #2 ایمیل نخست و #3 ایمیل دوم را انتخاب می‌کند. ابزار کلمهٔ Email را نمی‌پذیرد، چون یک فایل ظاهراً معتبر با نشانی اشتباه از یک خطای آشکار خطرناک‌تر است. شماره‌ها یک‌مبنایی‌اند تا #1 همان ستون نخست قابل مشاهده باشد.

فهرست خالی همهٔ موقعیت‌ها را نگه می‌دارد. این حالت برای تبدیل جداکننده یا بازنویسی ساختار فایل بدون حذف ستون هم مفید است.

چرا جداکردن متن با ویرگول کافی نیست

ویرگول فقط بیرون از گیومه مرز ساختاری است. این ردیف سه فیلد دارد، نه چهار:

Name,City,Note
Ada,London,"writes, tests"

فیلد گیومه‌دار می‌تواند شکست خط هم داشته باشد و گیومهٔ واقعی درون آن دو بار نوشته می‌شود. تجزیه‌گر هنگام حرکت روی نویسه‌ها فقط یک حالت را نگه می‌دارد: آیا اکنون داخل گیومه است یا نه. بیرون گیومه، جداکننده فیلد را تمام می‌کند و شکست خط رکورد را؛ داخل گیومه هر دو متن‌اند.

تشخیص خودکار نیز همین قانون را روی نخستین رکورد کامل اجرا می‌کند. گزینهٔ دستی هم باقی مانده است، چون در عنوان تک‌ستونی هیچ جداکننده‌ای برای حدس‌زدن وجود ندارد.

نمونهٔ کامل

فایل چهارستونی زیر را در نظر بگیرید:

Name,Email,City,Note
Ada,ada@example.test,London,"writes, tests"
Grace,grace@example.test,New York,"line one
line two"

این دو خط را در فهرست ستون‌ها وارد کنید:

Email
Name

خروجی ۲ ردیف داده دارد، ۲ ستون از ۴ ستون را نگه می‌دارد و Email را پیش از Name می‌آورد:

Email,Name
ada@example.test,Ada
grace@example.test,Grace

ویرگول و شکست خط ستون حذف‌شدهٔ Note همچنان درست خوانده می‌شوند؛ بنابراین نه ردیف خیالی می‌سازند و نه City را زیر عنوان دیگری می‌برند. همین ورودی و بایت‌های خروجی CRLF در آزمون ابزار ثبت شده‌اند.

مقدار سلول‌ها به تاریخ یا عدد تبدیل نمی‌شود، پس 007 همان 007 می‌ماند. ممکن است شکل فیزیکی فایل عوض شود: پایان رکوردها CRLF می‌شود و گیومهٔ غیرضروری حذف یا گیومهٔ لازم افزوده می‌شود. هدف حفظ جدول انتخاب‌شده است، نه حفظ تک‌تک بایت‌های قالب‌بندی فایل اصلی.