Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

55.3. Hướng dẫn kiểu tỷ lệ kèo bóng đá tối nay#

Hướng dẫn kiểu này được cung cấp với hy vọng duy trì phong cách nhất quán, thân thiện với người dùng trong tất cả các tỷ lệ kèo bóng đá tối nay điệp được tạo bởiPostgreSQL.

Điều gì xảy ra ở đâu#

tỷ lệ kèo bóng đá tối nay chính phải ngắn, thực tế và tránh tham chiếu đến các chi tiết thực hiện như tên chức năng cụ thể.HồingắnHồicó nghĩa làsẽ phù hợp với một dòng trong điều kiện bình thườngHồi. Sử dụng một tỷ lệ kèo bóng đá tối nay chi tiết nếu cần để giữ cho tin nhắn chính ngắn hoặc nếu bạn cảm thấy cần phải đề cập đến các chi tiết thực hiện như cuộc gọi hệ thống cụ thể không thành công.

Ví dụ: thay vì:


    

Viết:

Chính: Không thể tạo đoạn bộ nhớ được chia sẻ: %m

12413_12879

Định dạng#

Không đặt bất kỳ giả định cụ thể nào về định dạng vào các văn bản tin nhắn. Mong khách khách hàng và nhật ký máy chủ bao gồm các dòng phù hợp với nhu cầu của riêng họ.

Rationale: Tin nhắn không nhất thiết phải được hiển thị trên màn hình kiểu thiết bị đầu cuối. Trong GUI Hiển thị hoặc trình duyệt, các hướng tỷ lệ kèo bóng đá tối nay định dạng này được bỏ qua tốt nhất.

dấu ngoặc kép#

Văn bản tiếng Anh nên sử dụng dấu ngoặc kép khi trích tỷ lệ kèo bóng đá tối nay là phù hợp. Văn bản bằng các ngôn ngữ khác nên liên tục sử dụng một loại trích tỷ lệ kèo bóng đá tối nay phù hợp với xuất bản hải quan và đầu ra máy tính của các chương trình khác.

Rationale: Việc lựa chọn trích tỷ lệ kèo bóng đá tối nay kép trên các trích tỷ lệ kèo bóng đá tối nay đơn có phần tùy ý, nhưng có xu hướng sử dụng ưa thích. Một số người đã đề nghị chọn loại trích tỷ lệ kèo bóng đá tối nay tùy thuộc vào loại đối tượng theo các quy ước SQL (cụ thể là các chuỗi được trích tỷ lệ kèo bóng đá tối nay, số nhận dạng được trích tỷ lệ kèo bóng đá tối nay gấp đôi).

Sử dụng trích tỷ lệ kèo bóng đá tối nay#

Luôn sử dụng tỷ lệ kèo bóng đá tối nay giá để phân định tên tệp, định danh người dùng do người dùng, tên biến cấu hình và các biến khác có thể chứa các từ. Không sử dụng chúng để đánh dấu các biến sẽ không chứa các từ (ví dụ: tên toán tử).

Có các chức năng trong phần phụ trợ sẽ truy cập gấp đôi đầu ra của chúng khi cần thiết (ví dụ:format_type_be ()). Không đặt tỷ lệ kèo bóng đá tối nay giá bổ sung xung quanh đầu ra của các chức năng đó.

Rationale: Các đối tượng có thể có tên tạo ra sự mơ hồ khi được nhúng trong một tin nhắn. Hãy nhất quán về việc biểu thị nơi một tên cắm bắt đầu và kết thúc.

Ngữ pháp và dấu câu#

Các quy tắc khác nhau cho các tỷ lệ kèo bóng đá tối nay chính và cho thông báo chi tiết/gợi ý:

tỷ lệ kèo bóng đá tối nay chính: Không viết hoa chữ cái đầu tiên. Không kết thúc một tin nhắn với một khoảng thời gian.

Tin nhắn chi tiết và gợi ý: Sử dụng các câu hoàn chỉnh và kết thúc mỗi câu với một khoảng thời gian. Viết hoa từ đầu tiên của câu.

Chuỗi ngữ cảnh tỷ lệ kèo bóng đá tối nay: Không viết hoa chữ cái đầu tiên và không kết thúc chuỗi bằng một khoảng thời gian. Các chuỗi ngữ cảnh thường không phải là câu hoàn chỉnh.

Rationale: Tránh dấu câu giúp các ứng dụng khách dễ dàng đưa tỷ lệ kèo bóng đá tối nay điệp vào nhiều ngữ cảnh ngữ pháp dễ dàng hơn. tỷ lệ kèo bóng đá tối nay thường, các tỷ lệ kèo bóng đá tối nay điệp chính không phải là câu hoàn chỉnh về mặt ngữ pháp.

trường hợp trên so với chữ thường#

Sử dụng chữ thường cho từ ngữ tin nhắn, bao gồm chữ cái đầu tiên của tỷ lệ kèo bóng đá tối nay chính. Sử dụng trường hợp trên cho các lệnh SQL và các từ khóa nếu chúng xuất hiện trong thông báo.

Rationale: dễ dàng hơn để làm cho mọi thứ trông ổn định hơn theo cách này, vì một số tin nhắn là câu hoàn chỉnh và một số không.

Tránh giọng nói thụ động#

Sử dụng giọng nói đang hoạt động. Sử dụng các câu hoàn chỉnh khi có một chủ đề diễn xuất (A không thể làm b). Sử dụng phong cách Telegram mà không có chủ đề nếu chủ đề sẽ là chương trình;iHồicho chương trình.

Đặt vấn đề: Chương trình không phải là con người. Đừng giả vờ khác.

hiện tại so với thì quá khứ#

Sử dụng thì quá khứ nếu cố gắng làm điều gì đó thất bại, nhưng có lẽ có thể thành công vào lần tới (có lẽ sau khi khắc phục một số vấn đề). Sử dụng thì hiện tại nếu thất bại chắc chắn là vĩnh viễn.

Có một sự khác biệt ngữ nghĩa không cần thiết giữa các câu của biểu mẫu:

Không thể mở tệp " %s": %m

và:

Không thể mở tệp "%s"

Cái đầu tiên có nghĩa là nỗ lực mở tệp không thành công. tỷ lệ kèo bóng đá tối nay sẽ đưa ra một lý do, chẳng hạn nhưHồiĐĩa đầy đủHànghoặcHồiTệp không tồn tạixông. Thì quá khứ là phù hợp vì lần tới đĩa có thể không còn đầy nữa hoặc tệp trong câu hỏi có thể tồn tại.

Mẫu thứ hai chỉ ra rằng chức năng mở tệp được đặt tên hoàn toàn không tồn tại trong chương trình hoặc điều đó là không thể về mặt khái niệm. Thì hiện tại là thích hợp vì điều kiện sẽ tồn tại vô thời hạn.

Rationale: Được cấp, người dùng trung bình sẽ không thể rút ra kết luận tuyệt vời chỉ từ thì của tỷ lệ kèo bóng đá tối nay điệp, nhưng vì ngôn ngữ cung cấp cho chúng ta một ngữ pháp, chúng ta nên sử dụng nó một cách chính xác.

loại đối tượng#

Khi trích tỷ lệ kèo bóng đá tối nay tên của một đối tượng, hãy nêu nó là loại đối tượng.

Đặt vấn đề: Nếu không thì không ai sẽ biếtHồifoo.bar.bazđề cập đến.

Cấu trúc#

dấu ngoặc vuông chỉ được sử dụng (1) trong các bản tóm tắt lệnh để biểu thị các đối số tùy chọn hoặc (2) để biểu thị chỉ số mảng.

Đặt vấn đề: Bất cứ điều gì khác không tương ứng với việc sử dụng tỷ lệ kèo bóng đá tối nay thường được biết đến rộng rãi và sẽ gây nhầm lẫn cho mọi người.

Lắp ráp các tỷ lệ kèo bóng đá tối nay#

Khi một tin nhắn bao gồm văn bản được tạo ở nơi khác, hãy nhúng nó theo kiểu này:

Không thể mở tệp %s: %m

Rationale: Sẽ rất khó để giải thích cho tất cả các mã lỗi có thể để dán điều này thành một câu trơn tru duy nhất, vì vậy một số loại dấu câu là cần thiết. Đặt văn bản nhúng vào ngoặc đơn cũng đã được đề xuất, nhưng không tự nhiên nếu văn bản nhúng có thể là phần quan trọng nhất của tỷ lệ kèo bóng đá tối nay điệp, như thường lệ.

Lý do cho tỷ lệ kèo bóng đá tối nay#

Tin nhắn phải luôn nói lên lý do tại sao xảy ra tỷ lệ kèo bóng đá tối nay. Ví dụ:

xấu: không thể mở tệp %s

Nếu không có lý do nào được biết, bạn sẽ sửa mã tốt hơn.

Tên chức năng#

Không bao gồm tên của thói quen báo cáo trong văn bản lỗi. Chúng tôi có các cơ chế khác để tìm ra điều đó khi cần thiết và đối với hầu hết người dùng, đó không phải là tỷ lệ kèo bóng đá tối nay tin hữu ích.

xấu: pg_strtoint32: tỷ lệ kèo bóng đá tối nay trong "z": không thể phân tích được "z"

Tránh đề cập đến tên hàm được gọi là; Thay vào đó hãy nói những gì mã đang cố gắng làm:

xấu: Open () không thành công: %m

Nếu nó thực sự có vẻ cần thiết, hãy đề cập đến cuộc gọi hệ thống trong tỷ lệ kèo bóng đá tối nay chi tiết. (Trong một số trường hợp, việc cung cấp các giá trị thực tế được truyền vào cuộc gọi hệ thống có thể là thông tin phù hợp cho tỷ lệ kèo bóng đá tối nay chi tiết.)

Đặt vấn đề: Người dùng không biết tất cả các chức năng đó làm gì.

từ khó để tránh#

Không thể. không thểgần như là giọng nói thụ động. Sử dụng tốt hơnHồikhông thểHồihoặcVangkhông thểHồi, khi thích hợp.

xấu.tỷ lệ kèo bóng đá tối nay nhưMạnhkết quả xấuHồithực sự khó diễn giải tỷ lệ kèo bóng đá tối nay minh. Tốt hơn là viết tại sao kết quả làHồixấuHồi, ví dụ:MạnhĐịnh dạng không hợp lệHồi.

bất hợp pháp. bất hợp pháplà viết tắt của vi phạm pháp luật, phần còn lại làkhông hợp lệxông. Tốt hơn nữa, hãy nói tại sao nó không hợp lệ.

Không xác định.cố gắng tránhkhông xác định. Coi nhưHồitỷ lệ kèo bóng đá tối nay: không xác định phản hồi. Nếu bạn không biết phản hồi là gì, làm thế nào để bạn biết nó sai?Hồikhông nhận thứcxôngthường là lựa chọn tốt hơn. Ngoài ra, hãy chắc chắn bao gồm giá trị bị phàn nàn.

xấu: loại nút không xác định

Tìm so với tồn tại.Nếu chương trình sử dụng thuật toán không cần thiết để xác định vị trí tài nguyên (ví dụ: tìm kiếm đường tỷ lệ kèo bóng đá tối nay) và thuật toán đó không thành công, thật công bằng khi nói rằng chương trình không thểTìmHồiTài nguyên. Mặt khác, nếu vị trí dự kiến ​​của tài nguyên được biết nhưng chương trình không thể truy cập nó ở đó thì nói rằng tài nguyên khôngHồitồn tạiHồi. Sử dụngHồiTìmHồiTrong trường hợp này nghe có vẻ yếu và gây nhầm lẫn vấn đề.

Có thể so với có thể so với MASS. Hồicó thểHồiđề xuất sự cho phép (ví dụ: "Bạn có thể mượn cào của tôi.") Và ít sử dụng trong tài liệu hoặc tỷ lệ kèo bóng đá tối nay.CANxôngđề xuất khả năng (ví dụ: "Tôi có thể nâng nhật ký đó.") Vàcó thểHàngđề xuất khả năng (ví dụ: "Trời có thể mưa hôm nay."). Sử dụng từ thích hợp làm rõ ý nghĩa và hỗ trợ dịch.

co thắt.Tránh các cơn co thắt, nhưkhông thểxông; sử dụngkhông thểHồiThay vào đó.

Không âm.TránhHồikhông âmxôngVì nó mơ hồ về việc liệu nó có chấp nhận không. Tốt hơn là sử dụnglớn hơn 0hoặclớn hơn hoặc bằng khôngHàng.

Chính tả thích hợp#

đánh vần các từ đầy đủ. Chẳng hạn, tránh:

  • spec

  • Số liệu thống kê

  • Parens

  • auth

  • XACT

Đặt vấn đề: Điều này sẽ cải thiện tính nhất quán.

Bản địa hóa#

Hãy nhớ rằng các văn bản tỷ lệ kèo bóng đá tối nay cần được dịch sang các ngôn ngữ khác. Thực hiện theo các hướng dẫn trongPhần 56.2.2Để tránh làm cho cuộc sống trở nên khó khăn cho các dịch giả.