Phiên bản được hỗ trợ:hiện tại(17)16/15/14/13
Phiên bản phát triển: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ế.

53.3.Hướng dẫn kiểu kèo bóng đá cúp c2

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 kèo bóng đá cúp c2 điệp được tạo bởiPostgreSQL.

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

kèo bóng đá cúp c2 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ể.ngắnxôngcó 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 kèo bóng đá cúp c2 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

Rationale: Giữ ngắn tin nhắn chính giúp giữ cho nó đến điểm và cho phép khách hàng đưa ra không gian màn hình trên giả định rằng một dòng là đủ cho các kèo bóng đá cúp c2. Thông điệp chi tiết và gợi ý có thể được chuyển xuống chế độ dài dòng hoặc có lẽ là cửa sổ chi tiết lỗi bật lên.

Định dạng

Đừ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 kèo bóng đá cúp c2 đị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 kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 kép so với các trích kèo bóng đá cúp c2 đơ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 kèo bóng đá cúp c2 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 kèo bóng đá cúp c2, số nhận dạng được trích kèo bóng đá cúp c2 gấp đôi).

Sử dụng trích kèo bóng đá cúp c2

sử dụng kèo bóng đá cúp c2 giá luôn luôn để phân định tên tệp, nhận dạng người dùng do người dùng cung cấp 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ẽ xử lý gấp đôi đầu ra của chính chúng khi cần (ví dụ:format_type_be ()). Không đặt kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 chính và cho các thông báo chi tiết/gợi ý:

kèo bóng đá cúp c2 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.

kèo bóng đá cúp c2 đ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 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 kèo bóng đá cúp c2: 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 kèo bóng đá cúp c2 điệp vào nhiều ngữ cảnh ngữ pháp dễ dàng hơn. kèo bóng đá cúp c2 thường, các kèo bóng đá cúp c2 đ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 kèo bóng đá cúp c2 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 nhất quán 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;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ó 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"

Người đầu tiên có nghĩa là nỗ lực mở tệp không thành công. kèo bóng đá cúp c2 sẽ đưa ra một lý do, chẳng hạn nhưHồiĐĩa đầy đủHồihoặcHồiTệp không tồn tạiHồi. 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.

18892_19089

Loại đối tượng

Khi trích kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 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 kèo bóng đá cúp c2

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

Đặt vấn đề: 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 kèo bóng đá cúp c2 điệp, như thường lệ.

Lý do cho kèo bóng đá cúp c2

Tin nhắn phải luôn nêu lý do tại sao xảy ra kèo bóng đá cúp c2. 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à kèo bóng đá cúp c2 tin hữu ích.

BAD: PG_STROINT32: kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 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 kèo bóng đá cúp c2 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ơnkhông thểHồihoặcHồikhông thểHồi, khi thích hợp.

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

bất hợp pháp. Hồibấ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àHồikhông hợp lệHà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 địnhVoi. Coi nhưkèo bóng đá cúp c2: 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ậnHồithườ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 để định vị tài nguyên (ví dụ: tìm kiếm đường kèo bóng đá cúp c2) 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ìmTà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ụngTì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 Might. có thểHồiđề xuất sự cho phép (ví dụ: "bạn có thể mượn cào của tôi.") Và có ít sử dụng trong tài liệu hoặc kèo bóng đá cúp c2.CANHồiđề xuất khả năng (ví dụ: "Tôi có thể nâng nhật ký đó.") VàHồicó thểHồiđề 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ưHồikhông thểKhăn; sử dụngkhông thểHồiThay vào đó.

Không âm.TránhMạnhkhô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 0KhănhoặcHồilớn hơn hoặc bằng khôngHồi.

Chính tả thích hợp

đá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.

Bản địa hóa

Hãy nhớ rằng các văn bản kèo bóng đá cúp c2 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 54.2.2Để tránh làm cho cuộc sống trở nên khó khăn cho các dịch giả.