Graphisoft®

GSRootVersion: 1.0

IChannel::Read

입력 채널로부터 다음 심플 C++ 타입 (또는 Object)을 읽습니다.

GSErrCode Read (char & c);
GSErrCode Read (unsigned char & c);
GSErrCode Read (bool & b);
GSErrCode Read (short & s);
GSErrCode Read (unsigned short & s);
GSErrCode Read (int & i);
GSErrCode Read (unsigned int & i);
GSErrCode Read (long & l);
GSErrCode Read (unsigned long & l);
GSErrCode Read (float & f);
GSErrCode Read (double & d);
GSErrCode Read (long double & d);
GSErrCode Read (char * cStr);
GSErrCode Read (Object & obj);

파라미터

c
리턴시: 입력 채널로부터 읽어온 character 값입니다.
b
리턴시: 입력 채널로부터 읽어온 boolean 값입니다.
s
리턴시: 입력 채널로부터 읽어온 short integer 값입니다.
i
리턴시: 입력 채널로부터 읽어온 integer 값입니다.
l
리턴시: 입력 채널로부터 읽어온 long integer 값입니다.
f
리턴시: 입력 채널로부터 읽어온 float 값입니다.
d
리턴시: 입력 채널로부터 읽어온 double 값입니다.
cStr
리턴시: 입력 채널로부터 읽어온 C 문자열입니다.
obj
리턴시: 입력 채널로부터 읽어온 객체입니다.

리턴 값

의미
NoError* OK
EndOfInput* 입력 끝에 이르렀습니다.
ReadError* 입력 디바이스 상에서 읽기 오류가 발생했습니다.
IntegrityError* 현재 IProtocol 객체에 의해 읽어들인 데이터가 요청한 타입에 대하여 유효하지 않습니다.
Error* 불특정 오류입니다.

* IChannel 클래스 범위 안에 선언됨
* GS 네임스페이스 안에 선언됨, 그러나 글로벌 범위에서 접근 가능함

설명

이 메소드는 현재 IProtocol 객체를 통해 입력 채널로부터 다음 심플 심플 C++ 타입 (또는 Object)을 읽습니다.

만약 입력 채널 상에 데이터가 남아 있지 않다면 EndOfInput을 리턴합니다. 만약 입력 채널 상에 남아 있는 데이터의 양이 요청한 타입을 구성하는 데 충분하지 않다면 IntegrityError를 리턴합니다.

입력 상태는 기록하고 입력 채널 상에서 1번째로 발생한 오류를 저장할 것입니다. 오류가 발생한 후에 이 메소드는 아무 것도 하지 않으며 즉시 저장된 오류 코드를 리턴합니다. (입력 상태가 사용자에 의해 리셋될 때까지)

참고사항

GetInputStatus | ResetInputStatus