> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblLeaderboardRow

> XblLeaderboardRow

# XblLeaderboardRow

表示排行榜项集合中的行。

## 语法

```cpp theme={null}
typedef struct XblLeaderboardRow {  
    char gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    char modernGamertag[XBL_MODERN_GAMERTAG_CHAR_SIZE];  
    char modernGamertagSuffix[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE];  
    char uniqueModernGamertag[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE];  
    uint64_t xboxUserId;  
    double percentile;  
    uint32_t rank;  
    uint32_t globalRank;  
    const char** columnValues;  
    size_t columnValuesCount;  
} XblLeaderboardRow  
```

### 成员

*gamertag*\
类型：char\[XBL\_GAMERTAG\_CHAR\_SIZE]

玩家的 UTF-8 编码玩家代号。

*modernGamertag*\
类型：char\[XBL\_MODERN\_GAMERTAG\_CHAR\_SIZE]

玩家的 UTF-8 编码现代玩家代号。不保证唯一。

*modernGamertagSuffix*\
类型：char\[XBL\_MODERN\_GAMERTAG\_SUFFIX\_CHAR\_SIZE]

附加到现代玩家代号以确保唯一性的 UTF-8 编码后缀。在某些情况下可能为空。

*uniqueModernGamertag*\
类型：char\[XBL\_UNIQUE\_MODERN\_GAMERTAG\_CHAR\_SIZE]

UTF-8 编码的唯一现代玩家代号和后缀。格式为 “modernGamertag#suffix”。保证呈现字符不超过 16 个。

*xboxUserId*\
类型：uint64\_t

玩家的 XBOX 用户 ID。

*percentile*\
类型：double

玩家的百分位排名。

*rank*\
类型：uint32\_t

玩家的排名。

*globalRank*\
类型：uint32\_t

玩家的全局排名。如果 globalrank 为 0，则表示该用户没有全局排名。

*columnValues*\
类型：const char\*\*

玩家在排行榜行中每列对应的 UTF-8 编码 JSON 值。这将包括相应的 [XblLeaderboardQuery](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery) 的 **statName**，后跟行中存在的任何指定的 **additionalColumnleaderboardNames**。

*columnValuesCount*\
类型：size\_t

**columnValues** 的数量。

## 成员归属

[XblLeaderboardResult](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult)

## 要求

**头文件：** leaderboard\_c.h

## 另请参阅

[leaderboard\_c](/reference/live/xsapi-c/leaderboard_c/leaderboard_c_members)


## Related topics

- [XblLeaderboardResult](/zh-CN/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult.md)
- [现代游戏玩家代号的最佳实践和测试](/zh-CN/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XblLeaderboardGetLeaderboardAsync](/zh-CN/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)
- [XblLeaderboardGetLeaderboardResult](/zh-CN/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresult.md)
- [XblLeaderboardColumn](/zh-CN/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardcolumn.md)