Boost.Asio 색인 - posix::basic_stream_descriptor::async_read_some

posix::basic_stream_descriptor::async_read_some

비동기 읽기를 시작한다.

template<
    typename MutableBufferSequence,
    typename ReadHandler = DEFAULT>
DEDUCED async_read_some(
    const MutableBufferSequence & buffers,
    ReadHandler && handler = DEFAULT);

[MutableBufferSequence, ReadHandler, DEFAULT, DEDUCED]

이 함수는 스트림 설명자(descriptor)에서 데이터를 비동기로 읽는 데 사용된다. 함수 호출은 항상 즉시 반환된다.

파라미터

buffers

데이터를 읽기 위한 하나 이상의 버퍼이다. 필요에 따라 버퍼의 개체를 복사할 수 있지만, 기저 메모리 블럭의 소유권은 호출자가 유지하므로 핸들러가 호출될 때까지 유효하게 유지되야 한다.

handler

읽기 작업이 완료되는 시점에 호출되는 핸들러이다. 필요에 따라 핸들러의 복사본이 만들어 진다. 핸들러의 함수 서명은 아래와 같아야 한다:

void handler(
  const boost::system::error_code& error, // Result of operation.
  std::size_t bytes_transferred           // Number of bytes read.
);

비동기 작업이 즉시 완료되는지 여부에 상관없이, 핸들러는 이 함수 내에서 호출되지 않는다. 작업이 즉시 완료되는 경우, 핸들러의 호출은 "post"를 사용하는 것과 동일한 방식으로 수행된다.

비고

읽기 작업이 요청된 바이트 수를 모두 못 읽을 수도 있다. 비동기 작업이 완료되기 전에 요청된 양의 데이터를 읽을 필요가 있으면 async_read 함수를 사용하는 것이 좋다.

예제

단일 데이터 버퍼 읽으려면 다음과 같이 "buffer" 함수를 사용한다:

descriptor.async_read_some(boost::asio::buffer(data, size), handler);

한 번에 여러 버퍼로 읽는 방법과 배열, boost::array 또는 std::vector와 함께 사용하는 방법에 대한 정보는 "buffer" 문서를 참조한다.

Boost.Asio 홈