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ế.

43.3. Hướng dẫn kiểu tỷ lệ kèo bóng đá 88

tỷ lệ kèo bóng đá 88 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 tin nhắn được tạo bởiPostgreSQL.

43.3.1. Điều gì đi ở đâu

tỷ lệ kèo bóng đá 88 điệp 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ư chức năng cụ thể tên."ngắn"có nghĩa là"sẽ phù hợp với một dòng theo bình thường điều kiện". Sử dụng một tỷ lệ kèo bóng đá 88 chi tiết nếu cần để giữ Tin nhắn chính ngắn, hoặc nếu bạn cảm thấy cần phải đề cập chi tiết triển khai như hệ thống cụ thể gọi là thất bại. Cả thông điệp chính và chi tiết nên là thực tế. Sử dụng một tin nhắn gợi ý cho các đề xuất về những việc cần làm để sửa chữa vấn đề, đặc biệt là nếu đề xuất có thể không phải lúc nào cũng áp dụng.

Ví dụ: thay vì

(cộng với một phụ lục dài về cơ bản là một gợi ý)

Viết

Tiểu học: Không thể tạo đoạn bộ nhớ được chia sẻ: %m
Chi tiết: Syscall thất bại là shmget (key =%d, size =%u, 0%o).
Gợi ý: Phụ lục

11896_12384

43.3.2. Định dạng

Không đặt bất kỳ giả định cụ thể nào về định dạng vào văn bản tin nhắn. Mong khách khách hàng và nhật ký máy chủ kết thúc dòng để phù hợp với nhu cầu của riêng họ. Trong các tin nhắn dài, các ký tự mới (\ n) có thể được sử dụng để chỉ ra các đoạn văn được đề xuất. Đừng Kết thúc một tin nhắn với một dòng mới. Không sử dụng tab hoặc các tab khác định dạng ký tự. (Trong màn hình bối cảnh tỷ lệ kèo bóng đá 88, Newlines là tự động thêm vào các cấp độ riêng biệt của bối cảnh như Các cuộc gọi chức năng.)

13005_13170

43.3.3. 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 đá 88 là phù hợp. Văn bản bằng các ngôn ngữ khác nên sử dụng một cách nhất quán Một loại trích tỷ lệ kèo bóng đá 88 phù hợp với phong tục xuất bản và đầu ra máy tính của các chương trình khác.

Đặt vấn đề: Sự lựa chọn của trích tỷ lệ kèo bóng đá 88 kép trên các trích tỷ lệ kèo bóng đá 88 đơn là Hơi tùy ý, nhưng có xu hướng sử dụng ưa thích. Một số đã đề nghị chọn loại trích tỷ lệ kèo bóng đá 88 tùy thuộc vào loại đối tượng theo quy ước SQL (cụ thể là chuỗi Trích tỷ lệ kèo bóng đá 88 duy nhất, định danh được trích tỷ lệ kèo bóng đá 88 gấp đôi). Nhưng đây là một Vấn đề kỹ thuật ngôn ngữ bên trong mà nhiều người dùng không phải quen thuộc với, nó sẽ không quy mô sang các loại thuật ngữ được trích tỷ lệ kèo bóng đá 88 khác, nó không dịch sang các ngôn ngữ khác và nó đẹp vô nghĩa, quá.

43.3.4. Sử dụng trích tỷ lệ kèo bóng đá 88

sử dụng tỷ lệ kèo bóng đá 88 giá luôn để phân định tên tệp, do người dùng cung cấp Định danh và các biến khác có thể chứa các từ. LÀM 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ẽ tăng gấp đôi đầu ra của riêng họ khi cần (ví dụ:format_type_be()). Không đặt bổ sung tỷ lệ kèo bóng đá 88 giá xung quanh đầu ra của các chức năng như vậy.

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. 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. Nhưng không làm lộn xộn tin nhắn với dấu ngoặc kép không cần thiết hoặc trùng lặp.

43.3.5. 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 đá 88 chính và cho Thông điệp chi tiết/gợi ý:

tỷ lệ kèo bóng đá 88 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. Thậm chí không nghĩ về kết thúc một tin nhắn với một dấu chấm than.

tỷ lệ kèo bóng đá 88 điệp chi tiết và gợi ý: Sử dụng các câu hoàn chỉnh và kết thúc mỗi người có một khoảng thời gian. Viết hoa từ đầu tiên của câu.

15503_16039

43.3.6. 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 cả bản đầu tiên Thư của một tỷ lệ kèo bóng đá 88 chính. Sử dụng trường hợp trên cho SQL các lệnh và từ khóa nếu chúng xuất hiện trong tin nhắn.

Đặt vấn đề: dễ dàng hơn để làm cho mọi thứ trông giống hơn phù hợp 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.

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

16670_16754"A không thể làm B "). Sử dụng kiểu telegram mà không có chủ đề nếu chủ đề sẽ là chính chương trình; Không sử dụng"I"cho chương trình.

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

43.3.8. Hiện tại vs thì quá khứ

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

17388_17465

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

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

Cái đầu tiên có nghĩa là nỗ lực mở tệp thất bại. tỷ lệ kèo bóng đá 88 sẽ đưa ra một lý do, chẳng hạn như"Đĩa đầy đủ"hoặc"Tệp không hiện hữu". Thì quá khứ là thích hợp vì lần sau đĩa có thể không còn đầy nữa hoặc tệp được đề cập có thể hiện hữu.

Mẫu thứ hai cho biết 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 Nó 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 những kết luận tuyệt vời chỉ từ căng thẳng của tin nhắn, 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ó chính xác.

43.3.9. Loại đối tượng

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

Đặt vấn đề: Nếu không thì không ai sẽ biết những gì"foo.bar.baz"đề cập đến.

43.3.10. Dấu ngoặ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ị một mảng Đăng ký.

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

43.3.11. Lắp ráp các tỷ lệ kèo bóng đá 88

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

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

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

43.3.12. Lý do cho tỷ lệ kèo bóng đá 88

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

xấu: không thể mở tệp %s
Tốt hơn: Không thể mở tệp %s (i/o thất bại)

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

43.3.13. Tên chức năng

Không bao gồm tên của thói quen báo cáo trong lỗi chữ. 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 đá 88 tin hữu ích. Nếu văn bản lỗi không có ý nghĩa nhiều nếu không có chức năng Tên, Tái lấy nó.

xấu: pg_atoi: tỷ lệ kèo bóng đá 88 trong "z": không thể phân tích "z"
Tốt hơn: Cú pháp đầu vào không hợp lệ cho số nguyên: "Z"

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

BAD: Open () không thành công: %m
Tốt hơn: Không thể mở tệp %s: %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 thông điệp chi tiết. (Trong một số trường hợp, cung cấp các giá trị thực tế được chuyển đến cuộc gọi hệ thống có thể là thông tin phù hợp cho tỷ lệ kèo bóng đá 88 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ì.

43.3.14. Những từ khó để tránh

không thể. "Không thể"IS Gần như giọng nói thụ động. Sử dụng tốt hơn"Không thể"hoặc"Có thể không", khi thích hợp.

xấu.tỷ lệ kèo bóng đá 88 như"xấu kết quả"thực sự khó diễn giải tỷ lệ kèo bóng đá 88 minh. Tốt hơn là viết tại sao kết quả là"xấu", ví dụ:"Không hợp lệ định dạng".

bất hợp pháp. "bất hợp pháp"là 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ệ". 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ánh"Không xác định". Coi như"tỷ lệ kèo bóng đá 88: phản hồi không xác định". 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?"không được nhận dạng"thường là tốt hơn sự lựa chọn. Ngoài ra, hãy chắc chắn bao gồm giá trị bị phàn nàn của.

xấu: loại nút không xác định
Tốt hơn: Loại nút không được công nhận: 42

Tìm so với tồn tại.Nếu chương trình sử dụng không cần thiết Thuật toán để định vị một tài nguyên (ví dụ: tìm kiếm đường tỷ lệ kèo bóng đá 88) và cái đó Thuật toán thất bại, thật công bằng khi nói rằng chương trình không thể"Tìm"Tài nguyên. Nếu, trên mặt khác, vị trí dự kiến ​​của tài nguyên được biết đến Nhưng chương trình không thể truy cập nó ở đó sau đó nói rằng Tài nguyên không"tồn tại". Sử dụng"Tìm"Trong trường hợp này nghe có vẻ yếu và nhầm lẫn vấn đề.

43.3.15. Chính tả thích hợp

Chính tả 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.

43.3.16. Bản địa hóa

Hãy nhớ rằng các văn bản tỷ lệ kèo bóng đá 88 cần được dịch vào các ngôn ngữ khác. Thực hiện theo các hướng dẫn trongPhần 44.2.2đến Tránh làm cho cuộc sống khó khăn cho các dịch giả.