> For the complete documentation index, see [llms.txt](https://nviasoft.gitbook.io/nviasoft-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nviasoft.gitbook.io/nviasoft-docs/api-reference/item-parsing/getiteminfo.md). # GetItemInfo ### public unsafe int GetItemInfo(int lMsgId, string sPointer, ref int nFormat, ref int lSize) 수신된 메시지(`lMsgId`) 내에서 특정 경로(`sPointer`)가 가리키는 데이터 아이템의 Format Code(데이터 타입)와 Size(데이터 길이 또는 리스트의 요소 개수)를 조회합니다. 데이터를 실제로 읽기(`GetItemValue`) 전에 버퍼를 준비하거나 데이터 유효성을 검사하는 용도로 필수적인 함수입니다. Parameters
NameTypeDescription
lMsgIdint조회할 대상 메시지 ID
sPointerstring"/ "이면 List
"1"이면 첫번째 아이템
"2"이면 두번째 아이템
nFormatref int(Output) 데이터의 Format Code (예: List=0, ASCII=16, U4=12 등)
lSizeref int(Output) 데이터의 크기 (ASCII는 문자열 길이, List는 요소 개수)
{% code title="Host에서 보낸 메시지 예시" %} ``` S2F33W /* DEFINE REPORT */ > > > > ``` {% endcode %} ```csharp void ParseMessageItem(int lMsgId) { int nFormat= 0; int nSize= 0; // U4 2001의 Format과 Size를 얻고싶은경우 m_gem.GetItemInfo(lMsgId, "/2/1/2/1", ref nFormat, ref nSize);//54(U4) 가 나오게 됩니다. if (result >= 0) { Console.WriteLine($"아이템 포맷: {format}, 크기/개수: {size}"); if (nFormat== 0) // List 타입인 경우 { Console.WriteLine($"해당 위치는 {size}개의 요소를 가진 리스트입니다."); } } } ```
Item FormatValueDescription
L0LIST ITEM
B10BINARY ITEM
BOOL11BOOLEAN ITEM
A20ASCII ITEM
J821JIS-8 Byte ITEM
I1311 Byte Signed Integer
I2322Byte Signed Integer
I4344 Byte Signed Integer
I8308 Byte Signed Integer
U1511 Byte Unsigned Integer
U2522 Byte Unsigned Integer
U4544 Byte Unsigned Integer
U8508 Byte Unsigned Integer
F4444 Byte Floating Pointer
F8408 Byte Floating Pointer
NO ITEM-1더 이상 Item이 존재하지 않음
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://nviasoft.gitbook.io/nviasoft-docs/api-reference/item-parsing/getiteminfo.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.