کتابخانه‌ی استاندارد · کدگذاری و داده

اکسل excel

خواندن و نوشتن صفحه‌گسترده‌های اکسل (xlsx و xls)، اوپن‌داکیومنت (ods) و CSV.

واردسازی اکسل

یک کتاب کار چند برگه دارد و هر برگه سلول‌هایی با سطر و ستون از صفر. ارجاع‌های اکسل مثل C5 را با ارجاع سلول و تجزیه ارجاع سلول به سطر و ستون تبدیل کنید.

بازکردن و ذخیره قالب را از پسوند پرونده می‌فهمند. فرمول‌ها با آخرین نتیجه‌ی حساب‌شده‌شان ذخیره و خوانده می‌شوند، ولی سلام خودش فرمول را حساب نمی‌کند.

گونه‌ها

سبک Style

ساختار سبک
سبک یک سلول.
نامانگلیسیگونهتوضیح
boldboldمنطقی = نادرستضخیم.
italicitalicمنطقی = نادرستکج.
underlineunderlineمنطقی = نادرستزیرخط‌دار.
font_namefont_nameرشته = "Calibri"نام قلم.
font_sizefont_sizeصحیح = 11اندازه‌ی قلم.
font_colorfont_colorرشته = ""رنگ متن به شکل هگز، مثل FF0000.
bg_colorbg_colorرشته = ""رنگ زمینه.
align_halign_hصحیح = 0چینش افقی.
align_valign_vصحیح = 0چینش عمودی.
num_formatnum_formatرشته = ""قالب نمایش عدد، مثل 0.00.
excel-Cell.salam
واردسازی اکسل

روال ریشه:
    سرچاپ اکسل.برچسب ستون(۰)، اکسل.برچسب ستون(۲۵)، اکسل.برچسب ستون(۲۶)، اکسل.برچسب ستون(۷۰۳)
    سرچاپ اکسل.اندیس ستون("A")، اکسل.اندیس ستون("AA")، اکسل.ارجاع سلول(۴، ۲)
    ناپایا سطر := ۰
    ناپایا ستون := ۰
    سرچاپ اکسل.تجزیه ارجاع سلول("C5"، سطر، ستون)، سطر، ستون، اکسل.تجزیه ارجاع سلول("5C"، سطر، ستون)
    سریال := اکسل.تبدیل زمان به سریال(۰)
    سرچاپ سریال، اکسل.تبدیل سریال به زمان(۴۵۳۷۱.۰)
    ر := اکسل.سلول رشته‌ای جدید(۰، ۰، "متن")
    ع := اکسل.سلول عددی جدید(۰، ۱، ۳.۵)
    م := اکسل.سلول منطقی جدید(۰، ۲، نادرست)
    ت := اکسل.سلول تاریخ جدید(۰، ۳، ۰)
    ف := اکسل.سلول فرمول جدید(۰، ۴، "A1*2"، ۷.۰)
    سرچاپ ر.kind == اکسل.سلول رشته‌ای، ع.num، م.flag، ت.kind == اکسل.سلول تاریخ، ف.formula، ف.num
    سرچاپ اکسل.سلول خالی، اکسل.سلول عددی، اکسل.سلول منطقی، اکسل.سلول فرمول
    ناپایا سبک‌ها := اکسل.جدول سبک جدید()
    پررنگ := اکسل.سبک { bold = درست، bg_color = "FFFF00"، align_h = اکسل.میان‌چین }
    شناسه := سبک‌ها.دریافت با افزودن(پررنگ)
    سرچاپ شناسه، سبک‌ها.دریافت با افزودن(پررنگ) == شناسه، سبک‌ها.شمار()، سبک‌ها.دریافت(شناسه).bold
    سرچاپ پررنگ.یکسان است(سبک‌ها.دریافت(شناسه))، پررنگ.font_name، پررنگ.font_size
    سرچاپ اکسل.آرایش پیش‌فرض، اکسل.چپ‌چین، اکسل.راست‌چین، اکسل.بالاچین، اکسل.میان‌چین عمودی، اکسل.پایین‌چین
    سبک‌ها.آزادسازی()
پایان
خروجیA Z AA AAB 0 26 C5 true 4 2 false 25569 1710892800 true 3.5 false true A1*2 7 0 2 3 5 1 true 2 true true Calibri 11 0 1 3 1 2 3

یکسان است equals

روال یکسان است(other: سبک): منطقی
اگر دو سبک یکسان باشند، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

جدول سبک‌ها StyleSheet

ساختار جدول سبک‌ها
جدول سبک‌های یکتا.
نامانگلیسیگونهتوضیح
stylesstylesوکتور<سبک>سبک‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

دریافت با افزودن get_or_add

روال دریافت با افزودن(s: سبک): صحیح
شماره‌ی سبک را برمی‌گرداند و اگر تازه باشد اضافه‌اش می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

دریافت get

روال دریافت(id: صحیح): سبک
سبک شماره‌ی داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

شمار count

روال شمار(): صحیح
تعداد سبک‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

آزادسازی free

روال آزادسازی()
حافظه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

سلول Cell

ساختار سلول
یک سلول.
نامانگلیسیگونهتوضیح
rowrowصحیح = 0سطر، از صفر.
colcolصحیح = 0ستون، از صفر.
kindkindصحیح = 0نوع؛ یکی از ثابت‌های سلول.
texttextرشته = ""متن سلول رشته‌ای یا کد خطا.
numnumاعشار۶۴ = 0عدد؛ برای تاریخ، شماره‌ی سریال اکسل.
flagflagمنطقی = نادرستمقدار منطقی.
formulaformulaرشته = ""متن فرمول.
style_idstyle_idصحیح = -1شماره‌ی سبک؛ ‎-1 یعنی پیش‌فرض.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

موقعیت سلول CellPos

ساختار موقعیت سلول
جای یک سلول.
نامانگلیسیگونهتوضیح
rowrowصحیح = 0سطر.
colcolصحیح = 0ستون.
excel-Sheet.salam
واردسازی اکسل

روال ریشه:
    ناپایا ب := اکسل.برگه جدید("فروش")
    ب.تنظیم رشته(۰، ۰، "کالا")
    ب.تنظیم رشته(۰، ۱، "تعداد")
    ب.تنظیم سلول(۱، ۰، "چای")
    ب.تنظیم عدد صحیح(۱، ۱، ۱۲)
    ب.تنظیم سلول(۲، ۰، "قند")
    ب.تنظیم عدد(۲، ۱، ۴.۵)
    ب.تنظیم منطقی(۳، ۰، درست)
    ب.تنظیم تاریخ(۳، ۱، ۱۷۱۰۹۴۳۵۰۹)
    ب.تنظیم فرمول(۴، ۱، "SUM(B2:B3)"، ۱۶.۵)
    ب.تنظیم خطا(۵، ۰، "#DIV/0!")
    سرچاپ ب.name، ب.شمار سطرها()، ب.شمار ستون‌ها()
    سرچاپ ب.دریافت رشته(۱، ۰)، ب.دریافت عدد(۱، ۱)، ب.دریافت عدد(۲، ۱)، ب.دریافت منطقی(۳، ۰)، ب.دریافت فرمول(۴، ۱)
    س := ب.دریافت سلول(۵، ۰)
    سرچاپ س.kind == اکسل.سلول خطا، س.text، ب.دریافت سلول(۳، ۱).kind == اکسل.سلول تاریخ
    سرچاپ ب.دارای سلول(۱، ۱)، ب.دارای سلول(۹، ۹)
    ب.پاک‌سازی سلول(۵، ۰)
    سرچاپ ب.دارای سلول(۵، ۰)
    ناپایا سطر := وکتور {} برگردان وکتور<رشته>
    سطر.بیفزا("نان")
    سطر.بیفزا("7")
    ب.تنظیم سطر(۶، سطر)
    ب.تنظیم ستون(۳، سطر)
    ناپایا جدول := وکتور {} برگردان وکتور<رشته>
    هر م در ["a"، "b"، "c"، "d"]:
        جدول.بیفزا(م)
    پایان
    ب.تنظیم جدول(۸، ۰، جدول، ۲)
    سرچاپ ب.دریافت سطر(۶).طول()، ب.دریافت ستون(۳).طول()، ب.دریافت همه().طول()
    سرچاپ ب.دریافت رشته(۹، ۱)
    پیدا := ب.جستجو("نان")
    سرچاپ پیدا.طول()، پیدا[۰].row، پیدا[۰].col
    سرچاپ ب.پالایش سطرها(۰، "چای")
    ب.ادغام سلول‌ها(۰، ۰، ۰، ۱)
    ناپایا یافت := نادرست
    ب۲ := ب.بازه ادغام‌شده(۰، ۱، یافت)
    سرچاپ ب.ادغام‌شده است(۰، ۱)، یافت، ب۲.row1، ب۲.col2، ب.merges.طول()
    ب.تنظیم سبک(۱، ۱، ۲)
    سرچاپ ب.دریافت سلول(۱، ۱).style_id، ب.max_row، ب.max_col، ب.cells.اندازه() > ۰
    ب.آزادسازی()
پایان
خروجیفروش 6 2 چای 12 4.5 true SUM(B2:B3) true #DIV/0! true true false false 4 10 40 d 2 0 3 [1] true true 0 1 1 2 9 3 true

بازه ادغام MergeRange

ساختار بازه ادغام
بازه‌ی ادغام‌شده.
نامانگلیسیگونهتوضیح
row1row1صحیح = 0سطر آغاز.
col1col1صحیح = 0ستون آغاز.
row2row2صحیح = 0سطر پایان.
col2col2صحیح = 0ستون پایان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

برگه Sheet

ساختار برگه
یک برگه: سلول‌ها با سطر و ستون از صفر.
نامانگلیسیگونهتوضیح
namenameرشته = ""نام برگه.
cellscellsنگاشت<رشته، سلول>سلول‌ها بر اساس ارجاعشان.
max_rowmax_rowصحیح = -1بزرگ‌ترین شماره‌ی سطر پر؛ ‎-1 برای برگه‌ی خالی.
max_colmax_colصحیح = -1بزرگ‌ترین شماره‌ی ستون پر.
mergesmergesوکتور<بازه ادغام>بازه‌های ادغام‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم رشته set_string

روال تنظیم رشته(row: صحیح، col: صحیح، value: رشته)
سلول را رشته می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم سلول set_cell

روال تنظیم سلول(row: صحیح، col: صحیح، value: رشته)
همان تنظیم رشته؛ مقدار به شکل رشته ذخیره می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم عدد set_number

روال تنظیم عدد(row: صحیح، col: صحیح، value: اعشار۶۴)
سلول را عدد اعشاری می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم عدد صحیح set_int

روال تنظیم عدد صحیح(row: صحیح، col: صحیح، value: صحیح۶۴)
سلول را عدد صحیح می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم منطقی set_bool

روال تنظیم منطقی(row: صحیح، col: صحیح، value: منطقی)
سلول را منطقی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم تاریخ set_date

روال تنظیم تاریخ(row: صحیح، col: صحیح، epoch: صحیح۶۴)
سلول را تاریخ می‌کند؛ لحظه بر حسب ثانیه از مبدأ یونیکس.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم فرمول set_formula

روال تنظیم فرمول(row: صحیح، col: صحیح، formula: رشته، cached: اعشار۶۴)
فرمول و آخرین نتیجه‌ی حساب‌شده‌اش را می‌گذارد؛ فرمول در سلام حساب نمی‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم خطا set_error

روال تنظیم خطا(row: صحیح، col: صحیح، code: رشته)
سلول را خطا با کد داده‌شده، مثل #DIV/0!، می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم سبک set_style

روال تنظیم سبک(row: صحیح، col: صحیح، style_id: صحیح)
شماره‌ی سبک سلول را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

پاک‌سازی سلول clear_cell

روال پاک‌سازی سلول(row: صحیح، col: صحیح)
سلول را خالی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دارای سلول has_cell

روال دارای سلول(row: صحیح، col: صحیح): منطقی
اگر سلول مقدار داشته باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت سلول get_cell

روال دریافت سلول(row: صحیح، col: صحیح): سلول
خود سلول؛ برای سلول خالی، سلولی از نوع خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت رشته get_string

روال دریافت رشته(row: صحیح، col: صحیح): رشته
مقدار رشته‌ای سلول.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت عدد get_number

روال دریافت عدد(row: صحیح، col: صحیح): اعشار۶۴
مقدار عددی سلول؛ برای سلول رشته‌ای صفر، حتی اگر متنش عدد باشد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت منطقی get_bool

روال دریافت منطقی(row: صحیح، col: صحیح): منطقی
مقدار منطقی سلول.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت فرمول get_formula

روال دریافت فرمول(row: صحیح، col: صحیح): رشته
متن فرمول سلول.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

شمار سطرها row_count

روال شمار سطرها(): صحیح
تعداد سطرها تا آخرین سطر پر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

شمار ستون‌ها col_count

روال شمار ستون‌ها(): صحیح
تعداد ستون‌ها تا آخرین ستون پر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم سطر set_row

روال تنظیم سطر(row: صحیح، values: وکتور<رشته>)
سطری را از چپ با مقدارها پر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم ستون set_column

روال تنظیم ستون(col: صحیح، values: وکتور<رشته>)
ستونی را از بالا پر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

تنظیم جدول set_table

روال تنظیم جدول(start_row: صحیح، start_col: صحیح، flat: وکتور<رشته>، num_cols: صحیح)
جدولی را از خانه‌ی آغاز پر می‌کند؛ مقدارها پشت‌سرهم، num_cols مقدار در هر سطر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت سطر get_row

روال دریافت سطر(row: صحیح): وکتور<سلول>
سلول‌های پر یک سطر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت ستون get_column

روال دریافت ستون(col: صحیح): وکتور<سلول>
سلول‌های پر یک ستون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

دریافت همه get_all

روال دریافت همه(): وکتور<سلول>
همه‌ی سلول‌های پر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

جستجو find

روال جستجو(value: رشته): وکتور<موقعیت سلول>
جای همه‌ی سلول‌هایی که متنشان برابر مقدار است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

پالایش سطرها filter_rows_equals

روال پالایش سطرها(col: صحیح، value: رشته): وکتور<صحیح>
شماره‌ی سطرهایی که مقدار ستون داده‌شده‌شان برابر است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

ادغام سلول‌ها merge_cells

روال ادغام سلول‌ها(row1: صحیح، col1: صحیح، row2: صحیح، col2: صحیح)
بازه‌ای از سلول‌ها را ادغام می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

ادغام‌شده است is_merged

روال ادغام‌شده است(row: صحیح، col: صحیح): منطقی
اگر سلول بخشی از بازه‌ی ادغام‌شده باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

بازه ادغام‌شده merged_range

روال بازه ادغام‌شده(row: صحیح، col: صحیح، found &: منطقی): بازه ادغام
بازه‌ی ادغامی که سلول در آن است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

آزادسازی free

روال آزادسازی()
حافظه‌ی برگه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.salam

کتاب کار Workbook

ساختار کتاب کار
کتاب کار: چند برگه، جدول سبک‌ها و قالب پرونده.
نامانگلیسیگونهتوضیح
sheetssheetsوکتور<برگه>برگه‌ها به ترتیب.
stylesstylesجدول سبک‌هاسبک‌های مشترک سلول‌ها.
active_sheetactive_sheetصحیح = 0شماره‌ی برگه‌ی فعال.
source_pathsource_pathرشته = ""مسیر پرونده‌ای که کتاب از آن خوانده شده.
formatformatصحیح = 0قالب پرونده؛ یکی از ثابت‌های قالب.
last_errorlast_errorرشته = ""آخرین پیام خطا.
excel-Workbook.salam
واردسازی اکسل

روال ریشه:
    ناپایا ک := اکسل.کتاب کار جدید()
    ناپایا الف := ک.افزودن برگه("الف")
    الف.تنظیم رشته(۰، ۰، "سلام")
    الف.تنظیم عدد(۰، ۱، ۲.۵)
    ناپایا ب := ک.افزودن برگه("ب")
    ب.تنظیم عدد صحیح(۰، ۰، ۴۲)
    سرچاپ ک.شمار برگه‌ها()، ک.نام برگه‌ها()، ک.اندیس برگه("ب")، ک.برگه در(۰).name
    سرچاپ ک.تغییر نام برگه(۱، "دوم")، ک.برگه("دوم").دریافت عدد(۰، ۰)
    سرچاپ ک.تنظیم برگه فعال(۱)، ک.برگه فعال().name، ک.active_sheet
    سرچاپ اکسل.نوشتن ایکس‌ال‌اس‌ایکس(ک، "book.xlsx")، اکسل.نوشتن اُدی‌اس(ک، "book.ods")، ک.ذخیره("copy.xlsx")، اکسل.ذخیره(ک، "book.csv")
    سرچاپ اکسل.تشخیص قالب("book.xlsx") == اکسل.قالب ایکس‌ال‌اس‌ایکس، اکسل.تشخیص قالب("book.ods") == اکسل.قالب اُدی‌اس، اکسل.تشخیص قالب("a.txt")، اکسل.قالب ایکس‌ال‌اس، اکسل.قالب سی‌اس‌وی، اکسل.قالب نامشخص
    ناپایا خوب := نادرست
    ناپایا خطا := ""
    ناپایا خوانده := اکسل.بازکردن("book.xlsx"، خوب، خطا)
    سرچاپ خوب، خوانده.نام برگه‌ها()، خوانده.برگه("الف").دریافت رشته(۰، ۰)، خوانده.format == اکسل.قالب ایکس‌ال‌اس‌ایکس
    ناپایا خ۲ := اکسل.خواندن ایکس‌ال‌اس‌ایکس("copy.xlsx"، خوب، خطا)
    ناپایا خ۳ := اکسل.خواندن اُدی‌اس("book.ods"، خوب، خطا)
    سرچاپ خوب، خ۳.برگه("دوم").دریافت عدد(۰، ۰)، خ۲.شمار برگه‌ها()
    ناپایا م := اکسل.بازرسی("book.xlsx"، خوب، خطا)
    سرچاپ خوب، م.exists، م.size > ۰، م.sheet_names، م.sheet_rows، م.sheet_cols
    م.آزادسازی()
    ناپایا س := اکسل.خواندن کتاب کار سی‌اس‌وی("book.csv"، خوب، خطا)
    سرچاپ خوب، س.برگه در(۰).دریافت رشته(۰، ۰)، اکسل.نوشتن کتاب کار سی‌اس‌وی(س، "again.csv")
    _ := اکسل.بازکردن("نیست.xlsx"، خوب، خطا)
    سرچاپ خوب، خطا != ""
    _ := اکسل.خواندن ایکس‌ال‌اس("نیست.xls"، خوب، خطا)
    سرچاپ خوب، اکسل.آیا ایکس‌ال‌اس است(پوچ، ۰)
    سرچاپ ک.حذف برگه با نام("الف")، ک.حذف برگه(۵)، ک.حذف برگه(۰)، ک.شمار برگه‌ها()
    ناپایا ت := اکسل.جدید()
    سرچاپ ت.شمار برگه‌ها()
    ت.آزادسازی()
    خوانده.آزادسازی()
    خ۲.آزادسازی()
    خ۳.آزادسازی()
    س.آزادسازی()
    ک.آزادسازی()
پایان
خروجی2 ["الف", "ب"] 1 الف true 42 true دوم 1 true true true true true true 0 2 4 0 true ["الف", "دوم"] سلام true true 42 2 true true true ["الف", "دوم"] [1, 1] [2, 1] true 42 true false true false false true false true 0 0

افزودن برگه add_sheet

روال افزودن برگه(name: رشته): برگه*
برگه‌ی تازه‌ای با نام داده‌شده اضافه می‌کند و آن را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

حذف برگه remove_sheet

روال حذف برگه(idx: صحیح): منطقی
برگه‌ی شماره‌ی idx را حذف می‌کند؛ اگر شماره نادرست باشد، نادرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

حذف برگه با نام remove_sheet_named

روال حذف برگه با نام(name: رشته): منطقی
برگه را با نامش حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

تغییر نام برگه rename_sheet

روال تغییر نام برگه(idx: صحیح، new_name: رشته): منطقی
نام برگه را عوض می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

اندیس برگه sheet_index

روال اندیس برگه(name: رشته): صحیح
شماره‌ی برگه با این نام؛ ‎-1 اگر نباشد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

شمار برگه‌ها sheet_count

روال شمار برگه‌ها(): صحیح
تعداد برگه‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

نام برگه‌ها sheet_names

روال نام برگه‌ها(): وکتور<رشته>
نام برگه‌ها به ترتیب.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

برگه در sheet_at

روال برگه در(idx: صحیح): برگه*
برگه‌ی شماره‌ی idx.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

برگه sheet

روال برگه(name: رشته): برگه*
برگه با نام داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

برگه فعال active

روال برگه فعال(): برگه*
برگه‌ی فعال.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

تنظیم برگه فعال set_active

روال تنظیم برگه فعال(idx: صحیح): منطقی
برگه‌ی فعال را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

ذخیره save

روال ذخیره(path: رشته): منطقی
کتاب را ذخیره می‌کند؛ قالب از پسوند مسیر معلوم می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

آزادسازی free

روال آزادسازی()
حافظه‌ی کتاب را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

فراداده پرونده FileMeta

ساختار فراداده پرونده
اطلاعات یک پرونده‌ی صفحه‌گسترده بدون خواندن کامل آن.
نامانگلیسیگونهتوضیح
pathpathرشته = ""مسیر.
formatformatصحیح = 0قالب.
existsexistsمنطقی = نادرستپرونده وجود دارد.
sizesizeصحیح۶۴ = 0اندازه بر حسب بایت.
sheet_namessheet_namesوکتور<رشته>نام برگه‌ها.
sheet_rowssheet_rowsوکتور<صحیح>تعداد سطرهای هر برگه.
sheet_colssheet_colsوکتور<صحیح>تعداد ستون‌های هر برگه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

آزادسازی free

روال آزادسازی()
حافظه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

پایاها و متغیرها

چینش Align…

مقدارهای align_h (چپ، وسط، راست) و align_v (بالا، وسط، پایین) سبک. صفر یعنی پیش‌فرض.
نامانگلیسیمقدار
آرایش پیش‌فرضAlignDefault0
چپ‌چینAlignLeft1
میان‌چینAlignCenter2
راست‌چینAlignRight3
بالاچینAlignTop1
میان‌چین عمودیAlignMiddle2
پایین‌چینAlignBottom3

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

نوع سلول‌ها Cell…

مقدار kind هر سلول.
نامانگلیسیمقدار
سلول خالیCellEmpty0
سلول رشته‌ایCellString1
سلول عددیCellNumber2
سلول منطقیCellBool3
سلول تاریخCellDate4
سلول فرمولCellFormula5
سلول خطاCellError6

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

قالب‌های پرونده Format…

قالب‌هایی که کتاب کار می‌خواند و می‌نویسد.
نامانگلیسیمقدار
قالب نامشخصFormatUnknown0
قالب ایکس‌ال‌اس‌ایکسFormatXLSX1
قالب ایکس‌ال‌اسFormatXLS2
قالب اُدی‌اسFormatODS3
قالب سی‌اس‌ویFormatCSV4

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

روال‌ها

نوشتن اُدی‌اس WriteODS

روال نوشتن اُدی‌اس(book &: کتاب کار، path: رشته): منطقی
کتاب را به شکل ods می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

جدول سبک جدید NewStyleSheet

روال جدول سبک جدید(): جدول سبک‌ها
جدول سبک خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Cell.salam

خواندن ایکس‌ال‌اس‌ایکس ReadXLSX

روال خواندن ایکس‌ال‌اس‌ایکس(path: رشته، ok &: منطقی، err &: رشته): کتاب کار
پرونده‌ی xlsx (اکسل ۲۰۰۷ به بعد) را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: صحیح): رشته
شماره‌ی ستون (از صفر) را به حرف ستون اکسل تبدیل می‌کند: صفر A، ۲۵ Z، ۲۶ AA.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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

خواندن اُدی‌اس ReadODS

روال خواندن اُدی‌اس(path: رشته، ok &: منطقی، err &: رشته): کتاب کار
پرونده‌ی ods (لیبره‌آفیس و اوپن‌آفیس) را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

برگه به سی‌اس‌وی SheetToCSV

روال برگه به سی‌اس‌وی(sheet: برگه): رشته
برگه را به متن CSV تبدیل می‌کند.
excel-Convert.salam
واردسازی اکسل

روال ریشه:
    ناپایا ب := اکسل.سی‌اس‌وی به برگه("name,score\nعلی,17\n\"سارا, ع\",19.5\n"، "نمره‌ها")
    سرچاپ ب.name، ب.شمار سطرها()، ب.دریافت رشته(۲، ۰)، ب.دریافت عدد(۲، ۱)
    سرچاپ اکسل.برگه به سی‌اس‌وی(ب)
    سرچاپ اکسل.برگه به جیسون(ب)
    ناپایا ج := اکسل.جیسون به برگه(`[["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&lt;b&amp;c")
    ب.آزادسازی()
    ج.آزادسازی()
پایان
خروجینمره‌ها 3 سارا, ع 0 name,score علی,17 "سارا, ع",19.5 [["name", "score"], ["علی", "17"], ["سارا, ع", "19.5"]] 3 2 b 2 11 A2 27 0 true 44 a&lt;b&amp;c a<b&c

سی‌اس‌وی به برگه CSVToSheet

روال سی‌اس‌وی به برگه(text: رشته، sheet_name: رشته): برگه
متن CSV را به برگه تبدیل می‌کند؛ همه‌ی سلول‌ها رشته‌اند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam

خواندن کتاب کار سی‌اس‌وی ReadCSVWorkbook

روال خواندن کتاب کار سی‌اس‌وی(path: رشته، ok &: منطقی، err &: رشته): کتاب کار
پرونده‌ی CSV را به کتابی با یک برگه تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

نوشتن کتاب کار سی‌اس‌وی WriteCSVWorkbook

روال نوشتن کتاب کار سی‌اس‌وی(book &: کتاب کار، path: رشته): منطقی
برگه‌ی فعال را به شکل CSV می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

تشخیص قالب DetectFormat

روال تشخیص قالب(path: رشته): صحیح
قالب پرونده را از پسوند یا محتوایش تشخیص می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

جدید New

روال جدید(): کتاب کار
کتاب کار خالی؛ همان کتاب کار جدید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

بازکردن Open

روال بازکردن(path: رشته، ok &: منطقی، err &: رشته): کتاب کار
پرونده را با توجه به قالبش (xlsx، xls، ods یا csv) باز می‌کند. در صورت شکست، ok نادرست و err پیام خطاست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

ذخیره Save

روال ذخیره(book &: کتاب کار، path: رشته): منطقی
کتاب را در قالبی که پسوند مسیر می‌گوید ذخیره می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

آیا ایکس‌ال‌اس است IsXLS

روال آیا ایکس‌ال‌اس است(p: تهی*، n: صحیح): منطقی
اگر بایت‌ها امضای پرونده‌ی xls داشته باشند، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

خواندن ایکس‌ال‌اس ReadXLS

روال خواندن ایکس‌ال‌اس(path: رشته، ok &: منطقی، err &: رشته): کتاب کار
پرونده‌ی xls قدیمی (اکسل ۹۷ تا ۲۰۰۳) را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

نوشتن ایکس‌ال‌اس‌ایکس WriteXLSX

روال نوشتن ایکس‌ال‌اس‌ایکس(book &: کتاب کار، path: رشته): منطقی
کتاب را به شکل xlsx می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

برگه جدید NewSheet

روال برگه جدید(name: رشته): برگه
برگه‌ی خالی تنها، بیرون از کتاب؛ برای تبدیل‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Sheet.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

برگه به جیسون SheetToJSON

روال برگه به جیسون(sheet: برگه): رشته
برگه را به آرایه‌ای از سطرها، هر سطر آرایه‌ای از رشته‌ها، تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam

جیسون به برگه JSONToSheet

روال جیسون به برگه(text: رشته، sheet_name: رشته): برگه
آرایه‌ای از آرایه‌های رشته را به برگه تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Convert.salam

کتاب کار جدید NewWorkbook

روال کتاب کار جدید(): کتاب کار
کتاب کار خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam

بازرسی Inspect

روال بازرسی(path: رشته، ok &: منطقی، err &: رشته): فراداده پرونده
قالب، برگه‌ها و اندازه‌ی هر برگه‌ی یک پرونده را می‌گوید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: excel-Workbook.salam