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

جیسون `encoding/json`

ساختن و خواندن جیسون: از رشته‌ی ساده تا تبدیل خودکار ساختارها و خواندن جریانی.

واردسازی کدگذاری.جیسون

در این صفحه

گونه‌ها
روال‌ها

برای کار با جیسون سه راه هست. برای کارهای ساده، روال‌هایی مثل عضو، شیء و دریافت مستقیم با متن جیسون کار می‌کنند. برای برنامه‌های واقعی، سریال سازی و واسریال سازی یک ساختار سلام را به جیسون و برعکس تبدیل می‌کنند. برای داده‌ای که شکلش را از پیش نمی‌دانید، کدگشایی یک مقدار پویا برمی‌گرداند.

نام کلید هر فیلد را با @json "name" بالای فیلد تعیین کنید؛ @json "-" فیلد را کنار می‌گذارد. بدون آن، نام خود فیلد کلید می‌شود.

گونه‌ها

گزینه‌های جیسون `JSONOptions`

ساختار گزینه‌های جیسون

گزینه‌های کدگذاری.

نام	انگلیسی	گونه	توضیح
indent	`indent`	`رشته = ""`	واحد تورفتگی؛ خالی یعنی یک خط.
sort_keys	`sort_keys`	`منطقی = نادرست`	کلیدها به ترتیب الفبا نوشته شوند. بدون آن، ترتیب کلیدها ثابت نیست.
ignore_null	`ignore_null`	`منطقی = نادرست`	کلیدهای با مقدار تهی نوشته نشوند.

encoding-json-Value.salam

واردسازی کدگذاری.جیسون
واردسازی کدگذاری.مقدار
واردسازی کدگذاری.خطای کدگذاری
واردسازی سیستم پرونده.پرونده

روال ریشه:
    ناپایا خ := خطای کدگذاری.بدون خطا()
    م := جیسون.کدگشایی(`{"city": "تهران", "zones": [1, 2, 22]}`، خ)
    سرچاپ خطای کدگذاری.خطا است(خ)، مقدار.به رشته(مقدار.مقدار کلید(م، "city"))
    سرچاپ جیسون.کدگذاری پیش فرض(م)
    گ := جیسون.گزینه‌های جیسون { indent = "  "، sort_keys = درست }
    سرچاپ جیسون.کدگذاری(م، گ)
    _ := جیسون.کدگشایی("[1, 2"، خ)
    سرچاپ خطای کدگذاری.خطا است(خ)، خ.position
    ناپایا ک := جیسون.کدگذار حافظه()
    ک.کدگذاری(مقدار.مقدار صحیح(۱))
    ک.کدگذاری(مقدار.مقدار رشته("دو"))
    سرچاپ ک.متن()
    ک.بستن()
    ناپایا ت := جیسون.کدگذار حافظه با تورفتگی("  ")
    ت.کدگذاری(م)
    سرچاپ ت.متن()
    ت.بستن()
    ن := پرونده.بازکردن("lines.ndjson"، "wb")
    ناپایا پن := جیسون.کدگذار جدید(ن)
    پن.کدگذاری(مقدار.مقدار صحیح(۱۰))
    پن.کدگذاری(مقدار.مقدار صحیح(۲۰))
    پن.بستن()
    ناپایا پت := جیسون.کدگذار جدید با تورفتگی(پرونده.بازکردن("pretty.json"، "wb")، "\t")
    پت.کدگذاری(م)
    پت.بستن()
    ناپایا خوان := جیسون.کدگشای جدید(پرونده.بازکردن("lines.ndjson"، "rb"))
    ناپایا جمع := ۰ برگردان صحیح۶۴
    تا خوان.باز هم():
        جمع += مقدار.به صحیح(خوان.کدگشایی())
    پایان
    سرچاپ جمع
    ناپایا گ۲ := جیسون.کدگشای رشته("{\"a\": 1}\n{\"a\": 2}\n")
    تا گ۲.باز هم():
        سرچاپ جیسون.کدگذاری پیش فرض(گ۲.کدگشایی())
    پایان
پایان

خروجیfalse تهران {"city": "تهران", "zones": [1, 2, 22]} { "city": "تهران", "zones": [ 1, 2, 22 ] } true 5 1 "دو" { "city": "تهران", "zones": [ 1, 2, 22 ] } 30 {"a": 1} {"a": 2}

کدگذار جیسون `JSONEncoder`

ساختار کدگذار جیسون

نویسنده‌ی جریانی: چند مقدار جیسون را پشت‌سرهم، هر کدام در یک خط، می‌نویسد.

نام	انگلیسی	گونه	توضیح
dst	`dst`	`پرونده*`	پرونده‌ی مقصد، اگر در پرونده می‌نویسد.
useFile	`useFile`	`منطقی = نادرست`	آیا در پرونده می‌نویسد یا در حافظه.
buf	`buf`	`رشته.StringBuilder`	حافظه‌ی متن، وقتی در حافظه می‌نویسد.
indent	`indent`	`رشته = ""`	واحد تورفتگی؛ خالی یعنی هر مقدار در یک خط.
count	`count`	`صحیح = 0`	تعداد مقدارهای نوشته‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

کدگذاری `Encode`

روال کدگذاری(v: value.Value): منطقی

یک مقدار را می‌نویسد و خط تازه‌ای پس از آن می‌گذارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

متن `String`

روال متن(): رشته

متن نوشته‌شده در حافظه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

بستن `Close`

روال بستن()

نویسنده را می‌بندد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

کدگشای جیسون `JSONDecoder`

ساختار کدگشای جیسون

خواننده‌ی جریانی: مقدارهای جیسون پشت‌سرهم را یکی‌یکی می‌خواند، مثل پرونده‌های JSON Lines.

نام	انگلیسی	گونه	توضیح
src	`src`	`پرونده*`	پرونده‌ی منبع.
useFile	`useFile`	`منطقی = نادرست`	آیا از پرونده می‌خواند.
buf	`buf`	`رشته = ""`	متن خوانده‌شده.
pos	`pos`	`صحیح = 0`	جای فعلی در متن.
loaded	`loaded`	`منطقی = نادرست`	آیا پرونده خوانده شده.
eof	`eof`	`منطقی = نادرست`	به انتهای متن رسیده.
bad	`bad`	`منطقی = نادرست`	خطایی در خواندن رخ داده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

باز هم `More`

روال باز هم(): منطقی

اگر مقدار دیگری مانده باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

کدگشایی `Decode`

روال کدگشایی(): value.Value

مقدار بعدی را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-json-Value.salam

روال‌ها

معتبر `Valid`

روال معتبر(text: رشته): منطقی

اگر متن جیسون درستی باشد، درست برمی‌گرداند.

encoding-json-Build.salam

واردسازی کدگذاری.جیسون

روال ریشه:
    ناپایا برچسب‌ها := وکتور {} برگردان وکتور<رشته>
    برچسب‌ها.بیفزا(جیسون.رشته جیسون("سلام"))
    برچسب‌ها.بیفزا(جیسون.رشته جیسون(`خط "نقل"`))
    ناپایا اعضا := وکتور {} برگردان وکتور<رشته>
    اعضا.بیفزا(جیسون.عضو("name"، "علی"))
    اعضا.بیفزا(جیسون.عضو عدد("age"، ۳۰))
    اعضا.بیفزا(جیسون.عضو منطقی("admin"، نادرست))
    اعضا.بیفزا(جیسون.عضو اعشار("score"، ۱۸.۵))
    اعضا.بیفزا(جیسون.عضو خام("tags"، جیسون.آرایه(برچسب‌ها)))
    متن := جیسون.شیء(اعضا)
    سرچاپ متن
    سرچاپ جیسون.معتبر(متن)، جیسون.معتبر("{ناقص")
    سرچاپ جیسون.دریافت(متن، "name")، جیسون.دریافت عدد(متن، "age")، جیسون.دریافت اعشار(متن، "score")
    سرچاپ جیسون.دارد(متن، "admin")، جیسون.دارد(متن، "email")، جیسون.کلیدها(متن)
    سرچاپ جیسون.اسکیپ("یک\tدو")
    زیبا := جیسون.تورفتگی(متن)
    سرچاپ زیبا
    سرچاپ جیسون.فشرده سازی(زیبا) == جیسون.فشرده سازی(متن)
    سرچاپ جیسون.تورفتگی چهار(`{"a":1}`)
    سرچاپ جیسون.تورفتگی تب(`{"a":1}`) == "{\n\t\"a\": 1\n}"، جیسون.تورفتگی سفارشی(`[1]`، "--")
پایان

خروجی{"name": "علی", "age": 30, "admin": false, "score": 18.5, "tags": ["سلام", "خط \"نقل\""]} true false علی 30 18.5 true false ["name", "age", "admin", "score", "tags"] یک\tدو { "name": "علی", "age": 30, "admin": false, "score": 18.5, "tags": [ "سلام", "خط \"نقل\"" ] } true { "a": 1 } true [ --1 ]