| Postgresql 7.4.30 Tài liệu | ||||
|---|---|---|---|---|
| prev | Backward nhanh | Chương 45. PostgreSql Coding quy ước | Chuyển tiếp nhanh | NEXT |
tỷ lệ kèo bóng đá trực tuyến hôm nay 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.
tỷ lệ kèo bóng đá trực tuyến hôm nay đ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"11123_11505
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
Chính: 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
11936_12424
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 đá trực tuyến hôm nay, 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.)
13045_13210
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 đá trực tuyến hôm nay 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 đá trực tuyến hôm nay 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 đề: Lựa chọn của trích tỷ lệ kèo bóng đá trực tuyến hôm nay kép trên các trích tỷ lệ kèo bóng đá trực tuyến hôm nay đơn 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 đá trực tuyến hôm nay 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 đá trực tuyến hôm nay duy nhất, định danh được trích tỷ lệ kèo bóng đá trực tuyến hôm nay 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 đá trực tuyến hôm nay khác, nó không dịch sang các ngôn ngữ khác và nó đẹp vô nghĩa, quá.
sử dụng tỷ lệ kèo bóng đá trực tuyến hôm nay giá luôn 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ẽ được trích tỷ lệ kèo bóng đá trực tuyến hôm nay 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 đá trực tuyến hôm nay 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.
15128_15214
tỷ lệ kèo bóng đá trực tuyến hôm nay lỗi 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 đá trực tuyến hôm nay đ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 bắt đầu câu.
Rationale: Tránh dấu câu giúp khách hàng dễ dàng hơn Các ứng dụng để nhúng tỷ lệ kèo bóng đá trực tuyến hôm nay điệp vào nhiều loại ngữ pháp khác nhau bối cảnh. tỷ lệ kèo bóng đá trực tuyến hôm nay thường, các tin nhắn chính không theo ngữ pháp hoàn thành câu nào. (Và nếu chúng đủ dài để trở thành nhiều hơn một câu, chúng nên được chia thành chính và các phần chi tiết.) Tuy nhiên, tỷ lệ kèo bóng đá trực tuyến hôm nay điệp chi tiết và gợi ý dài hơn và Có thể cần bao gồm nhiều câu. Cho sự nhất quán, họ nên làm theo phong cách hoàn toàn câu ngay cả khi chỉ có một câu.
Sử dụng chữ thường cho từ ngữ tin nhắn, bao gồm cả lần đầu tiên Thư của một tỷ lệ kèo bóng đá trực tuyến hôm nay lỗi 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.
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 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ì.
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.
Có 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 thất bại. tỷ lệ kèo bóng đá trực tuyến hôm nay 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.
Khi trích tỷ lệ kèo bóng đá trực tuyến hôm nay 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 đề: Khác không ai biết"foo.bar.baz"iS.
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 đá trực tuyến hôm nay thường và sẽ gây nhầm lẫn cho mọi người.
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
19531_19893
Tin nhắn phải luôn nêu lý do tại sao một tỷ lệ kèo bóng đá trực tuyến hôm nay 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.
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 đá trực tuyến hôm nay 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 đá trực tuyến hôm nay 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 chức năng; thay vào đó nói Mã đã cố gắng làm gì:
xấu: 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 đá trực tuyến hôm 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ì.
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 đá trực tuyến hôm nay lỗi như"xấu kết quả"thực sự khó diễn giải tỷ lệ kèo bóng đá trực tuyến hôm nay 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 đá trực tuyến hôm nay: 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
22955_22973Nế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 đá trực tuyến hôm nay) 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 đề.
đánh vần đầy đủ các từ. 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.
Hãy nhớ rằng các văn bản tỷ lệ kèo bóng đá trực tuyến hôm nay lỗi 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 46.2.2đến Tránh làm cho cuộc sống khó khăn cho các dịch giả.