Example 8 — Make a Code Name (debugging) ตัวอย่างที่ 8 — สร้างชื่อรหัสจากชื่อกลับหลัง (debugging)

Read a name made of 1 to 10 English letters. If the name is empty, longer than 10 letters, or has anything else mixed in (spaces, digits, punctuation), warn the user and ask again. Once the name is valid, make a code name: write the name from its last letter to its first, with the first letter of the code name as a capital letter and every other letter small, then show Code name: <code name>.

รับชื่อที่เป็นตัวอักษรภาษาอังกฤษ 1 ถึง 10 ตัว ถ้าชื่อว่าง ยาวเกิน 10 ตัว หรือมีอย่างอื่นปน (ช่องว่าง ตัวเลข เครื่องหมาย) ให้แจ้งเตือนแล้วถามใหม่ เมื่อได้ชื่อที่ถูกต้องแล้ว ให้สร้างชื่อรหัส โดยเขียนชื่อจากตัวสุดท้ายไปตัวแรก ให้ตัวแรกของชื่อรหัสเป็นตัวพิมพ์ใหญ่และตัวที่เหลือเป็นตัวพิมพ์เล็กทั้งหมด แล้วแสดง Code name: <ชื่อรหัส>

• Example: Robert → Code name: Trebor
• is_name(text) — returns True only when text has 1 to 10 characters and every one of them is a letter
• read_backward(text) — returns text written from the last letter to the first
• name_case(text) — returns text with a capital first letter and small letters after it

• ตัวอย่าง: Robert → Code name: Trebor
• is_name(text) — คืนค่า True เฉพาะเมื่อ text มี 1 ถึง 10 ตัว และทุกตัวเป็นตัวอักษร
• read_backward(text) — คืนค่า text ที่เขียนจากตัวสุดท้ายไปตัวแรก
• name_case(text) — คืนค่า text ที่ตัวแรกเป็นตัวพิมพ์ใหญ่และตัวที่เหลือเป็นตัวพิมพ์เล็ก

The program starts a while True loop and reads a name into name. It checks whether the name is valid with the sub-function is_name: if it is, break leaves the loop; if not, it shows a warning with print and goes back to ask again. After leaving the loop it calls read_backward(name), passes the result to name_case, shows the code name with print, and the program ends.

โปรแกรมนี้เริ่มต้นด้วยวน loop while True แล้วรับชื่อเก็บใน name ตรวจสอบเงื่อนไขว่าชื่อถูกต้องหรือไม่ด้วย function ย่อย is_name ถ้าใช่ให้ break ออกจาก loop ถ้าไม่ใช่ให้แสดงข้อความเตือนด้วย print แล้วกลับไปรับค่าใหม่ หลังออกจาก loop จึงเรียก read_backward(name) แล้วส่งผลที่ได้ต่อให้ name_case แสดงชื่อรหัสด้วย print และจบการทำงานของโปรแกรม

Your name: Mary Ann
Use 1 to 10 letters (A-Z, a-z), please try again
Your name: Robert
Code name: Rtrebo

is_name starts by checking whether len(text) == 0 or len(text) > 10; if it is, it sends back False with return straight away. If not, it sets i = 0 as the character position and checks whether i < len(text); if it is, it checks whether text[i].isalpha(). If that character is not a letter, it sends back False with return straight away. If it is a letter, it increases i by 1 and checks again. This repeats until i < len(text) is false, so every character was a letter and it sends back True with return.

is_name เริ่มต้นด้วยตรวจสอบเงื่อนไขว่า len(text) == 0 or len(text) > 10 หรือไม่ ถ้าใช่ให้ส่งค่า False กลับด้วย return ทันที ถ้าไม่ใช่ให้กำหนดค่า i = 0 เป็นตัวชี้ตำแหน่งตัวอักษร แล้วตรวจสอบเงื่อนไขว่า i < len(text) หรือไม่ ถ้าใช่ให้ตรวจสอบว่า text[i].isalpha() หรือไม่ ถ้าตัวนั้นไม่ใช่ตัวอักษรให้ส่งค่า False กลับด้วย return ทันที ถ้าเป็นตัวอักษรให้เพิ่ม i ขึ้น 1 แล้วกลับไปตรวจสอบอีกครั้ง ทำแบบนี้จน i < len(text) เป็นเท็จ แสดงว่าทุกตัวเป็นตัวอักษร จึงส่งค่า True กลับด้วย return

Test the function on its own before using it in the main program. Decide which kind of test case each value is.

ทดสอบฟังก์ชันนี้แยกเดี่ยวๆ ก่อนนำไปใช้ในโปรแกรมหลัก แล้วจัดว่าแต่ละค่าเป็น test case ชนิดไหน

True
False
False
True
False
False

read_backward starts by setting backward = '' to hold the result and i = 0 as the letter position. It checks whether i < len(text); if it is, it adds the letter text[-i] to the end of backward, increases i by 1 and checks again. This repeats until the condition is false, so it sends backward back with return.

read_backward เริ่มต้นด้วยกำหนดค่า backward = '' สำหรับเก็บผลลัพธ์ และ i = 0 เป็นตัวชี้ตำแหน่งตัวอักษร แล้วตรวจสอบเงื่อนไขว่า i < len(text) หรือไม่ ถ้าใช่ให้ต่อตัวอักษร text[-i] เข้าท้าย backward เพิ่ม i ขึ้น 1 แล้วกลับไปตรวจสอบอีกครั้ง ทำแบบนี้จนเงื่อนไขเป็นเท็จ จึงส่งค่า backward กลับด้วย return

name_case starts by setting result = '' to hold the result and i = 0 as the letter position. It checks whether i < len(text); if it is, it checks whether i == 0. If it is the first letter, it adds text[i].upper() to the end of result; if not, it adds text[i].lower(). Either way it increases i by 1 and checks i < len(text) again. This repeats until the condition is false, so it sends result back with return.

name_case เริ่มต้นด้วยกำหนดค่า result = '' สำหรับเก็บผลลัพธ์ และ i = 0 เป็นตัวชี้ตำแหน่งตัวอักษร แล้วตรวจสอบเงื่อนไขว่า i < len(text) หรือไม่ ถ้าใช่ให้ตรวจสอบว่า i == 0 หรือไม่ ถ้าเป็นตัวแรกให้ต่อ text[i].upper() เข้าท้าย result ถ้าไม่ใช่ให้ต่อ text[i].lower() ไม่ว่าทางใดทางหนึ่ง หลังจากนั้นเพิ่ม i ขึ้น 1 แล้วกลับไปตรวจสอบ i < len(text) อีกครั้ง ทำแบบนี้จนเงื่อนไขเป็นเท็จ จึงส่งค่า result กลับด้วย return

Submit the values in order with the form in card 2, or put them one per line in the [input] box, then compare with the expected output column. Every run ends with a line Code name: …; the table shows only the part after it. The last column shows what the code with the bug gives.

ส่งค่าตามลำดับด้วยช่องในการ์ดที่ 2 หรือใส่ไว้บรรทัดละค่าในกล่อง [input] แล้วเทียบกับคอลัมน์ผลที่ควรได้ ทุกครั้งที่รันจบจะได้บรรทัด Code name: … ตารางแสดงเฉพาะส่วนหลัง Code name: ส่วนคอลัมน์สุดท้ายคือผลจากโค้ดที่ยังมี bug

1. Check the code of all three functions and the main program against their flowcharts, and note anything that looks suspicious.
2. Run every input in the test list and note whether the actual output matches the expected output.
3. The name check (warn, then ask again) works, but the code name is wrong. Compare Rtrebo with Trebor: which letter is in the wrong place? And why does j give the right answer even though the program has a bug?
4. Which kind of error is this bug, and why?
5. Find the wrong line:
   • change the last line to print(read_backward(name)) for a moment, to see whether the letters are already in the wrong order before name_case runs, or
   • add print(i, -i, text[-i], backward) inside the loop of read_backward,
   then fill in the trace table below for text = 'Leo'.
6. Fix the code in the box and run the test list again. Every input must give its expected output.
7. Think further: why is testing with j alone not enough?

1. ตรวจโค้ดทั้ง 3 ฟังก์ชันและส่วนหลักเทียบกับ flowchart แล้วจดจุดที่สงสัย
2. รันทุกข้อในรายการทดสอบ แล้วจดผลที่ได้จริงว่าตรงกับผลที่ควรได้หรือไม่
3. ส่วนตรวจชื่อ (เตือนแล้วถามใหม่) ทำงานถูก แต่ชื่อรหัสผิด ลองเทียบ Rtrebo กับ Trebor ตัวอักษรตัวไหนอยู่ผิดที่ และทำไม j ได้ผลถูกทั้งที่โปรแกรมมี bug
4. bug นี้เป็น error ชนิดไหน เพราะอะไร
5. หาบรรทัดที่ผิด
   • เปลี่ยนบรรทัดสุดท้ายเป็น print(read_backward(name)) ชั่วคราว เพื่อดูว่าตัวอักษรเรียงผิดตั้งแต่ก่อนเข้า name_case หรือไม่ หรือ
   • ใส่ print(i, -i, text[-i], backward) ใน loop ของ read_backward
   แล้วกรอก trace table ด้านล่าง เมื่อ text = 'Leo'
6. แก้โค้ดในกล่อง แล้วรันรายการทดสอบซ้ำ ทุกข้อต้องได้ผลตามที่ควรได้
7. ชวนคิดต่อ: ทำไมทดสอบด้วย j อย่างเดียวจึงไม่พอ