مقدّر طول خيط الحياكة

أدخلوا stitch_count وgauge وyarn_per_stitch بوحدة طول متسقة لرقم الاستهلاك؛ يضرب المحرك عدد الغرز في الخيط لكل غرزة ليحصل على الطول الخام، ويضرب المقياس في الخيط لكل غرزة ليُبلغ عن خيط صفّ عرضه وحدة واحدة، ويقسم العدد على المقياس ليبين كم عرضًا وحدويًا يمثّله مجموع الغرز. يوسّع waste_percent الاختياري الطول الخام لأطراف الخيط والدرزات من دون اختراع عامل خفي. يضيف row_gauge الاختياري المساحة الضمنية للقماش، ويحوّل skein_length الاختياري رقم الشراء إلى لفّات كاملة. تُرفض أعداد الغرز أو المقاييس أو الاستهلاكات الصفرية أو السالبة برمز invalid_input، لأن عددًا أو كثافة غير موجبين لا يصفان مشروعًا قابلاً للحياكة. المسار حسابيات حتمية خالصة بلا شبكة ولا بذور عشوائية ولا اعتماد على الساعة، فيعيد المنفّذ المجاني في المتصفح وواجهة API المدفوعة مسبقًا ملف JSON نفسه بعد التقريب العشري الثابت. تكلّف استدعاءات API الناجحة $0.002 لكل طلب.

ماذا يعني طول خيط الحياكة انطلاقًا من عدد الغرز

يقدّر الحاكون الخيط بطرق عدّة، وهذه الصفحة هي المسار الذي يبدأ من مجموع غرز لا من العرض والارتفاع النهائيين. قد ينشر نمط عدد غرز للجسم والأكمام وشريط العنق؛ وقد يُظهر عدّاد رقمي كم غرزة عملتم أصلًا؛ أو تجمعون غرز كل تكرار في المخطط بأنفسكم. المقياس ليس زينة. متى عرفتم أيضًا كم تستهلك الغرزة الواحدة من الخيط عند المقياس الذي ستحيكون به فعلًا، يكون الطول الخام حاصل ضرب: yarn_length يساوي stitch_count في yarn_per_stitch. إنّه كثافة غرز القماش الذي أنتج رقم الاستهلاك ذلك، ويستعمله المحرك للإبلاغ عن yarn_per_unit_width (gauge في yarn_per_stitch) حتى تتمكنوا من مقابلة صفّ عرضه وحدة بصفّ مقيس، وعن stitch_widths (stitch_count مقسومًا على gauge) لتروا كم عرضًا وحدويًا يمثّله المجموع إن رُصّ كصفّ واحد. ثم يوسّع waste_percent الاختياري yarn_length إلى yarn_with_waste لأطراف الخيط والدرزات وانزياح بسيط في المقياس؛ والقيمة الافتراضية صفر حتى لا تحشو الأداة قائمة التسوق في صمت. يفتح row_gauge الاختياري implied_area بوصفه stitch_count مقسومًا على gauge في row_gauge، وyarn_per_unit_area بوصفه حاصل الاستهلاك والكثافتين. يحوّل skein_length الاختياري yarn_with_waste إلى كمية شراء بلفّات كاملة مع سقف. لا توجد قاعدة علامات تجارية ولا جدول يسر مخفي ولا عامل هدر عشوائي: إما يضرب المحرك ويقسم الموجبات المنتهية التي أرسلتموها أو يرفض الإدخال برمز invalid_input. هذا ليس مقدّر كروشيه من الأبعاد، ولا مخطِّطًا للبدء، ولا حاسبة استبدال لفّات؛ فتلك نوايا بحث مختلفة بحقول إلزامية مختلفة.

كيف تُستدعى واجهة API وما الذي يعود

تظهر حقول الصف واللفّة فقط عندما أرسلتم تلك الاختياريات؛ والمفاتيح المحذوفة تُحذف ولا تكون null أبدًا. أرسلوا جسم JSON بثلاثة أعداد موجبة منتهية إلزامية: stitch_count (أسماء بديلة stitches وtotal_stitches وsts وstitchCount وproject_stitches)، وgauge (أسماء بديلة stitch_gauge وsts_per وspi وstitches_per_unit وgauge_stitches)، وyarn_per_stitch (أسماء بديلة consumption وyardage_per_stitch وyps وlength_per_stitch وyarnPerStitch). يجب أن تبقى القيم المطلقة ضمن الحد المنشور وهو تريليون واحد حتى تظل النواتج الوسيطة منتهية بدقة IEEE المزدوجة على Worker وفي المتصفح. يجب أن يكون كل حقل إلزامي موجبًا تمامًا؛ وتُعامل القيم التي تساوي أو تقل عن واحد في عشرة أس سالب خمسة عشر على أنها غير موجبة فتُرفض، وهذا يغطي أخطاء القياس الصفرية والسالبة المطلوبة وكذلك الأعداد الفارغة. waste_percent الاختياري (أسماء بديلة waste وease_percent وextra_percent) عدد من صفر إلى مئة وقيمته الافتراضية صفر. يجب أن يكون row_gauge الاختياري (أسماء بديلة rows_per وrpi وgauge_rows وrows_per_unit) موجبًا تمامًا إن وُجد. يجب أن يكون skein_length الاختياري (أسماء بديلة hank_length وball_length وyards_per_skein وmetres_per_skein) موجبًا تمامًا إن وُجد. يختار precision الاختياري (أسماء بديلة decimals وdp) كم منزلة عشرية تُعرض، وعشرة افتراضيًا وخمسة عشر حدًّا أعلى حتى تبقى أمثلة JSON الذهبية مستقرة بين التشغيلات. عند النجاح تعيد الاستجابة المدخلات المقرَّبة، وتضع yarn_length وyarn_with_waste، وتضيف yarn_per_unit_width وstitch_widths، وتجعل method مساويًا لـ knit_stitch_count_yardage، وتضمّن formula وmessage ومصفوفة steps مرتبة. يعيد التحقق الفاشل invalid_input ولا تُحتسب عليه رسوم. التسعير مبلغ ثابت $0.002 لكل طلب ناجح بوحدة item.

قياس الاستهلاك والوحدات وكيف يختلف هذا عن الأدوات المجاورة

قيسوا yarn_per_stitch من عيّنة محاكة ومغسولة ومشدودة كما سيُعامل الثوب، وبالمقياس نفسه الذي ستستخدمونه في المشروع. احتفظوا بوحدة الطول تلك لـ yarn_length وyarn_with_waste؛ واحتفظوا بـ gauge غرزًا لكل وحدة العرض نفسها التي بها تراجعون صفًّا (إنشات أو سنتيمترات). عند التعليم اقرنوا الأمثلة: ثمانية وعشرون ألف غرزة بخمس غرز لكل وحدة مع جزء من مئة وخمسة أجزاء من ألف من وحدة خيط لكل غرزة تعطي سبع مئة وحدة خيط خام؛ والقطعة نفسها بعشرة في المئة هدر تعطي سبع مئة وسبعين؛ وstitch_count المساوي صفرًا يبيّن مسار invalid_input الصارم عند عدد غير موجب. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المدفوع مسبقًا، فيبقى استكشاف النصوص رخيصًا حين يضع المتعلّمون stitch_count على صفر عمدًا. فحوصات الذهاب والإياب يسيرة: أعيدوا حساب stitch_count في yarn_per_stitch يدويًا وتأكدوا أنه يساوي yarn_length بالتقريب نفسه، وتأكدوا أن gauge في yarn_per_stitch يساوي yarn_per_unit_width.