> ## 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 使用者識別碼。

*percentile*\
類型：double

玩家的百分位數排名。

*rank*\
類型：uint32\_t

玩家的排名。

*globalRank*\
類型：uint32\_t

玩家的全域排名。如果 globalrank 為 0，表示使用者沒有全域排名。

*columnValues*\
類型：const char\*\*

玩家排行榜列中每一欄的 UTF-8 編碼 JSON 值。這會包含對應 [XblLeaderboardQuery](/zh-TW/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery) 的 **statName**，後面接著存在於該列中的任何指定 **additionalColumnleaderboardNames**。

*columnValuesCount*\
類型：size\_t

**columnValues** 的數目。

## 隸屬於

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

## 需求

**標頭：** leaderboard\_c.h

## 另請參閱

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


## Related topics

- [XblLeaderboardResult](/zh-TW/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult.md)
- [新式玩家代號的最佳做法和測試](/zh-TW/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XblLeaderboardGetLeaderboardAsync](/zh-TW/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)
- [XblLeaderboardGetLeaderboardResult](/zh-TW/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresult.md)
- [XblLeaderboardColumn](/zh-TW/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardcolumn.md)