스트림 메시지는 본문이 각 값에 연관된 데이터 유형이 있는 값 스트림으로 구성된 메시지입니다.
xms::PropertyContext | +----xms::Message | +----xms::StreamMessage
본문의 컨텐츠는 순차적으로 쓰여지고 읽혀집니다.
응용프로그램이 메시지 스트림에서 값을 읽을 때 값은 XMS에 의해 다른 데이터 유형으로 변환될 수 있습니다. 이 형식의 암시적 변환에 대한 자세한 정보는 스트림 메시지를 참조하십시오.
메소드 | 설명 |
---|---|
readBoolean | 메시지 스트림에서 부울 값을 읽습니다. |
readByte | 메시지 스트림에서 부호가 있는 8비트 정수를 읽습니다. |
readBytes | 메시지 스트림에서 바이트 배열을 읽습니다. |
readChar | 메시지 스트림에서 2바이트 문자를 읽습니다. |
readDouble | 메시지 스트림에서 8바이트 배정밀도 부동 소수점 수를 읽습니다. |
readFloat | 메시지 스트림에서 4바이트 부동 소수점 수를 읽습니다. |
readInt | 메시지 스트림에서 부호가 있는 32비트 정수를 읽습니다. |
readLong | 메시지 스트림에서 부호가 있는 64비트 정수를 읽습니다. |
readObject | 메시지 스트림에서 값을 읽은 후 해당 값의 데이터 유형을 리턴합니다. |
readShort | 메시지 스트림에서 부호가 있는 16비트 정수를 읽습니다. |
readString | 메시지 스트림에서 문자열을 읽습니다. |
reset | 메시지 본문을 읽기 전용 모드로 전환하고 커서를 메시지 스트림의 시작 부분으로 옮깁니다. |
writeBoolean | 부울 값을 메시지 스트림에 기록합니다. |
writeByte | 바이트를 메시지 스트림에 기록합니다. |
writeBytes | 바이트 배열을 메시지 스트림에 기록합니다. |
writeChar | 메시지 스트림에 문자를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다. |
writeDouble | 배정밀도 부동 소수점 수를 Long 정수로 변환한 후 Long 정수를 메시지 스트림에 8바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다. |
writeFloat | 부동 소수점 수를 정수로 변환한 후 정수를 메시지 스트림에 4바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다. |
writeInt | 메시지 스트림에 정수를 4바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다. |
writeLong | 메시지 스트림에 Long 정수를 8바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다. |
writeObject | 지정된 데이터 유형의 값을 메시지 스트림에 기록합니다. |
writeShort | 메시지 스트림에 Short 정수를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다. |
writeString | 문자열을 메시지 스트림에 기록합니다. |
xmsINT readBytes(xmsSBYTE *buffer, const xmsINT bufferLength, xmsINT *returnedLength) const;
배열의 바이트 수가 버퍼 길이보다 작거나 같을 경우 전체 배열이 버퍼로 읽혀집니다. 배열의 바이트 수가 버퍼 길이보다 클 경우 버퍼가 배열의 일부로 채워지고 내부 커서가 다음으로 읽을 바이트의 위치를 표시합니다. readBytes()에 대한 이후 호출은 바이트의 현재 커서 위치에서부터 바이트를 읽습니다.
입력 시 널 포인터를 지정하면 해당 호출이 바이트 배열을 읽지 않고 건너 뜁니다.
입력 시 널 포인터를 지정하면 이 메소드가 값을 리턴하지 않습니다.
xmsOBJECT_TYPE readObject(xmsSBYTE *buffer, const xmsINT bufferLength, xmsINT *actualLength) const;
메시지 스트림에서 값을 읽은 후 해당 값의 데이터 유형을 리턴합니다.
이 메소드의 사용 방법에 대한 자세한 정보는 바이트 배열을 리턴하는 C++ 메소드를 참조하십시오.
입력에서 널 포인트를 지정한 경우 해당 호출이 읽지 않고 값을 건너뜁니다.
xmsVOID writeObject(const xmsOBJECT_TYPE objectType, const xmsSBYTE *value, const xmsINT length);
지정된 데이터 유형의 값을 메시지 스트림에 기록합니다.