มีสิ่งที่ไม่เหมือนใครที่เราสามารถทำได้ด้วยฟังก์ชันที่เราไม่เคยเห็นมาก่อน และเรียกว่าสตริงเอกสาร
ให้ฉันแสดงให้คุณเห็นว่าฉันหมายถึงอะไร
ถ้าผมมีฟังก์ชันตรงนี้และเราจะเรียกมันว่าการทดสอบและทดสอบ สมมุติว่าได้รับพารามิเตอร์ที่เป็น
a และในที่นี้มันจะพิมพ์อะไร?
ไร้ประโยชน์
เปล่าประโยชน์โดยสิ้นเชิง
การทำงาน.
ทีนี้ ถ้าฉันวิ่งได้ดี จะไม่มีอะไรเกิดขึ้นเพราะฉันต้องเรียกการทดสอบแล้วพูดว่า เอาล่ะ เครื่องหมายอัศเจรีย์
และคุณเห็นว่าฟังก์ชันของเราใช้งานได้
แต่ที่จริงแล้วเราสามารถใช้ฟังก์ชันใน Python ได้โดยใช้สิ่งที่เรียกว่า doc strings และมีลักษณะดังนี้
คุณทำรหัสเดียว รหัสเดียว รหัสเดียว
สามคนนั้น
และที่ด้านล่างอีกครั้ง รหัสเดียว รหัสเดียว รหัสเดียว
ดังนั้นช่วงเริ่มต้นของฟังก์ชันแบบนี้ และในนี้ ผมสามารถเพิ่มข้อมูลเกี่ยวกับฟังก์ชันได้
ตัวอย่างเช่น ฟังก์ชันนี้จะทดสอบและพิมพ์
ต่อ น.
นี่คือส่วนที่น่าสนใจ
ถ้าฉันเรียกใช้การทดสอบที่นี่และฉันทำวงเล็บให้ดูที่
บรรณาธิการของฉันบอกฉันข้อมูล
ฟังก์ชันนี้จะทดสอบและพิมพ์ต่อหนึ่งซึ่งเรียกว่าสตริงเอกสาร
และสิ่งที่ทำให้เราทำได้คือแสดงความคิดเห็นภายในฟังก์ชันของเราจริง ๆ ว่าถ้าคนอื่นใช้ฟังก์ชันทดสอบ
เขาจะพูดได้จริง ๆ ว่าในอนาคตเมื่อเราเขียนโปรแกรมขนาดใหญ่ที่ไม่ใช่แค่
รหัสสิบบรรทัดหรือบางทีเราอาจมีไฟล์ต่างกันแทนที่จะค้นหาว่าการทดสอบทำอะไร
ขณะที่ฉันกำลังพิมพ์ มันจะบอกฉันว่า เฮ้ การทดสอบกำลังจะส่งคืนหรือพิมพ์ param a ดังนั้นฉันจึงหาข้อมูลเกี่ยวกับสิ่งนี้
และถ้าเราใช้บางอย่าง เช่น ความยาว และเรียกใช้สิ่งนี้ คุณจะเห็นว่า สิ่งนี้ให้ข้อมูลเกี่ยวกับฟังก์ชันโดยใช้สตริง
doc แต่มาพร้อมกับ Python
อีกวิธีในการดูสิ่งนี้
โปรดทราบว่าเมื่อเราพูดถึงสภาพแวดล้อมของผู้จ่ายเงินที่ลดลง บรรณาธิการของเราจะทำเช่นนี้โดยอัตโนมัติ
แต่มีวิธีอื่นอีกสองสามวิธีที่เราสามารถอ่านสิ่งนี้ได้จริง
ตัวอย่างเช่น ฉันสามารถทำหน้าที่ช่วยเหลือ ซึ่งเราไม่เคยเห็นมาก่อน ซึ่งมาพร้อมกับ Python ที่สร้างไว้ล่วงหน้า
และเราไม่ต้องการเรียกใช้ฟังก์ชัน
ฉันแค่ต้องการโทรหาความช่วยเหลือในการทดสอบหากฉันเรียกใช้สิ่งนี้
ดูนั่นสิ
ฉันได้รับข้อมูลการทดสอบ
ฟังก์ชันนี้จะทดสอบและพิมพ์พารามิเตอร์ต่างๆ เพื่อให้เราสามารถใช้ความช่วยเหลือเพื่อค้นหาว่าฟังก์ชันทำอะไรได้บ้าง
ซึ่งมีประโยชน์มากจริงๆ
อีกวิธีหนึ่งในการทำเช่นนี้คือการใช้สิ่งที่เราเรียกว่าวิธีมายากลหรือวิธีโง่เขลา ซึ่งเราจะพูดถึงอีกครั้งในหลักสูตรนี้
ฉันขีดเส้นใต้สองครั้งแล้ว
ครับผมหมอ
แล้วขีดเส้นใต้สองครั้งแบบนี้ถ้าฉันคลิกเรียกใช้
เราต้องพิมพ์อะไรตรงนี้ มาพิมพ์กัน
คลิกเรียกใช้และดูที่
ฉันได้รับสิ่งเดียวกัน
ดังนั้น dog string เหล่านี้จึงมีประโยชน์มากจริง ๆ ในการเพิ่มความคิดเห็นและคำจำกัดความให้กับฟังก์ชันของคุณ
ดังนั้นเมื่อคนอื่นในทีมของคุณ สมมติว่า ทีมงานหรือเพื่อนร่วมงานพบหน้าที่ของคุณที่คุณสร้างขึ้น
พวกเขาสามารถเข้าใจสิ่งที่มันทำได้ทันที โดยไม่ต้องค้นหาไฟล์หลามของคุณหรือหลายไฟล์
คุณลักษณะที่มีประโยชน์มาก