اکسل excel
خواندن و نوشتن صفحهگستردههای اکسل (xlsx)، اوپنداکیومنت (ods) و CSV: برگه، سلول، سبک، فرمول و تاریخ.
واردسازی اکسل
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
یک کتاب کار چند برگه دارد و هر برگه سلولهایی با سطر و ستون از صفر. ارجاعهای اکسل مثل C5 را با ارجاع سلول و تجزیه ارجاع سلول به سطر و ستون تبدیل کنید.
بازکردن و ذخیره قالب را از پسوند پرونده میفهمند. فرمولها با آخرین نتیجهی حسابشدهشان ذخیره و خوانده میشوند، ولی سلام خودش فرمول را حساب نمیکند.
این بسته را وقتی به کار ببرید که آدمها صفحهگسترده به شما میدهند یا انتظار دارند یکی پس بگیرند: فرم بارگذاری فهرست قیمت، گزارش ماهانه برای واحد مالی، یا دکمهی خروجی گرفتن. وقتی داده را فقط برنامهها میخوانند، پروندهی CSV با بستهی سی اس وی سادهتر است؛ و برای تحلیل ستونهای عددی، سطرها را با بستهی داده در یک جدول بریزید.
اشتباههای رایج
- پروندههای قدیمی
.xlsخوانده میشوند. کتابهای BIFF8 (اکسل ۹۷ تا ۲۰۰۳)، از جمله جریانهای OLE2 که در جریان کوچک ذخیره شدهاند، به برگه، رشته، عدد، منطقی، تاریخ، خطا، سلول ادغامشده و مقدار کششدهی فرمول تبدیل میشوند.ذخیرههنوز فقط xlsx، ods یا csv مینویسد. - پسوند قالب را تعیین میکند.
تشخیص قالب،بازکردنوذخیرهفقط به نام پرونده نگاه میکنند، پس xlsxای که با نامreport.datذخیره شده باز نمیشود. نام پروندههای بارگذاریشده را درست کنید یا بایتهای نخست را خودتان بررسی کنید (PKبرای xlsx و ods). - فرمولها حساب نمیشوند. سلول فرمول نتیجهای را دارد که همراهش ذخیره شده؛ وقتی فرمول مینویسید، نتیجه را خودتان حساب کنید و بدهید.
- سطر و ستون از صفر شمرده میشوند، در حالی که اکسل ۱ و A نشان میدهد.
تجزیه ارجاع سلولوارجاع سلولتبدیل میکنند. برگه به جیسونفقط رشته میدهد: آرایهای از سطرها که هر کدام آرایهای از متن سلولهاست. هر جا عدد لازم داریدCell.kindرا بخوانید.
راهنمای زیر کارهایی را که در برنامههای واقعی پیش میآید نشان میدهد: خواندن برگهای که دیگران پر کردهاند، ساختن گزارش قالببندیشده، کار با تاریخ، تبدیل کتاب کار به پروندههای CSV و پیدا کردن مقدار با ارجاع یا با محتوا.
خواندن سطرهای برگهای که دیگران پر کردهاند
صفحهگستردهای که آدمها با دست ویرایش میکنند هیچوقت کاملا منظم نیست: ستونها جابهجا میشوند، سطری خالی میماند و در خانهی عددی یک واژه نوشته میشود. هر ستون را با متن سرآیندش پیدا کنید و به جایگاهش اعتماد نکنید، از سطرهای بیکلید بگذرید و پیش از آنکه مقداری را عدد بدانید به kind سلول نگاه کنید. دریافت رشته همیشه متن برمیگرداند، هر چه در سلول باشد، پس برای پیامها بیخطر است. بازکردن پروندهای را که نمیتواند بخواند با خوب و خطا گزارش میدهد.
واردسازی اکسل
تابع ستون سرآیند(برگه: اکسل.برگه*، نام: رشته): صحیح:
تکرار برگه.شمار ستونها() در س:
اگر برگه.دریافت رشته(۰، س) برابر نام: برگشت س پایان
پایان
برگشت -۱
پایان
تابع ساخت پرونده():
ناپایا کتاب := اکسل.کتاب کار جدید()
برگه := کتاب.افزودن برگه("نمرهها")
هر س، عنوان در ["نام"، "شهر"، "نمره"]: برگه.تنظیم رشته(۰، س، عنوان) پایان
برگه.تنظیم رشته(۱، ۰، "علی")
برگه.تنظیم رشته(۱، ۱، "تهران")
برگه.تنظیم عدد(۱، ۲، ۱۷.۵)
برگه.تنظیم رشته(۲، ۰، "سارا")
برگه.تنظیم رشته(۲، ۱، "شیراز")
برگه.تنظیم عدد(۲، ۲، ۱۹)
برگه.تنظیم رشته(۴، ۰، "رضا")
برگه.تنظیم رشته(۴، ۲، "غایب")
کتاب.ذخیره("grades.xlsx")
کتاب.آزادسازی()
پایان
تابع ریشه:
ساخت پرونده()
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا کتاب := اکسل.بازکردن("grades.xlsx"، خوب، خطا)
اگر خوب برابر نادرست:
سرچاپ "باز نشد:"، خطا
برگشت ۱
پایان
برگه := کتاب.برگه در(۰)
ستون نام := ستون سرآیند(برگه، "نام")
ستون نمره := ستون سرآیند(برگه، "نمره")
ناپایا جمع := ۰.۰
ناپایا شمرده := ۰
تکرار برگه.شمار سطرها() - ۱ در ی:
سطر := ی + ۱
اگر برگه.دارای سلول(سطر، ستون نام) برابر نادرست: گذر پایان
سلول := برگه.دریافت سلول(سطر، ستون نمره)
اگر سلول.نوع نابرابر اکسل.سلول عددی:
سرچاپ برگه.دریافت رشته(سطر، ستون نام)، "کنار گذاشته شد:"، برگه.دریافت رشته(سطر، ستون نمره)
گذر
پایان
سرچاپ برگه.دریافت رشته(سطر، ستون نام)، سلول.عدد
جمع += سلول.عدد
شمرده++
پایان
سرچاپ "میانگین"، شمرده، "نفر ="، جمع / (شمرده برگردان اعشار۶۴)
کتاب.آزادسازی()
برگشت ۰
پایانشمارهی سطرها از صفر است، پس سرآیند سطر ۰ است و داده از سطر ۱ شروع میشود. شمار سطرها یکی بیشتر از آخرین سطری است که سلول دارد؛ برای همین سطر خالی ۳ هم در حلقه میآید و دارای سلول از آن میگذرد.
ساختن گزارش قالببندیشده
یک سبک متن پررنگ، اندازهی قلم، رنگ زمینه، چینش و قالب عدد را توصیف میکند. هر سبک را یک بار با کتاب.styles.دریافت با افزودن ثبت کنید که یک شناسه برمیگرداند، و همان شناسه را به تنظیم سبک برای هر تعداد سلول بدهید. ادغام سلولها یک بازه را برای عنوان یکی میکند و تنظیم فرمول فرمول را همراه با مقداری که خودتان حساب کردهاید نگه میدارد، چون سلام فرمول را مینویسد ولی حسابش نمیکند.
واردسازی اکسل
تابع ریشه:
ناپایا کتاب := اکسل.کتاب کار جدید()
ناپایا برگه := کتاب.افزودن برگه("فروردین")
عنوان := کتاب.سبکها.دریافت با افزودن(اکسل.سبک { پررنگ = درست، اندازه قلم = ۱۴، چینش افقی = اکسل.میانچین })
سرستون := کتاب.سبکها.دریافت با افزودن(اکسل.سبک { پررنگ = درست، رنگ زمینه = "DDEBF7" })
پول := کتاب.سبکها.دریافت با افزودن(اکسل.سبک { قالب عدد = "#,##0.00" })
برگه.تنظیم رشته(۰، ۰، "فروش فروردین ۱۴۰۵")
برگه.ادغام سلولها(۰، ۰، ۰، ۳)
برگه.تنظیم سبک(۰، ۰، عنوان)
هر ستون، نام در ["کالا"، "تعداد"، "قیمت"، "جمع"]:
برگه.تنظیم رشته(۱، ستون، نام)
برگه.تنظیم سبک(۱، ستون، سرستون)
پایان
کالاها := ["چای"، "شکر"، "برنج"]
تعدادها := [۱۲، ۳۰، ۵]
قیمتها := [۴.۵، ۱.۲۵، ۹.۸]
ناپایا کل := ۰.۰
تکرار ۳ در ی:
سطر := ی + ۲
مبلغ := (تعدادها[ی] برگردان اعشار۶۴) * قیمتها[ی]
برگه.تنظیم رشته(سطر، ۰، کالاها[ی])
برگه.تنظیم عدد صحیح(سطر، ۱، تعدادها[ی] برگردان صحیح۶۴)
برگه.تنظیم عدد(سطر، ۲، قیمتها[ی])
برگه.تنظیم فرمول(سطر، ۳، اکسل.ارجاع سلول(سطر، ۱) + "*" + اکسل.ارجاع سلول(سطر، ۲)، مبلغ)
برگه.تنظیم سبک(سطر، ۳، پول)
کل += مبلغ
پایان
برگه.تنظیم رشته(۵، ۲، "مجموع")
برگه.تنظیم فرمول(۵، ۳، "SUM(D3:D5)"، کل)
برگه.تنظیم سبک(۵، ۳، پول)
سرچاپ "ذخیره شد:"، کتاب.ذخیره("march.xlsx")
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا خوانده := اکسل.بازکردن("march.xlsx"، خوب، خطا)
ب := خوانده.برگه("فروردین")
سرچاپ ب.دریافت رشته(۰، ۰)، "ادغام شده:"، ب.ادغامشده است(۰، ۳)
سرچاپ ب.دریافت فرمول(۵، ۳)، "="، ب.دریافت عدد(۵، ۳)
سرچاپ "سبک D3:"، خوانده.سبکها.بگیر(ب.دریافت سلول(۲، ۳).شماره سبک).قالب عدد
خوانده.آزادسازی()
کتاب.آزادسازی()
برگشت ۰
پایاناکسل هنگام باز کردن پرونده فرمولها را دوباره حساب میکند. برنامههایی که پرونده را بدون اکسل میخوانند، از جمله همین بسته، مقداری را میبینند که شما ذخیره کردهاید؛ پس همیشه نتیجهی درست را به آرگومان آخر تنظیم فرمول بدهید.
تاریخ، عددی با یک قالب
اکسل تاریخ را به شکل عدد سریال نگه میدارد: شمار روزها از ۳۰ دسامبر ۱۸۹۹ و ساعت روز به شکل بخش اعشاری. تنظیم تاریخ ثانیههای یونیکس را میگیرد و سریال متناظر را با قالب تاریخ ذخیره میکند، تبدیل زمان به سریال و تبدیل سریال به زمان در دو جهت تبدیل میکنند و سلولی که با تنظیم تاریخ نوشته شده با kind برابر سلول تاریخ خوانده میشود. چون سریالها شمار روز سادهاند، تفاضل دو تاریخ همان شمار روزهاست؛ فرمول B2-B1 همین را نگه میدارد.
واردسازی اکسل
واردسازی زمان
تابع نمایش(برچسب: رشته، لحظه: صحیح۶۴):
سرچاپ برچسب، زمان.سال جهانی(لحظه)، زمان.ماه جهانی(لحظه)، زمان.روز جهانی(لحظه)
پایان
تابع ریشه:
آغاز := ۱۷۷۴۰۰۸۰۰۰ برگردان صحیح۶۴
سررسید := ۱۷۷۵۱۳۱۲۰۰ برگردان صحیح۶۴
ناپایا کتاب := اکسل.کتاب کار جدید()
ناپایا برگه := کتاب.افزودن برگه("پروژه")
برگه.تنظیم رشته(۰، ۰، "آغاز")
برگه.تنظیم تاریخ(۰، ۱، آغاز)
برگه.تنظیم رشته(۱، ۰، "پایان")
برگه.تنظیم تاریخ(۱، ۱، سررسید)
برگه.تنظیم فرمول(۲، ۱، "B2-B1"، اکسل.تبدیل زمان به سریال(سررسید) - اکسل.تبدیل زمان به سریال(آغاز))
کتاب.ذخیره("plan.xlsx")
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا خوانده := اکسل.بازکردن("plan.xlsx"، خوب، خطا)
برگه خوانده := خوانده.برگه("پروژه")
سلول := برگه خوانده.دریافت سلول(۰، ۱)
سرچاپ "گونه تاریخ است:"، سلول.نوع برابر اکسل.سلول تاریخ
سرچاپ "عدد سریال:"، سلول.عدد
نمایش("آغاز:"، اکسل.تبدیل سریال به زمان(سلول.عدد))
نمایش("پایان:"، اکسل.تبدیل سریال به زمان(برگه خوانده.دریافت عدد(۱، ۱)))
سرچاپ "روزهای میان دو تاریخ:"، برگه خوانده.دریافت عدد(۲، ۱)
سرچاپ "سریال ۱۹۷۰-۰۱-۰۱:"، اکسل.تبدیل زمان به سریال(۰)
خوانده.آزادسازی()
کتاب.آزادسازی()
برگشت ۰
پایانبرنامه بخشهای هر تاریخ را با تابعهای جهانی (UTC) بستهی زمان چاپ میکند. دریافت رشته روی سلول تاریخ آن را در منطقهی زمانی محلی قالببندی میکند، پس نزدیک نیمهشب ممکن است روزی متفاوت با مقدار UTC نشان دهد. تاریخهای اکسل میلادیاند؛ اگر تاریخ شمسی لازم دارید، پس از خواندن آن را تبدیل کنید.
از کتاب کار به پروندههای CSV
بازکردن پروندههای xlsx، ods و csv را میخواند و خواننده را از روی پسوند پرونده انتخاب میکند، همان چیزی که تشخیص قالب به آن نگاه میکند؛ پس پروندهای با پسوند نادرست باز نمیشود. برگه به سیاسوی یک برگه را به متن CSV مینویسد و ویرگول و نقلقول را درست نشانهگذاری میکند، پس خروجی گرفتن از همهی برگههای یک کتاب کار حلقهی کوتاهی روی نام برگهها است. در جهت وارونه، سیاسوی به برگه متن CSV را به برگه تبدیل میکند.
واردسازی اکسل
واردسازی ورودی خروجی
تابع خروجی برگهها(مسیر: رشته): صحیح:
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا کتاب := اکسل.بازکردن(مسیر، خوب، خطا)
اگر خوب برابر نادرست:
سرچاپ "باز نشد"، مسیر، ":"، خطا
برگشت ۰
پایان
نامها := کتاب.نام برگهها()
هر ی، نام در نامها:
مقصد := نام + ".csv"
ورودی خروجی.نوشتن پرونده(مقصد، اکسل.برگه به سیاسوی(کتاب.برگهها.بگیر(ی)))
سرچاپ "نوشته شد"، مقصد
پایان
کتاب.آزادسازی()
برگشت نامها.طول()
پایان
تابع ریشه:
ناپایا کتاب := اکسل.کتاب کار جدید()
ناپایا کاربران := کتاب.افزودن برگه("users")
کاربران.تنظیم رشته(۰، ۰، "نام")
کاربران.تنظیم رشته(۰، ۱، "یادداشت")
کاربران.تنظیم رشته(۱، ۰، "علی")
کاربران.تنظیم رشته(۱، ۱، "چای دوست دارد, نه قهوه")
ناپایا انبار := کتاب.افزودن برگه("stock")
انبار.تنظیم رشته(۰، ۰، "کالا")
انبار.تنظیم رشته(۰، ۱، "تعداد")
انبار.تنظیم رشته(۱، ۰، "خودکار")
انبار.تنظیم عدد صحیح(۱، ۱، ۴۰)
اکسل.نوشتن اُدیاس(کتاب، "office.ods")
سرچاپ "قالب ods است:"، اکسل.تشخیص قالب("office.ods") برابر اکسل.قالب اُدیاس
سرچاپ "برگههای خروجی:"، خروجی برگهها("office.ods")
سرچاپ ورودی خروجی.خواندن پرونده("users.csv")
سرچاپ ورودی خروجی.خواندن پرونده("stock.csv")
سرچاپ "برگههای خروجی:"، خروجی برگهها("nothing.xlsx")
کتاب.آزادسازی()
برگشت ۰
پایانپیدا کردن مقدار با ارجاع یا با محتوا
آدمها از سلولها با نامی مثل C3 حرف میزنند و برنامهها با شمارهی سطر و ستون. تجزیه ارجاع سلول ارجاع را به شمارههای از صفر تبدیل میکند و برای چیزی که ارجاع نیست نادرست برمیگرداند، ارجاع سلول راه برگشت است و اندیس ستون و برچسب ستون همین کار را فقط برای ستون میکنند. برای جستجو با محتوا، پالایش سطرها سطرهایی را برمیگرداند که سلولشان در یک ستون متن معینی دارد و جستجو همهی سلولهایی را که آن متن را دارند.
واردسازی اکسل
تابع مقدار خانه(برگه: اکسل.برگه، ارجاع: رشته): رشته:
ناپایا سطر := ۰
ناپایا ستون := ۰
اگر اکسل.تجزیه ارجاع سلول(ارجاع، سطر، ستون) برابر نادرست: برگشت "ارجاع نادرست" پایان
اگر برگه.دارای سلول(سطر، ستون) برابر نادرست: برگشت "خالی" پایان
برگشت برگه.دریافت رشته(سطر، ستون)
پایان
تابع ریشه(): صحیح خطادار:
ناپایا برگه := تلاش اکسل.سیاسوی به برگه("سفارش,شهر,کالا\n101,تهران,خودکار\n102,تبریز,کتاب\n103,تهران,کتاب\n104,شیراز,خودکار\n"، "orders")
سرچاپ "C3 ="، مقدار خانه(برگه، "C3")، "| A9 ="، مقدار خانه(برگه، "A9")، "| 3C ="، مقدار خانه(برگه، "3C")
سطرها := برگه.پالایش سطرها(۱، "تهران")
هر س در سطرها:
سرچاپ "سفارش تهران"، برگه.دریافت رشته(س، ۰)، "کالا:"، برگه.دریافت رشته(س، ۲)
پایان
یافتهها := برگه.جستجو("کتاب")
سرچاپ "کتاب"، یافتهها.طول()، "بار آمده است"
شهر := اکسل.اندیس ستون("B")
سرچاپ "ستون B"، برگه.دریافت ستون(شهر).طول()، "سلول دارد و ستون آخر"، اکسل.برچسب ستون(برگه.شمار ستونها() - ۱)، "است"
برگه.آزادسازی()
برگشت ۰
پایانجستجو نتیجهها را به ترتیب مشخصی برنمیگرداند؛ اگر ترتیب مهم است مرتبشان کنید یا مثل اینجا فقط از شمارشان استفاده کنید.
گونهها
فراداده پرونده FileMeta
ساختار فراداده پرونده| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| مسیر | path | رشته = "" | مسیر. |
| قالب | format | صحیح = 0 | قالب. |
| وجود دارد | exists | منطقی = نادرست | پرونده وجود دارد. |
| اندازه | size | صحیح۶۴ = 0 | اندازه بر حسب بایت. |
| نام برگهها | sheet_names | وکتور<رشته> | نام برگهها. |
| سطرهای برگهها | sheet_rows | وکتور<صحیح> | تعداد سطرهای هر برگه. |
| ستونهای برگهها | sheet_cols | وکتور<صحیح> | تعداد ستونهای هر برگه. |
واردسازی اکسل
تابع ریشه:
ناپایا ک := اکسل.کتاب کار جدید()
ناپایا الف := ک.افزودن برگه("الف")
الف.تنظیم رشته(۰، ۰، "سلام")
الف.تنظیم عدد(۰، ۱، ۲.۵)
ناپایا ب := ک.افزودن برگه("ب")
ب.تنظیم عدد صحیح(۰، ۰، ۴۲)
سرچاپ ک.شمار برگهها()، ک.نام برگهها()، ک.اندیس برگه("ب")، ک.برگه در(۰).نام
سرچاپ ک.تغییر نام برگه(۱، "دوم")، ک.برگه("دوم").دریافت عدد(۰، ۰)
سرچاپ ک.تنظیم برگه فعال(۱)، ک.برگه فعال().نام، ک.شماره برگه فعال
سرچاپ اکسل.نوشتن ایکسالاسایکس(ک، "book.xlsx")، اکسل.نوشتن اُدیاس(ک، "book.ods")، ک.ذخیره("copy.xlsx")، اکسل.ذخیره(ک، "book.csv")
سرچاپ اکسل.تشخیص قالب("book.xlsx") == اکسل.قالب ایکسالاسایکس، اکسل.تشخیص قالب("book.ods") == اکسل.قالب اُدیاس، اکسل.تشخیص قالب("a.txt")، اکسل.قالب ایکسالاس، اکسل.قالب سیاسوی، اکسل.قالب نامشخص
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا خوانده := اکسل.بازکردن("book.xlsx"، خوب، خطا)
سرچاپ خوب، خوانده.نام برگهها()، خوانده.برگه("الف").دریافت رشته(۰، ۰)، خوانده.قالب == اکسل.قالب ایکسالاسایکس
ناپایا خ۲ := اکسل.خواندن ایکسالاسایکس("copy.xlsx"، خوب، خطا)
ناپایا خ۳ := اکسل.خواندن اُدیاس("book.ods"، خوب، خطا)
سرچاپ خوب، خ۳.برگه("دوم").دریافت عدد(۰، ۰)، خ۲.شمار برگهها()
ناپایا م := اکسل.بازرسی("book.xlsx"، خوب، خطا)
سرچاپ خوب، م.وجود دارد، م.اندازه > ۰، م.نام برگهها، م.سطرهای برگهها، م.ستونهای برگهها
م.آزادسازی()
ناپایا س := اکسل.خواندن کتاب کار سیاسوی("book.csv"، خوب، خطا)
سرچاپ خوب، س.برگه در(۰).دریافت رشته(۰، ۰)، اکسل.نوشتن کتاب کار سیاسوی(س، "again.csv")
_ := اکسل.بازکردن("نیست.xlsx"، خوب، خطا)
سرچاپ خوب، خطا != ""
_ := اکسل.خواندن ایکسالاس("نیست.xls"، خوب، خطا)
سرچاپ خوب، اکسل.ایکسالاس است(پوچ، ۰)
سرچاپ ک.حذف برگه با نام("الف")، ک.حذف برگه(۵)، ک.حذف برگه(۰)، ک.شمار برگهها()
ناپایا ت := اکسل.جدید()
سرچاپ ت.شمار برگهها()
ت.آزادسازی()
خوانده.آزادسازی()
خ۲.آزادسازی()
خ۳.آزادسازی()
س.آزادسازی()
ک.آزادسازی()
پایانآزادسازی Free
تابع آزادسازی()free
تابع free()نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
سلول Cell
ساختار سلول| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| سطر | row | صحیح = 0 | سطر، از صفر. |
| ستون | col | صحیح = 0 | ستون، از صفر. |
| نوع | kind | صحیح = 0 | نوع؛ یکی از ثابتهای سلول. |
| متن | text | رشته = "" | متن سلول رشتهای یا کد خطا. |
| عدد | num | اعشار۶۴ = 0 | عدد؛ برای تاریخ، شمارهی سریال اکسل. |
| منطقی | flag | منطقی = نادرست | مقدار منطقی. |
| فرمول | formula | رشته = "" | متن فرمول. |
| شماره سبک | style_id | صحیح = -1 | شمارهی سبک؛ -1 یعنی پیشفرض. |
واردسازی اکسل
تابع ریشه:
سرچاپ اکسل.برچسب ستون(۰)، اکسل.برچسب ستون(۲۵)، اکسل.برچسب ستون(۲۶)، اکسل.برچسب ستون(۷۰۳)
سرچاپ اکسل.اندیس ستون("A")، اکسل.اندیس ستون("AA")، اکسل.ارجاع سلول(۴، ۲)
ناپایا سطر := ۰
ناپایا ستون := ۰
سرچاپ اکسل.تجزیه ارجاع سلول("C5"، سطر، ستون)، سطر، ستون، اکسل.تجزیه ارجاع سلول("5C"، سطر، ستون)
سریال := اکسل.تبدیل زمان به سریال(۰)
سرچاپ سریال، اکسل.تبدیل سریال به زمان(۴۵۳۷۱.۰)
ر := اکسل.سلول رشتهای جدید(۰، ۰، "متن")
ع := اکسل.سلول عددی جدید(۰، ۱، ۳.۵)
م := اکسل.سلول منطقی جدید(۰، ۲، نادرست)
ت := اکسل.سلول تاریخ جدید(۰، ۳، ۰)
ف := اکسل.سلول فرمول جدید(۰، ۴، "A1*2"، ۷.۰)
سرچاپ ر.نوع == اکسل.سلول رشتهای، ع.عدد، م.منطقی، ت.نوع == اکسل.سلول تاریخ، ف.فرمول، ف.عدد
سرچاپ اکسل.سلول خالی، اکسل.سلول عددی، اکسل.سلول منطقی، اکسل.سلول فرمول
ناپایا سبکها := اکسل.جدول سبک جدید()
پررنگ := اکسل.سبک { پررنگ = درست، رنگ زمینه = "FFFF00"، چینش افقی = اکسل.میانچین }
شناسه := سبکها.دریافت با افزودن(پررنگ)
سرچاپ شناسه، سبکها.دریافت با افزودن(پررنگ) == شناسه، سبکها.شمار()، سبکها.دریافت(شناسه).پررنگ
سرچاپ پررنگ.یکسان است(سبکها.دریافت(شناسه))، پررنگ.نام قلم، پررنگ.اندازه قلم
سرچاپ اکسل.آرایش پیشفرض، اکسل.چپچین، اکسل.راستچین، اکسل.بالاچین، اکسل.میانچین عمودی، اکسل.پایینچین
سبکها.آزادسازی()
پایانموقعیت سلول CellPos
ساختار موقعیت سلول| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| سطر | row | صحیح = 0 | سطر. |
| ستون | col | صحیح = 0 | ستون. |
واردسازی اکسل
تابع ریشه:
ناپایا ب := اکسل.برگه جدید("فروش")
ب.تنظیم رشته(۰، ۰، "کالا")
ب.تنظیم رشته(۰، ۱، "تعداد")
ب.تنظیم سلول(۱، ۰، "چای")
ب.تنظیم عدد صحیح(۱، ۱، ۱۲)
ب.تنظیم سلول(۲، ۰، "قند")
ب.تنظیم عدد(۲، ۱، ۴.۵)
ب.تنظیم منطقی(۳، ۰، درست)
ب.تنظیم تاریخ(۳، ۱، ۱۷۱۰۹۴۳۵۰۹)
ب.تنظیم فرمول(۴، ۱، "SUM(B2:B3)"، ۱۶.۵)
ب.تنظیم خطا(۵، ۰، "#DIV/0!")
سرچاپ ب.نام، ب.شمار سطرها()، ب.شمار ستونها()
سرچاپ ب.دریافت رشته(۱، ۰)، ب.دریافت عدد(۱، ۱)، ب.دریافت عدد(۲، ۱)، ب.دریافت منطقی(۳، ۰)، ب.دریافت فرمول(۴، ۱)
س := ب.دریافت سلول(۵، ۰)
سرچاپ س.نوع == اکسل.سلول خطا، س.متن، ب.دریافت سلول(۳، ۱).نوع == اکسل.سلول تاریخ
سرچاپ ب.دارای سلول(۱، ۱)، ب.دارای سلول(۹، ۹)
ب.پاکسازی سلول(۵، ۰)
سرچاپ ب.دارای سلول(۵، ۰)
ناپایا سطر := وکتور {} برگردان وکتور<رشته>
سطر.بیفزا("نان")
سطر.بیفزا("7")
ب.تنظیم سطر(۶، سطر)
ب.تنظیم ستون(۳، سطر)
ناپایا جدول := وکتور {} برگردان وکتور<رشته>
هر م در ["a"، "b"، "c"، "d"]:
جدول.بیفزا(م)
پایان
ب.تنظیم جدول(۸، ۰، جدول، ۲)
سرچاپ ب.دریافت سطر(۶).طول()، ب.دریافت ستون(۳).طول()، ب.دریافت همه().طول()
سرچاپ ب.دریافت رشته(۹، ۱)
پیدا := ب.جستجو("نان")
سرچاپ پیدا.طول()، پیدا[۰].سطر، پیدا[۰].ستون
سرچاپ ب.پالایش سطرها(۰، "چای")
ب.ادغام سلولها(۰، ۰، ۰، ۱)
ناپایا یافت := نادرست
ب۲ := ب.بازه ادغامشده(۰، ۱، یافت)
سرچاپ ب.ادغامشده است(۰، ۱)، یافت، ب۲.سطر آغاز، ب۲.ستون انتها، ب.ادغامها.طول()
ب.تنظیم سبک(۱، ۱، ۲)
سرچاپ ب.دریافت سلول(۱، ۱).شماره سبک، ب.بیشترین سطر، ب.بیشترین ستون، ب.سلولها.اندازه() > ۰
ب.آزادسازی()
پایانبازه ادغام MergeRange
ساختار بازه ادغام| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| سطر آغاز | row1 | صحیح = 0 | سطر آغاز. |
| ستون آغاز | col1 | صحیح = 0 | ستون آغاز. |
| سطر انتها | row2 | صحیح = 0 | سطر پایان. |
| ستون انتها | col2 | صحیح = 0 | ستون پایان. |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
برگه Sheet
ساختار برگه| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| نام | name | رشته = "" | نام برگه. |
| سلولها | cells | نگاشت<رشته، سلول> | سلولها بر اساس ارجاعشان. |
| بیشترین سطر | max_row | صحیح = -1 | بزرگترین شمارهی سطر پر؛ -1 برای برگهی خالی. |
| بیشترین ستون | max_col | صحیح = -1 | بزرگترین شمارهی ستون پر. |
| ادغامها | merges | وکتور<بازه ادغام> | بازههای ادغامشده. |
| راستبهچپ | rtl | منطقی = نادرست | برگه را راست به چپ نشان میدهد، برای دادههای فارسی یا عربی. تنها در پروندههای xlsx نوشته میشود. |
| سطرهای ثابت | freeze_rows | صحیح = 0 | شمار سطرهای بالایی که هنگام پیمایش در دید میمانند؛ با ثابت کردن تنظیم میشود. تنها در پروندههای xlsx نوشته میشود. |
| ستونهای ثابت | freeze_cols | صحیح = 0 | شمار ستونهای نخست که هنگام پیمایش در دید میمانند. |
| پهنای ستونها | col_widths | وکتور<اعشار۶۴> | پهنای ستونها بر حسب نویسه، به ترتیب شمارهی ستون؛ ۰ پهنای پیشفرض را نگه میدارد. تنها در پروندههای xlsx نوشته میشوند. |
| فیلتر خودکار | auto_filter | رشته = "" | بازهای که دکمههای فیلتر دارد، مثل A1:F20؛ خالی یعنی بدون فیلتر. از پروندههای xlsx هم خوانده میشود. |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم رشته SetString
تابع تنظیم رشته(row: صحیح، col: صحیح، value: رشته)set_string
تابع set_string(row: صحیح، col: صحیح، value: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم سلول SetCell
تابع تنظیم سلول(row: صحیح، col: صحیح، value: رشته)set_cell
تابع set_cell(row: صحیح، col: صحیح، value: رشته)تنظیم رشته؛ مقدار به شکل رشته ذخیره میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم عدد SetNumber
تابع تنظیم عدد(row: صحیح، col: صحیح، value: اعشار۶۴)set_number
تابع set_number(row: صحیح، col: صحیح، value: اعشار۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم عدد صحیح SetInt
تابع تنظیم عدد صحیح(row: صحیح، col: صحیح، value: صحیح۶۴)set_int
تابع set_int(row: صحیح، col: صحیح، value: صحیح۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم منطقی SetBool
تابع تنظیم منطقی(row: صحیح، col: صحیح، value: منطقی)set_bool
تابع set_bool(row: صحیح، col: صحیح، value: منطقی)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم تاریخ SetDate
تابع تنظیم تاریخ(row: صحیح، col: صحیح، epoch: صحیح۶۴)set_date
تابع set_date(row: صحیح، col: صحیح، epoch: صحیح۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم فرمول SetFormula
تابع تنظیم فرمول(row: صحیح، col: صحیح، formula: رشته، cached: اعشار۶۴)set_formula
تابع set_formula(row: صحیح، col: صحیح، formula: رشته، cached: اعشار۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم خطا SetError
تابع تنظیم خطا(row: صحیح، col: صحیح، code: رشته)set_error
تابع set_error(row: صحیح، col: صحیح، code: رشته)#DIV/0!، میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم سبک SetStyle
تابع تنظیم سبک(row: صحیح، col: صحیح، style_id: صحیح)set_style
تابع set_style(row: صحیح، col: صحیح، style_id: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
پاکسازی سلول ClearCell
تابع پاکسازی سلول(row: صحیح، col: صحیح)clear_cell
تابع clear_cell(row: صحیح، col: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دارای سلول HasCell
تابع دارای سلول(row: صحیح، col: صحیح): منطقیhas_cell
تابع has_cell(row: صحیح، col: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت سلول GetCell
تابع دریافت سلول(row: صحیح، col: صحیح): سلولget_cell
تابع get_cell(row: صحیح، col: صحیح): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت رشته GetString
تابع دریافت رشته(row: صحیح، col: صحیح): رشتهget_string
تابع get_string(row: صحیح، col: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت عدد GetNumber
تابع دریافت عدد(row: صحیح، col: صحیح): اعشار۶۴دریافت منطقی GetBool
تابع دریافت منطقی(row: صحیح، col: صحیح): منطقیget_bool
تابع get_bool(row: صحیح، col: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت فرمول GetFormula
تابع دریافت فرمول(row: صحیح، col: صحیح): رشتهget_formula
تابع get_formula(row: صحیح، col: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
شمار سطرها RowCount
تابع شمار سطرها(): صحیحrow_count
تابع row_count(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
شمار ستونها ColCount
تابع شمار ستونها(): صحیحcol_count
تابع col_count(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم سطر SetRow
تابع تنظیم سطر(row: صحیح، values: وکتور<رشته>)set_row
تابع set_row(row: صحیح، values: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم ستون SetColumn
تابع تنظیم ستون(col: صحیح، values: وکتور<رشته>)set_column
تابع set_column(col: صحیح، values: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم جدول SetTable
تابع تنظیم جدول(start_row: صحیح، start_col: صحیح، flat: وکتور<رشته>، num_cols: صحیح)set_table
تابع set_table(start_row: صحیح، start_col: صحیح، flat: وکتور<رشته>، num_cols: صحیح)num_cols مقدار در هر سطر.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت سطر GetRow
تابع دریافت سطر(row: صحیح): وکتور<سلول>get_row
تابع get_row(row: صحیح): وکتور<سلول>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت ستون GetColumn
تابع دریافت ستون(col: صحیح): وکتور<سلول>get_column
تابع get_column(col: صحیح): وکتور<سلول>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
دریافت همه GetAll
تابع دریافت همه(): وکتور<سلول>get_all
تابع get_all(): وکتور<سلول>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
جستجو Find
تابع جستجو(value: رشته): وکتور<موقعیت سلول>find
تابع find(value: رشته): وکتور<موقعیت سلول>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
پالایش سطرها FilterRowsEquals
تابع پالایش سطرها(col: صحیح، value: رشته): وکتور<صحیح>filter_rows_equals
تابع filter_rows_equals(col: صحیح، value: رشته): وکتور<صحیح>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
ادغام سلولها MergeCells
تابع ادغام سلولها(row1: صحیح، col1: صحیح، row2: صحیح، col2: صحیح)merge_cells
تابع merge_cells(row1: صحیح، col1: صحیح، row2: صحیح، col2: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
ادغامشده است IsMerged
تابع ادغامشده است(row: صحیح، col: صحیح): منطقیis_merged
تابع is_merged(row: صحیح، col: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
بازه ادغامشده MergedRange
تابع بازه ادغامشده(row: صحیح، col: صحیح، found &: منطقی): بازه ادغامmerged_range
تابع merged_range(row: صحیح، col: صحیح، found &: منطقی): بازه ادغامنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
تنظیم پهنای ستون SetColumnWidth
تابع تنظیم پهنای ستون(col: صحیح، width: اعشار۶۴)set_column_width
تابع set_column_width(col: صحیح، width: اعشار۶۴)واردسازی اکسل
تابع ریشه:
ناپایا ک := اکسل.کتاب کار جدید()
ناپایا ب := ک.افزودن برگه("قیمتها")
ب.تنظیم رشته(۰، ۰، "کالا")
ب.تنظیم رشته(۰، ۱، "قیمت")
ب.تنظیم رشته(۱، ۰، "چای سبز، ۵۰۰ گرمی")
ب.تنظیم عدد(۱، ۱، ۴.۵)
ب.تنظیم رشته(۲، ۰، "شکر")
ب.تنظیم عدد(۲، ۱، ۱.۲۵)
ب.راستبهچپ = درست
ب.ثابت کردن(۱، ۱)
ب.تنظیم فیلتر خودکار(۰، ۰، ۲، ۱)
سرچاپ ب.راستبهچپ، ب.سطرهای ثابت، ب.ستونهای ثابت، ب.فیلتر خودکار
ب.پهنای خودکار()
سرچاپ ب.پهنای ستونها
ب.تنظیم پهنای ستون(۳، ۳۰.۰)
سرچاپ ب.پهنای ستونها.طول()، ب.پهنای ستونها[۲]، ب.پهنای ستونها[۳]
قابدار := اکسل.سبک { کادر = درست، شکستن خط = درست }
شناسه := ک.سبکها.دریافت با افزودن(قابدار)
ب.تنظیم سبک(۰، ۰، شناسه)
سرچاپ اکسل.نوشتن ایکسالاسایکس(ک، "prices.xlsx")
ناپایا خوب := نادرست
ناپایا خطا := ""
ناپایا خوانده := اکسل.بازکردن("prices.xlsx"، خوب، خطا)
اگر خوب:
برگشتی := خوانده.برگه("قیمتها")
سرچاپ خوب، برگشتی.فیلتر خودکار، خوانده.سبکها.دریافت(برگشتی.دریافت سلول(۰، ۰).شماره سبک).شکستن خط
وگرنه:
سرچاپ خوب، خطا
پایان
خوانده.آزادسازی()
ک.آزادسازی()
پایانپهنای خودکار AutoFit
تابع پهنای خودکار()auto_fit
تابع auto_fit()نمونهی این مورد همراه با موارد بالاتر آمده است: excel-View.salam
ثابت کردن Freeze
تابع ثابت کردن(rows: صحیح، cols: صحیح)freeze
تابع freeze(rows: صحیح، cols: صحیح)ثابت کردن(۱، ۰) سطر سرستون را ثابت میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-View.salam
تنظیم فیلتر خودکار SetAutoFilter
تابع تنظیم فیلتر خودکار(row1: صحیح، col1: صحیح، row2: صحیح، col2: صحیح)set_auto_filter
تابع set_auto_filter(row1: صحیح، col1: صحیح، row2: صحیح، col2: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: excel-View.salam
آزادسازی Free
تابع آزادسازی()free
تابع free()نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
سبک Style
ساختار سبک| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| پررنگ | bold | منطقی = نادرست | ضخیم. |
| کج | italic | منطقی = نادرست | کج. |
| زیرخط | underline | منطقی = نادرست | زیرخطدار. |
| نام قلم | font_name | رشته = "Calibri" | نام قلم. |
| اندازه قلم | font_size | صحیح = 11 | اندازهی قلم. |
| رنگ متن | font_color | رشته = "" | رنگ متن به شکل هگز، مثل FF0000. |
| رنگ زمینه | bg_color | رشته = "" | رنگ زمینه. |
| چینش افقی | align_h | صحیح = 0 | چینش افقی. |
| چینش عمودی | align_v | صحیح = 0 | چینش عمودی. |
| قالب عدد | num_format | رشته = "" | قالب نمایش عدد، مثل 0.00. |
| کادر | border | منطقی = نادرست | کادر نازک در هر چهار سو. |
| شکستن خط | wrap | منطقی = نادرست | متن بلند درون سلول به چند خط شکسته میشود و \n خط تازهای آغاز میکند. |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
یکسان است Equals
تابع یکسان است(other: سبک): منطقیequals
تابع equals(other: سبک): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
جدول سبکها StyleSheet
ساختار جدول سبکها| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| سبکها | styles | وکتور<سبک> | سبکها. |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
دریافت با افزودن GetOrAdd
تابع دریافت با افزودن(s: سبک): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
get_or_add
تابع get_or_add(s: سبک): صحیحدریافت Get
تابع دریافت(id: صحیح): سبکget
تابع get(id: صحیح): سبکنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
شمار Count
تابع شمار(): صحیحcount
تابع count(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
آزادسازی Free
تابع آزادسازی()آزادسازی free
تابع آزادسازی()نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
کتاب کار Workbook
ساختار کتاب کار| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| برگهها | sheets | وکتور<برگه> | برگهها به ترتیب. |
| سبکها | styles | جدول سبکها | سبکهای مشترک سلولها. |
| شماره برگه فعال | active_sheet | صحیح = 0 | شمارهی برگهی فعال. |
| مسیر منبع | source_path | رشته = "" | مسیر پروندهای که کتاب از آن خوانده شده. |
| قالب | format | صحیح = 0 | قالب پرونده؛ یکی از ثابتهای قالب. |
| آخرین خطا | last_error | رشته = "" | آخرین پیام خطا. |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
افزودن برگه AddSheet
تابع افزودن برگه(name: رشته): برگه*add_sheet
تابع add_sheet(name: رشته): برگه*نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
حذف برگه RemoveSheet
تابع حذف برگه(idx: صحیح): منطقیremove_sheet
تابع remove_sheet(idx: صحیح): منطقیidx را حذف میکند؛ اگر شماره نادرست باشد، نادرست.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
حذف برگه با نام RemoveSheetNamed
تابع حذف برگه با نام(name: رشته): منطقیremove_sheet_named
تابع remove_sheet_named(name: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
تغییر نام برگه RenameSheet
تابع تغییر نام برگه(idx: صحیح، new_name: رشته): منطقیrename_sheet
تابع rename_sheet(idx: صحیح، new_name: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
اندیس برگه SheetIndex
تابع اندیس برگه(name: رشته): صحیحsheet_index
تابع sheet_index(name: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
شمار برگهها SheetCount
تابع شمار برگهها(): صحیحsheet_count
تابع sheet_count(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
نام برگهها SheetNames
تابع نام برگهها(): وکتور<رشته>sheet_names
تابع sheet_names(): وکتور<رشته>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
برگه در SheetAt
تابع برگه در(idx: صحیح): برگه*sheet_at
تابع sheet_at(idx: صحیح): برگه*idx.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
برگه Sheet
تابع برگه(name: رشته): برگه*sheet
تابع sheet(name: رشته): برگه*نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
برگه فعال Active
تابع برگه فعال(): برگه*active
تابع active(): برگه*نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
تنظیم برگه فعال SetActive
تابع تنظیم برگه فعال(idx: صحیح): منطقیset_active
تابع set_active(idx: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
ذخیره Save
تابع ذخیره(path: رشته): منطقیsave
تابع save(path: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
آزادسازی Free
تابع آزادسازی()free
تابع free()نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
پایاها و متغیرها
نوع سلولها Cell…
kind هر سلول.| نام | انگلیسی | مقدار |
|---|---|---|
| سلول خالی | CellEmpty | 0 |
| سلول رشتهای | CellString | 1 |
| سلول عددی | CellNumber | 2 |
| سلول منطقی | CellBool | 3 |
| سلول تاریخ | CellDate | 4 |
| سلول فرمول | CellFormula | 5 |
| سلول خطا | CellError | 6 |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
قالبهای پرونده Format…
| نام | انگلیسی | مقدار |
|---|---|---|
| قالب نامشخص | FormatUnknown | 0 |
| قالب ایکسالاسایکس | FormatXLSX | 1 |
| قالب ایکسالاس | FormatXLS | 2 |
| قالب اُدیاس | FormatODS | 3 |
| قالب سیاسوی | FormatCSV | 4 |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
چینش Align…
align_h (چپ، وسط، راست) و align_v (بالا، وسط، پایین) سبک. صفر یعنی پیشفرض.| نام | انگلیسی | مقدار |
|---|---|---|
| آرایش پیشفرض | AlignDefault | 0 |
| چپچین | AlignLeft | 1 |
| میانچین | AlignCenter | 2 |
| راستچین | AlignRight | 3 |
| بالاچین | AlignTop | 1 |
| میانچین عمودی | AlignMiddle | 2 |
| پایینچین | AlignBottom | 3 |
نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
تابعها
برگه به سیاسوی SheetToCSV
تابع برگه به سیاسوی(sheet: برگه): رشتهواردسازی اکسل
تابع ریشه خطادار:
ناپایا ب := تلاش اکسل.سیاسوی به برگه("name,score\nعلی,17\n\"سارا, ع\",19.5\n"، "نمرهها")
سرچاپ ب.نام، ب.شمار سطرها()، ب.دریافت رشته(۲، ۰)، ب.دریافت عدد(۲، ۱)
سرچاپ اکسل.برگه به سیاسوی(ب)
سرچاپ اکسل.برگه به جیسون(ب)
ناپایا ج := اکسل.جیسون به برگه(`[["a", "b"], ["1", "x"], ["2", "y"]]`، "داده")
سرچاپ ج.شمار سطرها()، ج.شمار ستونها()، ج.دریافت رشته(۰، ۱)، ج.دریافت رشته(۲، ۰)
ک := "<row r=\"2\"><c r=\"A2\" t=\"s\"><v>0</v></c><br/></row>"
آغاز := اکسل.یافتن ایکسامال(ک، "c"، ۰)
سرچاپ آغاز، اکسل.ویژگی ایکسامال(ک، آغاز، "r")، اکسل.پایان برچسب ایکسامال(ک، آغاز)
سرچاپ اکسل.درون ایکسامال(ک، "v"، ۰)، اکسل.بستن خودکار ایکسامال(ک، اکسل.یافتن ایکسامال(ک، "br"، ۰))
سرچاپ اکسل.یافتن بستن ایکسامال(ک، "row"، ۱۰)
سرچاپ اکسل.اسکیپ ایکسامال("a<b&c")، اکسل.برگرداندن اسکیپ ایکسامال("a<b&c")
ب.آزادسازی()
ج.آزادسازی()
پایانسیاسوی به برگه CSVToSheet
تابع سیاسوی به برگه(text: رشته، sheet_name: رشته): Throws<برگه>نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
خواندن کتاب کار سیاسوی ReadCSVWorkbook
تابع خواندن کتاب کار سیاسوی(path: رشته، ok &: منطقی، err &: رشته): کتاب کارok نادرست است و err علت را دارد، برای CSV خراب با خط و ستون.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
نوشتن کتاب کار سیاسوی WriteCSVWorkbook
تابع نوشتن کتاب کار سیاسوی(book &: کتاب کار، path: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
خواندن ایکسالاسایکس ReadXLSX
تابع خواندن ایکسالاسایکس(path: رشته، ok &: منطقی، err &: رشته): کتاب کارنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
بازرسی Inspect
تابع بازرسی(path: رشته، ok &: منطقی، err &: رشته): فراداده پروندهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
سلول رشتهای جدید NewStringCell
تابع سلول رشتهای جدید(row: صحیح، col: صحیح، value: رشته): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
سلول عددی جدید NewNumberCell
تابع سلول عددی جدید(row: صحیح، col: صحیح، value: اعشار۶۴): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
سلول منطقی جدید NewBoolCell
تابع سلول منطقی جدید(row: صحیح، col: صحیح، value: منطقی): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
سلول تاریخ جدید NewDateCell
تابع سلول تاریخ جدید(row: صحیح، col: صحیح، epoch: صحیح۶۴): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
سلول فرمول جدید NewFormulaCell
تابع سلول فرمول جدید(row: صحیح، col: صحیح، formula: رشته، cached: اعشار۶۴): سلولنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
برچسب ستون ColumnLabel
تابع برچسب ستون(col: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
اندیس ستون ColumnIndex
تابع اندیس ستون(label: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
ارجاع سلول CellRef
تابع ارجاع سلول(row: صحیح، col: صحیح): رشتهC5، از سطر و ستون صفرپایه.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
تجزیه ارجاع سلول ParseCellRef
تابع تجزیه ارجاع سلول(ref: رشته، row_out &: صحیح، col_out &: صحیح): منطقیC5 را به سطر و ستون صفرپایه تبدیل میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
تبدیل زمان به سریال EpochToSerial
تابع تبدیل زمان به سریال(epoch: صحیح۶۴): اعشار۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
تبدیل سریال به زمان SerialToEpoch
تابع تبدیل سریال به زمان(serial: اعشار۶۴): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
ایکسالاس است IsXLS
تابع ایکسالاس است(p: تهی*، n: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
خواندن ایکسالاس ReadXLS
تابع خواندن ایکسالاس(path: رشته، ok &: منطقی، err &: رشته): کتاب کارok را نادرست میکند و err پیشنهاد میکند پرونده به xlsx یا ods تبدیل شود.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
برگه به جیسون SheetToJSON
تابع برگه به جیسون(sheet: برگه): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
جیسون به برگه JSONToSheet
تابع جیسون به برگه(text: رشته، sheet_name: رشته): برگهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
خواندن اُدیاس ReadODS
تابع خواندن اُدیاس(path: رشته، ok &: منطقی، err &: رشته): کتاب کارنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
برگه جدید NewSheet
تابع برگه جدید(name: رشته): برگهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam
get_number
تابع get_number(row: صحیح، col: صحیح): اعشار۶۴نوشتن اُدیاس WriteODS
تابع نوشتن اُدیاس(book &: کتاب کار، path: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
تشخیص قالب DetectFormat
تابع تشخیص قالب(path: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
جدید New
تابع جدید(): کتاب کارکتاب کار جدید.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
بازکردن Open
تابع بازکردن(path: رشته، ok &: منطقی، err &: رشته): کتاب کارok نادرست و err پیام خطاست.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
ذخیره Save
تابع ذخیره(book &: کتاب کار، path: رشته): منطقی.xlsx، .ods یا .csv (برای csv فقط برگهی فعال نوشته میشود). هر پسوند دیگری، از جمله .xls، نادرست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
جدول سبک جدید NewStyleSheet
تابع جدول سبک جدید(): جدول سبکهانمونهی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam
اسکیپ ایکسامال XmlEscape
تابع اسکیپ ایکسامال(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
برگرداندن اسکیپ ایکسامال XmlUnescape
تابع برگرداندن اسکیپ ایکسامال(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
یافتن ایکسامال XmlFind
تابع یافتن ایکسامال(xml: رشته، tag: رشته، from: صحیح): صحیحfrom به بعد.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
پایان برچسب ایکسامال XmlTagEnd
تابع پایان برچسب ایکسامال(xml: رشته، start: صحیح): صحیح> پایان برچسبی که از start شروع شده.نمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
بستن خودکار ایکسامال XmlSelfClosing
تابع بستن خودکار ایکسامال(xml: رشته، start: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
ویژگی ایکسامال XmlAttr
تابع ویژگی ایکسامال(xml: رشته، start: صحیح، attr: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
یافتن بستن ایکسامال XmlFindClose
تابع یافتن بستن ایکسامال(xml: رشته، tag: رشته، content_start: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
درون ایکسامال XmlInner
تابع درون ایکسامال(xml: رشته، tag: رشته، from: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam
کتاب کار جدید NewWorkbook
تابع کتاب کار جدید(): کتاب کارنمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam
نوشتن ایکسالاسایکس WriteXLSX
تابع نوشتن ایکسالاسایکس(book &: کتاب کار، path: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam