> ## 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

리더보드 항목 컬렉션의 행을 나타냅니다.

## Syntax

```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  
```

### Members

*gamertag*\
Type: char\[XBL\_GAMERTAG\_CHAR\_SIZE]

플레이어의 UTF-8로 인코딩된 게이머태그입니다.

*modernGamertag*\
Type: char\[XBL\_MODERN\_GAMERTAG\_CHAR\_SIZE]

플레이어의 UTF-8로 인코딩된 모던 게이머태그입니다. 고유성이 보장되지 않습니다.

*modernGamertagSuffix*\
Type: char\[XBL\_MODERN\_GAMERTAG\_SUFFIX\_CHAR\_SIZE]

고유성을 보장하기 위해 모던 게이머태그에 추가되는 UTF-8로 인코딩된 접미사입니다. 경우에 따라 비어 있을 수 있습니다.

*uniqueModernGamertag*\
Type: char\[XBL\_UNIQUE\_MODERN\_GAMERTAG\_CHAR\_SIZE]

UTF-8로 인코딩된 고유 모던 게이머태그와 접미사입니다. 형식은 “modernGamertag#suffix”입니다. 렌더링되는 문자 수는 16자 이하로 보장됩니다.

*xboxUserId*\
Type: uint64\_t

플레이어의 XBOX 사용자 ID입니다.

*percentile*\
Type: double

플레이어의 백분위 순위입니다.

*rank*\
Type: uint32\_t

플레이어의 순위입니다.

*globalRank*\
Type: uint32\_t

플레이어의 전역 순위입니다. globalrank가 0이면 사용자는 전역 순위가 없습니다.

*columnValues*\
Type: const char\*\*

플레이어의 리더보드 행에 있는 각 열에 대한 UTF-8로 인코딩된 JSON 값입니다. 여기에는 해당 [XblLeaderboardQuery](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery)의 **statName**과 행에 존재하는 지정된 **additionalColumnleaderboardNames**의 값이 포함됩니다.

*columnValuesCount*\
Type: size\_t

**columnValues**의 수입니다.

## Member of

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

## Requirements

**Header:** leaderboard\_c.h

## See also

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


## Related topics

- [XblLeaderboardResult](/ko/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult.md)
- [모던 게이머태그의 모범 사례 및 테스트](/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Quota Leaderboards](/ko/services/playfab/community/leaderboards/quota-leaderboards.md)
- [Add contextual data to leaderboards](/ko/services/playfab/community/leaderboards/metadata-leaderboards.md)
- [XblLeaderboardGetLeaderboardAsync](/ko/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)