| Postgresql 8.3.23 Tài liệu | ||||
|---|---|---|---|---|
| prev | Backward nhanh | Chương 46. PostgreSql Coding quy ước | Chuyển tiếp nhanh | NEXT |
kèo bóng đá việt nam 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.
10865_11000"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 kèo bóng đá việt nam 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:
11741_11885
11898_12386
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 kèo bóng đá việt nam, 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.)
Đặt vấn đề: 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 này Hướng kèo bóng đá việt nam định dạng là tốt nhất bị bỏ qua.
Văn bản tiếng Anh nên sử dụng dấu ngoặc kép khi trích kèo bóng đá việt nam 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 kèo bóng đá việt nam 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.
13557_14086
14229_14452
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
kèo bóng đá việt nam 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.
Các quy tắc khác nhau cho các kèo bóng đá việt nam chính và cho Thông điệp chi tiết/gợi ý:
kèo bóng đá việt nam 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.
kèo bóng đá việt nam đ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. Đặt hai khoảng trống sau khoảng thời gian nếu một câu khác theo sau (đối với Văn bản tiếng Anh; có thể không phù hợp trong các ngôn ngữ khác).
15636_16174
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 kèo bóng đá việt nam 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.
Cơ sở lý luậ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. kèo bóng đá việt nam 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ể 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 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 kèo bóng đá việt nam 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"foo.bar.baz"đề cập đến.
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 kèo bóng đá việt nam thường và sẽ gây nhầm lẫn cho mọi người.
19458_19545
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 kèo bóng đá việt nam, như thường lệ.
Tin nhắn phải luôn nêu lý do tại sao một kèo bóng đá việt nam 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à kèo bóng đá việt nam 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: kèo bóng đá việt nam trong "z": không thể phân tích được "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 được gọi là; 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 kèo bóng đá việt nam chi tiết.)
21395_21453
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.kèo bóng đá việt nam như"xấu kết quả"thực sự khó diễn giải kèo bóng đá việt nam 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ư"kèo bóng đá việt nam: 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 công nhận"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 kèo bóng đá việt nam) 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 đề.
Có thể so với có thể so với Might. "May"đề xuất sự cho phép (ví dụ: "bạn có thể mượn cái cào của tôi. "), và ít sử dụng trong tài liệu hoặc kèo bóng đá việt nam."CAN"23803_23864"Might"đề xuất khả năng (ví dụ: "nó 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ể"; sử dụng"Không thể"thay vào đó.
đá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.
Hãy nhớ rằng các văn bản kèo bóng đá việt nam 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 47.2.2đến Tránh làm cho cuộc sống khó khăn cho các dịch giả.