Các quy tắc về việc sử dụng dấu gạch dưới trong mã định danh C ++ là gì?

945
Roger Lipscombe 2008-10-23 21:02.

Trong C ++, việc đặt tên cho các biến thành viên với một số loại tiền tố để biểu thị thực tế rằng chúng là các biến thành viên, chứ không phải là các biến hoặc tham số cục bộ. Nếu bạn đến từ nền MFC, bạn có thể sẽ sử dụng m_foo. Tôi cũng myFoothỉnh thoảng nhìn thấy .

C # (hoặc có thể chỉ .NET) dường như khuyên bạn chỉ nên sử dụng dấu gạch dưới, như trong _foo. Điều này có được phép theo tiêu chuẩn C ++ không?

5 answers

868

Các quy tắc (không thay đổi trong C ++ 11):

  • Được bảo lưu trong bất kỳ phạm vi nào, bao gồm cả để sử dụng làm macro triển khai :
    • số nhận dạng bắt đầu bằng dấu gạch dưới, ngay sau đó là chữ hoa
    • số nhận dạng có chứa dấu gạch dưới liền kề (hoặc "dấu gạch dưới kép")
  • Được dành riêng trong không gian tên chung:
    • số nhận dạng bắt đầu bằng dấu gạch dưới
  • Ngoài ra, mọi thứ trong stdkhông gian tên đều được bảo lưu. (Tuy nhiên, bạn được phép thêm các chuyên môn mẫu.)

Từ Tiêu chuẩn C ++ 2003:

17.4.3.1.2 Tên toàn cầu [lib.global.names]

Một số bộ tên và chữ ký hàm nhất định luôn được dành riêng cho việc triển khai:

  • Mỗi tên có chứa dấu gạch dưới kép ( __) hoặc bắt đầu bằng dấu gạch dưới theo sau là chữ hoa (2.11) được dành riêng cho việc triển khai cho bất kỳ mục đích sử dụng nào.
  • Mỗi tên bắt đầu bằng dấu gạch dưới được dành riêng cho việc triển khai để sử dụng làm tên trong không gian tên chung. 165

165) Những tên như vậy cũng được dành riêng trong không gian tên ::std(17.4.3.1).

Vì C ++ dựa trên tiêu chuẩn C (1.1 / 2, C ++ 03) và C99 là tham chiếu chuẩn (1.2 / 1, C ++ 03) nên những tiêu chuẩn này cũng được áp dụng, từ Tiêu chuẩn C 1999:

7.1.3 Số nhận dạng dành riêng

Mỗi tiêu đề khai báo hoặc xác định tất cả các số nhận dạng được liệt kê trong điều khoản phụ được liên kết và khai báo hoặc xác định tùy chọn các số nhận dạng được liệt kê trong mệnh đề phụ hướng thư viện tương lai được liên kết và số nhận dạng luôn được dành riêng cho bất kỳ mục đích sử dụng nào hoặc để sử dụng làm số nhận dạng phạm vi tệp.

  • Tất cả các số nhận dạng bắt đầu bằng dấu gạch dưới và chữ hoa hoặc dấu gạch dưới khác luôn được dành riêng cho bất kỳ mục đích sử dụng nào.
  • Tất cả các số nhận dạng bắt đầu bằng dấu gạch dưới luôn được dành riêng để sử dụng làm số nhận dạng với phạm vi tệp trong cả không gian tên thẻ và thông thường.
  • Mỗi tên macro trong bất kỳ điều khoản con nào sau đây (bao gồm cả hướng thư viện trong tương lai) được dành riêng để sử dụng như đã chỉ định nếu có bất kỳ tiêu đề liên quan nào của nó; trừ khi có quy định rõ ràng khác (xem 7.1.4).
  • Tất cả các số nhận dạng có liên kết bên ngoài trong bất kỳ điều khoản phụ nào sau đây (bao gồm cả các hướng thư viện trong tương lai) luôn được dành riêng để sử dụng làm số nhận dạng có liên kết bên ngoài. 154
  • Mỗi số nhận dạng có phạm vi tệp được liệt kê trong bất kỳ điều khoản con nào sau đây (bao gồm cả các hướng thư viện trong tương lai) được dành riêng để sử dụng làm tên macro và làm số nhận dạng có phạm vi tệp trong không gian cùng tên nếu có bất kỳ tiêu đề liên quan nào của nó.

Không có số nhận dạng nào khác được bảo lưu. Nếu chương trình khai báo hoặc xác định một số nhận dạng trong ngữ cảnh mà nó được dành riêng (khác với 7.1.4 cho phép) hoặc xác định một số nhận dạng dành riêng dưới dạng tên macro, thì hành vi đó là không xác định.

Nếu chương trình loại bỏ (với #undef) bất kỳ định nghĩa macro nào của số nhận dạng trong nhóm đầu tiên được liệt kê ở trên, thì hành vi đó là không xác định.

154) Danh mục các định danh dè chừng liên kết bên ngoài bao gồm errno, math_errhandling, setjmp, và va_end.

Các hạn chế khác có thể được áp dụng. Ví dụ: tiêu chuẩn POSIX dự trữ rất nhiều số nhận dạng có khả năng hiển thị trong mã bình thường:

  • Tên bắt đầu bằng Echữ hoa theo sau một chữ số hoặc chữ hoa:
    • có thể được sử dụng cho các tên mã lỗi bổ sung.
  • Tên bắt đầu bằng một trong hai ishoặc totheo sau bằng chữ thường
    • có thể được sử dụng cho các chức năng chuyển đổi và kiểm tra ký tự bổ sung.
  • Những tên bắt đầu LC_bằng chữ cái viết hoa theo sau
    • có thể được sử dụng cho các macro bổ sung chỉ định thuộc tính ngôn ngữ.
  • Tên của tất cả các hàm toán học hiện có kèm theo fhoặc lđược đặt trước
    • cho các hàm tương ứng hoạt động trên đối số float và đối số kép dài, tương ứng.
  • Những tên bắt đầu SIGbằng chữ cái viết hoa được đặt trước
    • cho các tên tín hiệu bổ sung.
  • Những tên bắt đầu SIG_bằng chữ cái viết hoa được đặt trước
    • cho các hành động tín hiệu bổ sung.
  • Tên bắt đầu với str, memhoặc wcstheo sau là một chữ cái thường được dành riêng
    • cho các hàm chuỗi và mảng bổ sung.
  • Tên bắt đầu bằng PRIhoặc SCNtheo sau bởi bất kỳ chữ cái thường nào hoặc Xđược đặt trước
    • cho các macro bổ sung định dạng
  • Những tên kết thúc bằng đã _tđược đặt trước
    • cho các tên loại bổ sung.

Mặc dù việc sử dụng những tên này cho mục đích của riêng bạn ngay bây giờ có thể không gây ra vấn đề gì, nhưng chúng sẽ làm tăng khả năng xung đột với các phiên bản tương lai của tiêu chuẩn đó.


Cá nhân tôi chỉ không bắt đầu số nhận dạng bằng dấu gạch dưới. Bổ sung mới cho quy tắc của tôi: Không sử dụng dấu gạch dưới kép ở bất kỳ đâu, điều này rất dễ dàng vì tôi hiếm khi sử dụng dấu gạch dưới.

Sau khi thực hiện nghiên cứu về bài viết này, tôi không còn kết thúc số nhận dạng của mình nữa _tvì điều này được bảo lưu bởi tiêu chuẩn POSIX.

Quy tắc về bất kỳ số nhận dạng nào kết thúc bằng _tlàm tôi ngạc nhiên rất nhiều. Tôi nghĩ rằng đó là một tiêu chuẩn POSIX (chưa chắc chắn) đang tìm kiếm sự làm rõ và chương và câu chính thức. Đây là từ hướng dẫn sử dụng GNU libtool , liệt kê các tên đã đặt trước.

CesarB đã cung cấp liên kết sau đến các ký hiệu và ghi chú dành riêng cho POSIX 2004 'rằng nhiều tiền tố và hậu tố dành riêng khác ... có thể được tìm thấy ở đó'. Các ký hiệu dành riêng cho POSIX 2008 được xác định ở đây. Các hạn chế có phần nhiều sắc thái hơn những hạn chế ở trên.

202
paercebal 2008-10-23 21:27.

Các quy tắc để tránh xung đột tên đều có trong tiêu chuẩn C ++ (xem sách Stroustrup) và được đề cập bởi các chuyên gia C ++ (Sutter, v.v.).

Quy tắc cá nhân

Bởi vì tôi không muốn giải quyết các trường hợp và muốn có một quy tắc đơn giản, tôi đã thiết kế một quy tắc cá nhân vừa đơn giản vừa chính xác:

Khi đặt tên cho một biểu tượng, bạn sẽ tránh được va chạm với trình biên dịch / hệ điều hành / thư viện tiêu chuẩn nếu bạn:

  • không bao giờ bắt đầu một biểu tượng bằng dấu gạch dưới
  • không bao giờ đặt tên cho một biểu tượng có hai dấu gạch dưới liên tiếp bên trong.

Tất nhiên, đặt mã của bạn trong một không gian tên duy nhất cũng giúp tránh va chạm (nhưng sẽ không bảo vệ khỏi các macro xấu)

Vài ví dụ

(Tôi sử dụng macro vì chúng là ký hiệu C / C ++ gây ô nhiễm mã hơn, nhưng nó có thể là bất kỳ thứ gì từ tên biến đến tên lớp)

#define _WRONG
#define __WRONG_AGAIN
#define RIGHT_
#define WRONG__WRONG
#define RIGHT_RIGHT
#define RIGHT_x_RIGHT

Trích xuất từ ​​bản nháp C ++ 0x

Từ tệp n3242.pdf (Tôi hy vọng văn bản tiêu chuẩn cuối cùng sẽ tương tự):

17.6.3.3.2 Tên toàn cầu [global.names]

Một số bộ tên và chữ ký hàm nhất định luôn được dành riêng cho việc triển khai:

- Mỗi tên chứa dấu gạch dưới kép _ _ hoặc bắt đầu bằng dấu gạch dưới theo sau là chữ hoa (2.12) được dành riêng cho việc triển khai cho bất kỳ mục đích sử dụng nào.

- Mỗi tên bắt đầu bằng dấu gạch dưới được dành riêng cho việc triển khai để sử dụng làm tên trong không gian tên chung.

Nhưng cũng:

17.6.3.3.5 Các hậu tố theo nghĩa đen do người dùng xác định [usrlit.suffix]

Các mã định danh hậu tố theo nghĩa đen không bắt đầu bằng dấu gạch dưới được dành riêng cho quá trình tiêu chuẩn hóa trong tương lai.

Mệnh đề cuối cùng này gây nhầm lẫn, trừ khi bạn cho rằng tên bắt đầu bằng một dấu gạch dưới và theo sau là một chữ thường sẽ là Ok nếu không được xác định trong không gian tên chung ...

40
Roger Lipscombe 2008-10-23 21:06.

Từ MSDN :

Việc sử dụng hai ký tự gạch dưới tuần tự (__) ở đầu số nhận dạng hoặc một dấu gạch dưới đứng đầu theo sau là một ký tự viết hoa, được dành riêng cho việc triển khai C ++ trong tất cả các phạm vi. Bạn nên tránh sử dụng một dấu gạch dưới đầu tiên theo sau là một chữ cái thường cho các tên có phạm vi tệp vì có thể có xung đột với các số nhận dạng dành riêng hiện tại hoặc trong tương lai.

Điều này có nghĩa là bạn có thể sử dụng một dấu gạch dưới duy nhất làm tiền tố biến thành viên, miễn là nó được theo sau bởi một chữ cái thường.

Điều này dường như được lấy từ phần 17.4.3.1.2 của tiêu chuẩn C ++, nhưng tôi không thể tìm thấy nguồn gốc cho tiêu chuẩn đầy đủ trực tuyến.

Xem thêm câu hỏi này .

25
Max Lybbert 2008-11-15 10:03.

Đối với phần khác của câu hỏi, người ta thường đặt dấu gạch dưới ở cuối tên biến để không đụng độ với bất kỳ thứ gì bên trong.

Tôi làm điều này ngay cả bên trong các lớp và không gian tên vì sau đó tôi chỉ phải nhớ một quy tắc (so với "ở cuối tên trong phạm vi toàn cục và đầu tên ở mọi nơi khác").

1
John Millikin 2008-10-23 21:05.

Có, dấu gạch dưới có thể được sử dụng ở bất kỳ đâu trong số nhận dạng. Tôi tin rằng các quy tắc là: bất kỳ az, AZ, _ trong ký tự đầu tiên và + 0-9 cho các ký tự sau.

Tiền tố gạch dưới phổ biến trong mã C - một dấu gạch dưới đơn có nghĩa là "riêng tư" và dấu gạch dưới kép thường được trình biên dịch sử dụng.

MORE COOL STUFF

Cate Blanchett chia tay chồng sau 3 ngày bên nhau và vẫn kết hôn với anh ấy 25 năm sau

Cate Blanchett chia tay chồng sau 3 ngày bên nhau và vẫn kết hôn với anh ấy 25 năm sau

Cate Blanchett đã bất chấp những lời khuyên hẹn hò điển hình khi cô gặp chồng mình.

Tại sao Michael Sheen là một diễn viên phi lợi nhuận

Tại sao Michael Sheen là một diễn viên phi lợi nhuận

Michael Sheen là một diễn viên phi lợi nhuận nhưng chính xác thì điều đó có nghĩa là gì?

Hallmark Star Colin Egglesfield Các món ăn gây xúc động mạnh đối với người hâm mộ tại RomaDrama Live! [Loại trừ]

Hallmark Star Colin Egglesfield Các món ăn gây xúc động mạnh đối với người hâm mộ tại RomaDrama Live! [Loại trừ]

Ngôi sao của Hallmark Colin Egglesfield chia sẻ về những cuộc gặp gỡ với người hâm mộ ly kỳ tại RomaDrama Live! cộng với chương trình INSPIRE của anh ấy tại đại hội.

Tại sao bạn không thể phát trực tuyến 'chương trình truyền hình phía Bắc'

Tại sao bạn không thể phát trực tuyến 'chương trình truyền hình phía Bắc'

Bạn sẽ phải phủi sạch đầu đĩa Blu-ray hoặc DVD để xem tại sao Northern Exposure trở thành một trong những chương trình nổi tiếng nhất của thập niên 90.

Where in the World Are You? Take our GeoGuesser Quiz

Where in the World Are You? Take our GeoGuesser Quiz

The world is a huge place, yet some GeoGuessr players know locations in mere seconds. Are you one of GeoGuessr's gifted elite? Take our quiz to find out!

8 công dụng tuyệt vời của Baking Soda và Giấm

8 công dụng tuyệt vời của Baking Soda và Giấm

Bạn biết đấy, hai sản phẩm này là nguồn điện để làm sạch, riêng chúng. Nhưng cùng với nhau, chúng có một loạt công dụng hoàn toàn khác.

Hạn hán, biến đổi khí hậu đe dọa tương lai của thủy điện Hoa Kỳ

Hạn hán, biến đổi khí hậu đe dọa tương lai của thủy điện Hoa Kỳ

Thủy điện rất cần thiết cho lưới điện của Hoa Kỳ, nhưng nó chỉ tạo ra năng lượng khi có nước di chuyển. Bao nhiêu nhà máy thủy điện có thể gặp nguy hiểm khi các hồ và sông cạn kiệt?

Quyên góp tóc của bạn để giúp giữ nước sạch của chúng tôi

Quyên góp tóc của bạn để giúp giữ nước sạch của chúng tôi

Tóc tỉa từ các tiệm và các khoản quyên góp cá nhân có thể được tái sử dụng như những tấm thảm thấm dầu và giúp bảo vệ môi trường.

BoJack Horseman vẫn gan ruột và gan dạ hơn bao giờ hết trong phần 3

BoJack Horseman vẫn gan ruột và gan dạ hơn bao giờ hết trong phần 3

BoJack Horseman (Ảnh: Netflix) BoJack Horseman bắt đầu mùa thứ ba với sự xuất hiện của nhân vật tiêu biểu, người vẫn đang theo đuổi những lời khen ngợi từ giới phê bình trong một nỗ lực tuyệt vọng để tìm ra ý nghĩa trong cuộc sống của mình. Mùa thứ hai về số phận bi kịch của Raphael Bob-Waksberg dày đặc những trò đùa cũng như tuyệt vọng.

Xem cách tính năng lái tự động cập nhật của Tesla bùng phát như thế nào khi bạn bỏ qua các cảnh báo của nó

Xem cách tính năng lái tự động cập nhật của Tesla bùng phát như thế nào khi bạn bỏ qua các cảnh báo của nó

Bản nâng cấp Phiên bản 8.0 gần đây của Tesla đối với hệ thống Lái xe tự động được thiết kế để cải thiện hệ thống và mối quan hệ của nó với người lái.

UnREAL, Chương trình Truyền hình Về Truyền hình Thực tế Chúng tôi Không biết Chúng tôi Cần

UnREAL, Chương trình Truyền hình Về Truyền hình Thực tế Chúng tôi Không biết Chúng tôi Cần

Chắc chắn khi con cái chúng ta xem lại các chương trình chúng ta đã xem vào khoảng năm 2015, chúng sẽ thấy UnREAL, một chương trình truyền hình mới chiếu vào tối Thứ Hai của Lifetime — bạn sẽ thấy đúng lúc, sẽ phát sóng ngay sau khi The Bachelor kết thúc — như một chương trình không thể được thực hiện vào bất kỳ thời điểm nào khác trong lịch sử truyền hình, nhưng một chương trình cảm thấy cần thiết để xem bây giờ. UnREAL có sự tham gia của Shiri Appleby trong vai Rachel, một nhà sản xuất truyền hình cho một chương trình về cơ bản là The Bachelor, mặc dù trong thế giới này, nó được gọi là Vĩnh viễn.

Sau tất cả, Josh Trank sẽ không đạo diễn bộ phim tuyển tập Star Wars thứ hai

Sau tất cả, Josh Trank sẽ không đạo diễn bộ phim tuyển tập Star Wars thứ hai

Thông báo chính thức đến trực tiếp từ trang web của Star Wars: Fantastic Four, đạo diễn Josh Trank, một người bí ẩn không xuất hiện tại đại hội Star Wars Celebration gần đây, sẽ không chỉ đạo phần hai Star Wars Anthology. Đây là tuyên bố được đăng ngày hôm qua: Tất cả thực sự là ngôn ngữ rất lịch sự, nhưng một bài báo của Hollywood Reporter cho thấy tất cả đều không tốt ở hậu trường, gọi sự ra đi là "một vụ sa thải" một phần dựa trên "hành vi bất thường" của Trank trong khi quay Fantastic Four: The Bài báo trích dẫn các nguồn gọi là Trank “đôi khi thiếu quyết đoán và thiếu sáng tạo,” và lưu ý rằng Fantastic Four, khởi chiếu vào ngày 7 tháng 8, đã được khởi động lại vào cuối tháng 4.

Edwin McCain ra mắt Grand Ole Opry: Quay cảnh hậu trường với nhạc sĩ 'I'll Be'

Edwin McCain ra mắt Grand Ole Opry: Quay cảnh hậu trường với nhạc sĩ 'I'll Be'

McCain, người đang làm việc cho một album mới, lần đầu tiên bước vào vòng kết nối vào tối thứ Sáu ở Nashville

Nicky Hilton Forced to Borrow Paris' 'I Love Paris' Sweatshirt After 'Airline Loses All [My] Luggage'

Nicky Hilton Forced to Borrow Paris' 'I Love Paris' Sweatshirt After 'Airline Loses All [My] Luggage'

Nicky Hilton Rothschild's luggage got lost, but luckily she has an incredible closet to shop: Sister Paris Hilton's!

Kate Middleton dành một ngày bên bờ nước ở London, cùng với Jennifer Lopez, Julianne Hough và hơn thế nữa

Kate Middleton dành một ngày bên bờ nước ở London, cùng với Jennifer Lopez, Julianne Hough và hơn thế nữa

Kate Middleton dành một ngày bên bờ nước ở London, cùng với Jennifer Lopez, Julianne Hough và hơn thế nữa. Từ Hollywood đến New York và mọi nơi ở giữa, hãy xem các ngôi sao yêu thích của bạn đang làm gì!

17 tuổi bị đâm chết trong khi 4 người khác bị thương trong một cuộc tấn công bằng dao trên sông Wisconsin

17 tuổi bị đâm chết trong khi 4 người khác bị thương trong một cuộc tấn công bằng dao trên sông Wisconsin

Các nhà điều tra đang xem xét liệu nhóm và nghi phạm có biết nhau trước vụ tấn công hay không

Tôi viết như thế nào

Tôi viết như thế nào

Đối với tôi, mọi thứ là về dòng đầu tiên đó và nó sẽ đưa bạn đến đâu. Một số nhà văn bị điều khiển bởi cốt truyện, sự sắp xếp tinh tế của các quân cờ, trong khi những người khác bị lôi cuốn bởi một nhân vật và khả năng thực hiện một cuộc hành trình với một người bạn hư cấu mới.

Đường băng hạ cánh

Đường băng hạ cánh

Cuối hè đầu thu là mùa hoài niệm. Những chiếc đèn đường chiếu ánh sáng của chúng qua những con đường đẫm mưa, và những chiếc lá dưới chân - màu đỏ cam tắt trong bóng chạng vạng - là lời nhắc nhở về những ngày đã qua.

Hãy tưởng tượng tạo ra một chiến lược nội dung thực sự CHUYỂN ĐỔI. Nó có thể.

Hãy tưởng tượng tạo ra một chiến lược nội dung thực sự CHUYỂN ĐỔI. Nó có thể.

Vào năm 2021, tôi khuyến khích bạn suy nghĩ lại mọi thứ bạn biết về khách hàng mà bạn phục vụ và những câu chuyện bạn kể cho họ. Lùi lại.

Sự mất mát của voi ma mút đã mở ra trái tim tôi để yêu

Sự mất mát của voi ma mút đã mở ra trái tim tôi để yêu

Vào ngày sinh nhật thứ 9 của Felix The Cat, tôi nhớ về một trong những mất mát lớn nhất trong cuộc đời trưởng thành của tôi - Sophie của tôi vào năm 2013. Tôi đã viết bài luận này và chia sẻ nó trên nền tảng này một thời gian ngắn vào năm 2013.

Language