### Diffuser des bytes { #stream-bytes }

L'un des principaux cas d'usage consiste à diffuser des `bytes` au lieu de chaînes ; vous pouvez bien sûr le faire.

{* ../../docs_src/stream_data/tutorial001_py310.py ln[44:47] hl[47] *}

{* ../../docs_src/stream_data/tutorial001_py310.py ln[32:35] hl[33] *}

這也意味著使用 `StreamingResponse` 時，你擁有自由與責任，需依需求自行產生並編碼要傳送的位元組資料，與型別註解無關。 🤓

### 串流位元組 { #stream-bytes }

一個主要用例是串流 `bytes` 而非字串，當然可以這麼做。

{* ../../docs_src/stream_data/tutorial001_py310.py ln[44:47] hl[47] *}

## 自訂 `PNGStreamingResponse` { #a-custom-pngstreamingresponse }

Це також означає, що з `StreamingResponse` у вас є свобода і відповідальність формувати та кодувати байти даних саме так, як їх потрібно надіслати, незалежно від анотацій типів. 🤓

### Потік байтів { #stream-bytes }

Один з основних сценаріїв - передавати потоком `bytes` замість строк; це, звісно, підтримується.

{* ../../docs_src/stream_data/tutorial001_py310.py ln[44:47] hl[47] *}

## Користувацький `PNGStreamingResponse` { #a-custom-pngstreamingresponse }

### 模拟文件 { #simulate-a-file }

在这个示例中，我们用 `io.BytesIO` 模拟了一个文件，它是只驻留在内存中的类文件对象，但提供相同的接口。

例如，我们可以像对文件那样迭代它来消费其内容。

{* ../../docs_src/stream_data/tutorial002_py310.py ln[1:27] hl[3,12:13,25] *}

/// note | 技术细节

另外两个变量 `image_base64` 和 `binary_image` 表示一张图像，先用 Base64 编码，再转换为 bytes，最后传给 `io.BytesIO`。

只是为了让它们能和示例放在同一个文件里，便于你直接复制运行。🥚

///

	if n := len(eofR.buf); n != 0 {
		t.Fatalf("got %d bytes left in bufio.Reader source; want 0 bytes", n)
	}
	// To prove the point, check that there are still 5 bytes available to read.
	if n := r.Buffered(); n != 5 {
		t.Fatalf("got %d bytes buffered in bufio.Reader; want 5 bytes", n)
	}

	// This is the second read of 0 bytes.
	read, err = r.Read([]byte{})
	if err != nil {
		t.Fatalf("unexpected error: %v", err)

		}
		// repr.Println(fex, repr.Indent("  "), repr.OmitEmpty(true))
	}
}

func TestSqlLexer(t *testing.T) {
	// s := bytes.NewBuffer([]byte("s.['name'].*.[*].abc.[\"abc\"]"))
	s := bytes.NewBuffer([]byte("S3Object.words.*.id"))
	// s := bytes.NewBuffer([]byte("COUNT(Id)"))
	lex, err := sqlLexer.Lex(s)
	if err != nil {
		t.Fatal(err)
	}
	tokens, err := lexer.ConsumeAll(lex)
	if err != nil {

{* ../../docs_src/stream_data/tutorial001_py310.py ln[32:35] hl[33] *}

이는 곧 `StreamingResponse`를 사용할 때 타입 애너테이션과 무관하게, 전송 기준에 맞춰 바이트 데이터를 생성하고 인코딩할 자유와 책임이 여러분에게 있음을 의미합니다. 🤓

### 바이트 스트리밍 { #stream-bytes }

주요 사용 사례 중 하나는 문자열 대신 `bytes`를 스트리밍하는 것입니다. 물론 그렇게 할 수 있습니다.

{* ../../docs_src/stream_data/tutorial001_py310.py ln[44:47] hl[47] *}

## 사용자 정의 `PNGStreamingResponse` { #a-custom-pngstreamingresponse }

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

Yukarıda okuduğunuz gibi, bir miktar text veya bytes alır ve HTML response döndürür.

### `PlainTextResponse` { #plaintextresponse }

Bir miktar text veya bytes alır ve düz metin response döndürür.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

### ファイルを模擬する { #simulate-a-file }

この例では `io.BytesIO` でファイルを模擬しています。これはメモリ上だけに存在するファイルライクオブジェクトですが、通常のファイルと同じインターフェースを提供します。

例えば、ファイルと同様にイテレートして内容を読み出せます。

{* ../../docs_src/stream_data/tutorial002_py310.py ln[1:27] hl[3,12:13,25] *}

/// note | 技術詳細

他の2つの変数 `image_base64` と `binary_image` は、画像を Base64 でエンコードし、それを `bytes` に変換してから `io.BytesIO` に渡したものです。

この例では1つのファイル内に完結させ、コピーしてそのまま実行できるようにするためだけのものです。 🥚

  proto.SerializeToString(&bytes1);

  const int64_t pts2[] = {1, 3, 5, 7};
  tensorflow::PartialTensorShape(pts2).AsProto(&proto);
  proto.SerializeToString(&bytes2);

  std::unique_ptr<const void*[]> list_ptrs;
  std::unique_ptr<size_t[]> list_lens;
  const std::vector<std::string> list = {bytes1, bytes2};
  StringVectorToArrays(list, &list_ptrs, &list_lens);