วิธีใช้ documentation ของ Python3

แชร์ความรู้ภาษา Python ไพทอน การเขียนโปรแกรมภาษาไพทอน

Moderator: mindphp, ผู้ดูแลกระดาน

annie2301
PHP Super Member
PHP Super Member
โพสต์: 289
ลงทะเบียนเมื่อ: 01/12/2021 9:44 am

วิธีใช้ documentation ของ Python3

โพสต์ที่ยังไม่ได้อ่าน โดย annie2301 »

ในปกติที่เราทำงานเขียนโค้ดกัน เวลาจะหามีฟังก์ชั่น เราจะ search ใน google search หรือ search engine อะไรก็ตาม ประมาณว่า "sort list python3" (ชื่อฟังก์ชั่น, ใช้กับdata type ไหน, python version) ถ้าเราไม่รู้จัก documentation เราก็อาจจะหาว่ามีฟังก์ชั่นอะไรใช้งานบ้าง ได้ยากหรืออาจจะทำไม่ได้เลย ในบทความนี้ก็จะมาแนะนำวิธีการใช้ documentation ของ Python3 ที่เป็น library พื้นฐาน



วิธีเข้าถึง documentation

เข้าที่เว็บ https://docs.python.org/3/library/index.html หรือจะ search เองก็ได้
ถ้า search เอง วิธีค้นหาตามนี้เลย
  • พิมพ์คำค้นหาว่า "documentation python3"
  • เลือก documentation(ลิงก์เว็บจะประมาณ docs.python.org)
  • แล้ว ให้เลือก Standard Library
    รูปตัวอย่างการเข้าถึงdocucmentationพื้นฐานของ python3
    รูปตัวอย่างการเข้าถึงdocucmentationพื้นฐานของ python3
    access_to_python3_documentation.png (21.89 KiB) Viewed 1154 times


วิธีการใช้งาน documentation ของ Python
  • การตั้งค่าภาษา และ เวอร์ชั่นของ python (ในตัวอย่างเลือก English, version 3.10.0) ไม่มีภาษาไทยนะ
    รูปตัวอย่างการตั้งค่าภาษาและเวอร์ชั่น
    รูปตัวอย่างการตั้งค่าภาษาและเวอร์ชั่น
    select_language_version.png (2.83 KiB) Viewed 1154 times
  • เลือก function ว่าเป็นของ datatype ไหน (ในตัวอย่างจะเป็น Dictionary)
    รูปตัวอย่างการเลือกฟังก์ชั่นของ data type
    รูปตัวอย่างการเลือกฟังก์ชั่นของ data type
    select_dict_doc.png (30.12 KiB) Viewed 1154 times
    รูปตัวอย่างหลังจากคลิ๊กเลือกฟังก์ชั่นของ data type
    รูปตัวอย่างหลังจากคลิ๊กเลือกฟังก์ชั่นของ data type
    mapping_type.png (191.9 KiB) Viewed 1154 times
  • เลื่อนหน้าเว็บลงไปที่มีข้อความว่า These are the operations that dictionaries support
    รูปตัวอย่าง operations ของ dictionary
    รูปตัวอย่าง operations ของ dictionary
    operations_of_dict.png (37.97 KiB) Viewed 1154 times
    operations ของ dictionary มีมากกว่านี้ แต่อันนี้ แคปมาให้ดูคร่าวๆ
ใน documentation ลักษณะของฟังก์ชั่นจะบอกประมาณว่า
function_name(parameter)
ฟังก์ชั่นนี้ทำอะไร
รูปตัวอย่างฟังก์ชั่น
รูปตัวอย่างฟังก์ชั่น
example_functions.png (41.5 KiB) Viewed 1154 times
ชื่อฟังก์ชั่นจะเป็นตัวพิมพ์หนา ภายในวงเล็บจะเป็นพารามิเตอร์
บรรทัดต่อมาจะบอกว่าฟังก์ชั่นนี้ทำอะไรได้, รายละเอียดของพารามิเตอร์มีอะไรบ้าง หรือ return อะไรสักอย่าง



จากในบทความเราจะเห็นว่าวิธีใช้ documentation ของ python มันก็ใช้ไม่ได้ยาก แต่อาจจะต้องปรับตัวบ้างในช่วงแรกๆ
มันรวมคำอธิบายต่างๆ ของแต่ละ class และ แต่ละ operations ของแต่ละ class ไว้
มันเอาไว้บอกเราคร่าวๆ ได้ว่า class นี้ มีฟังก์ชั่นอะไรใช้งานได้บ้าง ในแต่ละฟังก์ชั่นก็จะมี รายละเอียดของ parameter, ฟังก์ชั่นนี้ทำอะไร
แต่มันจะไม่ค่อยมีโปรแกรมตัวอย่างที่เรียกใช้งาน ซึ่งก็ต้องไปหาดูเองในเว็บอื่นๆ ตรงนี้ก็จะเป็นข้อเสียของ python
documentation


อ้างอิง

https://www.mindphp.com/%E0%B8%84%E0%B8%B9%E0%B9%88%E0%B8%A1%E0%B8%B7%E0%B8%AD/73-%E0%B8%84%E0%B8%B7%E0%B8%AD%E0%B8%AD%E0%B8%B0%E0%B9%84%E0%B8%A3/7908-functional-programming.html
https://www.mindphp.com/%E0%B8%84%E0%B8%B9%E0%B9%88%E0%B8%A1%E0%B8%B7%E0%B8%AD/73-%E0%B8%84%E0%B8%B7%E0%B8%AD%E0%B8%AD%E0%B8%B0%E0%B9%84%E0%B8%A3/2131-class-%E0%B8%84%E0%B8%B7%E0%B8%AD%E0%B8%AD%E0%B8%B0%E0%B9%84%E0%B8%A3.html
https://www.mindphp.com/%E0%B8%9A%E0%B8%97%E0%B8%84%E0%B8%A7%E0%B8%B2%E0%B8%A1/33-google/3752-google-search.html
https://docs.python.org/3/library/index.html
https://www.mindphp.com/%E0%B8%84%E0%B8%B9%E0%B9%88%E0%B8%A1%E0%B8%B7%E0%B8%AD/73-%E0%B8%84%E0%B8%B7%E0%B8%AD%E0%B8%AD%E0%B8%B0%E0%B9%84%E0%B8%A3/2417-python-%E0%B8%84%E0%B8%B7%E0%B8%AD%E0%B8%AD%E0%B8%B0%E0%B9%84%E0%B8%A3.html
https://www.mindphp.com/forums/viewtopic.php?f=144&t=41599
https://www.mindphp.com/%E0%B8%9A%E0%B8%97%E0%B8%84%E0%B8%A7%E0%B8%B2%E0%B8%A1/31-%E0%B8%84%E0%B8%A7%E0%B8%B2%E0%B8%A1%E0%B8%A3%E0%B8%B9%E0%B9%89%E0%B8%97%E0%B8%B1%E0%B9%88%E0%B8%A7%E0%B9%84%E0%B8%9B/8118-search-engine.html
  • Similar Topics
    ตอบกลับ
    แสดง
    โพสต์ล่าสุด

ผู้ใช้งานขณะนี้

สมาชิกกำลังดูบอร์ดนี้: athirach.offcial และบุคลทั่วไป 83