代码注释

src/NetHack_3.7/src/decl.c

@@ -17,7 +17,7 @@ NEARDATA const struct c_color_names c_color_names = {
     "black",  "amber", "golden", "light blue", "red",   "green",
     "silver", "blue",  "purple", "white",      "orange"
 };
-const char *c_obj_colors[] = {   //这里定义了一些物品的颜色
+const char *c_obj_colors[] = {
     "black",          /* CLR_BLACK */
     "red",            /* CLR_RED */
     "green",          /* CLR_GREEN */
@@ -36,8 +36,8 @@ const char *c_obj_colors[] = {   //这里定义了一些物品的颜色
     "white",          /* CLR_WHITE */
 };
 
-const struct c_common_strings c_common_strings =  //结构体变量中包含了一些常见的字符串，用于文本输出
-    { "Nothing happens.",      //在游戏中提供反馈、描述情况，进行交互
+const struct c_common_strings c_common_strings =
+    { "Nothing happens.",
       "That's enough tries!",
       "That is a silly thing to %s.",
       "shudder for a moment.",
@@ -50,34 +50,33 @@ const struct c_common_strings c_common_strings =  //结构体变量中包含了
       { "mon", "you" }
 };
 
-const struct savefile_info default_sfinfo = {  //定义了保存文件的默认信息
-#ifdef NHSTDC    //用于保存文件格式的标志位
+const struct savefile_info default_sfinfo = {
+#ifdef NHSTDC
     0x00000000UL
 #else
     0x00000000L
 #endif
-#if defined(COMPRESS) || defined(ZLIB_COMP)   //用于外部压缩标志位
+#if defined(COMPRESS) || defined(ZLIB_COMP)
         | SFI1_EXTERNALCOMP
 #endif
 #if defined(ZEROCOMP)
-        | SFI1_ZEROCOMP   //零压缩标志位
+        | SFI1_ZEROCOMP
 #endif
 #if defined(RLECOMP)
-        | SFI1_RLECOMP    //RLE压缩标志
+        | SFI1_RLECOMP
 #endif
     ,
 #ifdef NHSTDC
-    0x00000000UL, 0x00000000UL   //保留字段
+    0x00000000UL, 0x00000000UL
 #else
     0x00000000L, 0x00000000L
 #endif
 };
 
-const char disclosure_options[] = "iavgco";  //是一个字符数组，包含了几个选项。这些选项用于控制信息的披露程度。
-char emptystr[] = {0};       /* non-const */  //是一个字符数组，用于表示空字符串。它是非常量数组，可以被修改。
+const char disclosure_options[] = "iavgco";
+char emptystr[] = {0};       /* non-const */
 
 NEARDATA struct flag flags;  /* extern declaration is in flag.h, not decl.h */
-//是一个结构体变量，用于存储游戏中的标志位。该变量在flag.h中有外部声明。
 
 /* Global windowing data, defined here for multi-window-system support */
 #ifdef WIN32
@@ -85,28 +84,25 @@ boolean fqn_prefix_locked[PREFIX_COUNT] = { FALSE, FALSE, FALSE,
                                             FALSE, FALSE, FALSE,
                                             FALSE, FALSE, FALSE,
                                             FALSE };
-                                            //是一个布尔数组，用于表示文件名前缀是否被锁定。在这段代码中，它被初始化为全为FALSE。
 #endif
 #ifdef PREFIXES_IN_USE
 const char *fqn_prefix_names[PREFIX_COUNT] = {
     "hackdir",  "leveldir", "savedir",    "bonesdir",  "datadir",
     "scoredir", "lockdir",  "sysconfdir", "configdir", "troubledir"
-};//是一个字符串指针数组，包含了一些文件名前缀的名称。这些名称用于指定不同类型文件的存储路径。
+};
 #endif
 
 /* x/y/z deltas for the 10 movement directions (8 compass pts, 2 down/up) */
 const schar xdir[N_DIRS_Z] = { -1, -1,  0,  1,  1,  1,  0, -1, 0,  0 };
 const schar ydir[N_DIRS_Z] = {  0, -1, -1, -1,  0,  1,  1,  1, 0,  0 };
 const schar zdir[N_DIRS_Z] = {  0,  0,  0,  0,  0,  0,  0,  0, 1, -1 };
-//是三个有符号字符数组，分别表示十个移动方向（包括八个主要方向和上下方向）的x、y和z轴的增量。
 /* redordered directions, cardinals first */
 const schar dirs_ord[N_DIRS] =
     { DIR_W, DIR_N, DIR_E, DIR_S, DIR_NW, DIR_NE, DIR_SE, DIR_SW };
-//是一个有符号字符数组，表示经过重新排序的移动方向。首先是四个基本方向，然后是四个对角线方向。
 
-NEARDATA boolean has_strong_rngseed = FALSE;  //是一个布尔变量，用于表示是否具有强随机种子。
+NEARDATA boolean has_strong_rngseed = FALSE;
 struct engr *head_engr;
-NEARDATA struct instance_flags iflags;  //是一个结构体变量，用于存储游戏实例的标志位。
+NEARDATA struct instance_flags iflags;
 /* NOTE: the order of these words exactly corresponds to the
    order of oc_material values #define'd in objclass.h. */
 const char *materialnm[] = { "mysterious", "liquid",  "wax",        "organic",
@@ -115,35 +111,29 @@ const char *materialnm[] = { "mysterious", "liquid",  "wax",        "organic",
                              "metal",      "copper",  "silver",     "gold",
                              "platinum",   "mithril", "plastic",    "glass",
                              "gemstone",   "stone" };
-                             //是一个字符串指针数组，包含了一些物品材质的名称。这些名称与objclass.h中定义的oc_material值的顺序完全对应。
-
-const char quitchars[] = " \r\n\033";//是一个包含一些表示退出字符的字符串，包括空格、回车、换行和转义字符。
-
-NEARDATA struct savefile_info sfcap, sfrestinfo, sfsaveinfo;  //结构体变量，用于保存文件的信息。
-
-const int shield_static[SHIELD_COUNT] = {//是一个整型数组，包含了一些盾牌的静态符号。
+const char quitchars[] = " \r\n\033";
+NEARDATA struct savefile_info sfcap, sfrestinfo, sfsaveinfo;
+const int shield_static[SHIELD_COUNT] = {
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4, /* 7 per row */
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4,
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4,
 };
-NEARDATA struct you u;//结构体变量，用于表示玩家角色的状态和属性。
-NEARDATA time_t ubirthday;  //是一个time_t类型的变量，表示玩家角色的出生时间。
-NEARDATA struct u_realtime urealtime;  //用于表示游戏时间的实时信息。
-NEARDATA struct obj *uwep, *uarm, *uswapwep,  //结构体的指针变量，用于表示玩家角色的装备和物品。
+NEARDATA struct you u;
+NEARDATA time_t ubirthday;
+NEARDATA struct u_realtime urealtime;
+NEARDATA struct obj *uwep, *uarm, *uswapwep,
     *uquiver, /* quiver */
     *uarmu, /* under-wear, so to speak */
     *uskin, /* dragon armor, if a dragon */
     *uarmc, *uarmh, *uarms, *uarmg,*uarmf, *uamul,
     *uright, *uleft, *ublindf, *uchain, *uball;
-const char vowels[] = "aeiouAEIOU"; //是一个包含元音字母的字符串，包括小写和大写的元音字母。
-NEARDATA winid WIN_MESSAGE, WIN_STATUS, WIN_MAP, WIN_INVEN;//是窗口标识符（winid类型）变量，用于表示游戏中的不同窗口。
-const char ynchars[] = "yn"; //是包含一些表示"yes"和"no"的字符的字符串。
+const char vowels[] = "aeiouAEIOU";
+NEARDATA winid WIN_MESSAGE, WIN_STATUS, WIN_MAP, WIN_INVEN;
+const char ynchars[] = "yn";
 const char ynqchars[] = "ynq";
 const char ynaqchars[] = "ynaq";
 const char ynNaqchars[] = "yn#aq";
 NEARDATA long yn_number = 0L;
-//这些变量的定义用于实现游戏的逻辑和界面显示等功能。
-//其中包括随机数种子、文本输出、文件操作、游戏状态、时间管理、玩家角色属性、装备和物品等。
 
 #ifdef PANICTRACE
 const char *ARGV0;