clarify for streaming API not work with common API, ref qax-os/exceli…

…ze#777
xuri · Feb 6, 2021 · 392e1b3 · 392e1b3
1 parent 69c2ebb
commit 392e1b3
Show file tree

Hide file tree

Showing 31 changed files with 41 additions and 21 deletions.
diff --git a/ar/README.md b/ar/README.md
@@ -9,7 +9,7 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - التراخيص: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - الإصدار الأخير: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- وقت تحديث المستند: كانون الثاني 18, 2021
+- وقت تحديث المستند: شهر فبراير 6, 2021
 
 ## بعثة المشروع
 

diff --git a/ar/stream.md b/ar/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-تقوم NewStreamWriter بإرجاع بنية كاتب الدفق حسب اسم ورقة العمل المحددة لإنشاء ورقة عمل جديدة تحتوي على كميات كبيرة من البيانات. لاحظ أنه بعد تعيين الصفوف ، يجب استدعاء طريقة [`Flush`](stream.md#Flush) لإنهاء عملية الكتابة المتدفقة والتأكد من أن ترتيب أرقام الأسطر تصاعديًا. على سبيل المثال ، قم بتعيين بيانات ورقة العمل بحجم `102400` من الصفوف × `50` من الأعمدة بالأرقام والنمط:
+تقوم NewStreamWriter بإرجاع بنية كاتب الدفق حسب اسم ورقة العمل المحددة لإنشاء ورقة عمل جديدة تحتوي على كميات كبيرة من البيانات. لاحظ أنه بعد تعيين الصفوف ، يجب استدعاء طريقة [`Flush`](stream.md#Flush) لإنهاء عملية الكتابة المتدفقة والتأكد من أن ترتيب أرقام الأسطر تصاعديًا، لا يمكن أن تعمل واجهة برمجة التطبيقات المشتركة وواجهة برمجة التطبيقات للدفق مختلطة لكتابة البيانات في أوراق العمل. على سبيل المثال ، قم بتعيين بيانات ورقة العمل بحجم `102400` من الصفوف × `50` من الأعمدة بالأرقام والنمط:
 
 ```go
 file := excelize.NewFile()

diff --git a/ar/workbook.md b/ar/workbook.md
@@ -321,6 +321,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - مثال 1:
 
@@ -401,6 +402,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - المثال 1 ، للحصول على إعدادات خاصية خط الشبكة لطريقة العرض الأخيرة في ورقة العمل المسماة `Sheet1`:
 

diff --git a/de/README.md b/de/README.md
@@ -9,7 +9,7 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - Lizenzen: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - Letzte Version: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- Dokument Aktualisierungszeit: Januar 18, 2021
+- Dokument Aktualisierungszeit: Februar 6, 2021
 
 ## Project mission
 

diff --git a/de/stream.md b/de/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter gibt die Stream-Writer-Struktur anhand des angegebenen Arbeitsblattnamens zurück, um ein neues Arbeitsblatt mit großen Datenmengen zu generieren. Beachten Sie, dass Sie nach dem Festlegen von Zeilen die [`Flush`](stream.md#Flush) Methode aufrufen müssen, um den Streaming-Schreibvorgang zu beenden und sicherzustellen, dass die Reihenfolge der Zeilennummern aufsteigend ist. Legen Sie beispielsweise Daten für das Arbeitsblatt der Größe `102400` Zeilen x `50` Spalten mit Zahlen und Stil fest:
+NewStreamWriter gibt die Stream-Writer-Struktur anhand des angegebenen Arbeitsblattnamens zurück, um ein neues Arbeitsblatt mit großen Datenmengen zu generieren. Beachten Sie, dass Sie nach dem Festlegen von Zeilen die [`Flush`](stream.md#Flush) Methode aufrufen müssen, um den Streaming-Schreibvorgang zu beenden und sicherzustellen, dass die Reihenfolge der Zeilennummern aufsteigend ist. Die allgemeine API und die Stream-API können nicht gemischt werden, um Daten in die Arbeitsblätter zu schreiben. Legen Sie beispielsweise Daten für das Arbeitsblatt der Größe `102400` Zeilen x `50` Spalten mit Zahlen und Stil fest:
 
 ```go
 file := excelize.NewFile()

diff --git a/de/workbook.md b/de/workbook.md
@@ -316,6 +316,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Beispiel 1:
 
@@ -396,6 +397,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Beispiel 1, um die Eigenschaften der Gitterlinieneigenschaft für die letzte Ansicht im Arbeitsblatt mit dem Namen `Sheet1` abzurufen:
 

diff --git a/en/README.md b/en/README.md
@@ -9,7 +9,7 @@ Excelize is a library written in pure Go providing a set of functions that allow
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - Last version: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- Document update time: Jan 18, 2021
+- Document update time: Feb 6, 2021
 
 ## Project mission
 

diff --git a/en/stream.md b/en/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter return stream writer struct by given worksheet name to generate a new worksheet with large amounts of data. Note that after set rows, you must call the [`Flush`](stream.md#Flush) method to end the streaming writing process and ensure that the order of line numbers is ascending. For example, set data for the worksheet of size `102400` rows x `50` columns with numbers and style:
+NewStreamWriter return stream writer struct by given worksheet name to generate a new worksheet with large amounts of data. Note that after set rows, you must call the [`Flush`](stream.md#Flush) method to end the streaming writing process and ensure that the order of line numbers is ascending, the common API and stream API can't be work mixed to writing data on the worksheets. For example, set data for the worksheet of size `102400` rows x `50` columns with numbers and style:
 
 ```go
 file := excelize.NewFile()

diff --git a/en/workbook.md b/en/workbook.md
@@ -316,6 +316,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Example 1:
 
@@ -398,6 +399,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Example 1, to get the gridline property settings for the last view on the worksheet named `Sheet1`:
 

diff --git a/es/README.md b/es/README.md
@@ -9,7 +9,7 @@ Excelize es una biblioteca escrita en Go puro que proporciona un conjunto de fun
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - Licencias: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - Ultima versión: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- Tiempo de actualización del documento: enero 18, 2021
+- Tiempo de actualización del documento: febrero 6, 2021
 
 ## Misión del proyecto
 

diff --git a/es/stream.md b/es/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter devuelve la estructura del escritor de flujo por el nombre de la hoja de trabajo para generar una nueva hoja de trabajo con grandes cantidades de datos. Tenga en cuenta que después de establecer filas, debe llamar al método [`Flush`](stream.md#Flush) para finalizar el proceso de escritura de transmisión y asegurarse de que el orden de los números de línea sea ascendente. Por ejemplo, configure los datos para la hoja de trabajo de tamaño `102400` filas x `50` columnas con números y estilo:
+NewStreamWriter devuelve la estructura del escritor de flujo por el nombre de la hoja de trabajo para generar una nueva hoja de trabajo con grandes cantidades de datos. Tenga en cuenta que después de establecer filas, debe llamar al método [`Flush`](stream.md#Flush) para finalizar el proceso de escritura de transmisión y asegurarse de que el orden de los números de línea sea ascendente, la API común y la API de flujo no se pueden combinar para escribir datos en las hojas de trabajo. Por ejemplo, configure los datos para la hoja de trabajo de tamaño `102400` filas x `50` columnas con números y estilo:
 
 ```go
 file := excelize.NewFile()

diff --git a/es/workbook.md b/es/workbook.md
@@ -316,6 +316,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Ejemplo 1:
 
@@ -398,6 +399,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Ejemplo 1, para obtener la configuración de propiedades de la cuadrícula para la última vista en la hoja de cálculo denominada `Sheet1`:
 

diff --git a/fr/README.md b/fr/README.md
@@ -9,7 +9,7 @@ Excelize est une bibliothèque écrite en pure Go fournissant un ensemble de fon
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - Dernière version: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- Heure de mise à jour du document: 18 janvier 2021
+- Heure de mise à jour du document: 6 février 2021
 
 ## Mission du projet
 

diff --git a/fr/stream.md b/fr/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter renvoie la structure de l'écrivain de flux par un nom de feuille de calcul donné pour générer une nouvelle feuille de calcul avec de grandes quantités de données. Notez qu'après avoir défini des lignes, vous devez appeler la méthode [`Flush`](stream.md#Flush) pour terminer le processus d'écriture en continu et vous assurer que l'ordre des numéros de ligne est croissant. Par exemple, définissez des données pour la feuille de calcul de taille `102400` lignes x `50` colonnes avec des nombres:
+NewStreamWriter renvoie la structure de l'écrivain de flux par un nom de feuille de calcul donné pour générer une nouvelle feuille de calcul avec de grandes quantités de données. Notez qu'après avoir défini des lignes, vous devez appeler la méthode [`Flush`](stream.md#Flush) pour terminer le processus d'écriture en continu et vous assurer que l'ordre des numéros de ligne est croissant, l'API commune et l'API de flux ne peuvent pas être mélangées à l'écriture de données sur les feuilles de calcul. Par exemple, définissez des données pour la feuille de calcul de taille `102400` lignes x `50` colonnes avec des nombres:
 
 ```go
 file := excelize.NewFile()

diff --git a/fr/workbook.md b/fr/workbook.md
@@ -314,6 +314,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Exemple 1:
 
@@ -394,6 +395,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Exemple 1, pour obtenir les paramètres de la propriété gridline pour la dernière vue de la feuille de calcul nommée `Sheet1`:
 

diff --git a/ja/README.md b/ja/README.md
@@ -9,7 +9,7 @@ Excelize は、純粋な Go で記述されたライブラリで、XLSX / XLSM /
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - ライセンス契約: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - 現在のバージョン: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- ドキュメントの更新：2021年1月18日
+- ドキュメントの更新：2021年2月6日
 
 ## プロジェクトミッション
 

diff --git a/ja/contribution.md b/ja/contribution.md
@@ -2,7 +2,7 @@
 
 ## 寄稿への参加方法
 
-Microsoft Excel&trade; 2007 バージョンでは、XML および ZIP テクノロジに基づく新しいドキュメント形式である XML ベースのドキュメント形式 OOXML (Office Open XML) がサポートされています。 ドキュメントの標準、ドキュメントの検証の比較ツール、およびブラウザーのプラグインを含む、ドキュメントの形式に準拠した開発の関連する参照の一覧を次に示します。
+Microsoft Excel&trade; 2007 バージョンでは、XML および ZIP テクノロジに基づく新しいドキュメント形式である XML ベースのドキュメント形式 OOXML (Office Open XML) がサポートされています。ドキュメントの標準、ドキュメントの検証の比較ツール、およびブラウザーのプラグインを含む、ドキュメントの形式に準拠した開発の関連する参照の一覧を次に示します。
 
 ### リソース
 

diff --git a/ja/stream.md b/ja/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter は、指定されたワークシート名でストリームライター構造体を返し、大量のデータを含む新しいワークシートを生成します。 行を設定した後、[`Flush`](stream.md#Flush) メソッドを呼び出してストリーミング書き込みプロセスを終了し、行番号の順序が昇順であることを確認する必要があることに注意してください。 たとえば、サイズが `102400` 行 x `50` 列のサイズのワークシートにデータを設定します:
+NewStreamWriter は、指定されたワークシート名でストリームライター構造体を返し、大量のデータを含む新しいワークシートを生成します。行を設定した後、[`Flush`](stream.md#Flush) メソッドを呼び出してストリーミング書き込みプロセスを終了し、行番号の順序が昇順であることを確認する必要があることに注意してください、通常のAPIをストリーミングAPIと組み合わせて、ワークシートにデータを書き込むことはできません。たとえば、サイズが `102400` 行 x `50` 列のサイズのワークシートにデータを設定します:
 
 ```go
 file := excelize.NewFile()

diff --git a/ja/workbook.md b/ja/workbook.md
@@ -316,6 +316,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - 例1:
 
@@ -396,6 +397,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - 例1、`Sheet1` という名前のワークシートの最後のビューのグリッド線プロパティ設定を取得します。
 

diff --git a/ko/README.md b/ko/README.md
@@ -9,7 +9,7 @@ Excelize 는 순수 Go로 작성된 라이브러리로 XLSX / XLSM / XLTM 파일
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - 면허: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - 마지막 버전: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- 문서 업데이트 시간: 2021 년 1 월 18 일
+- 문서 업데이트 시간: 2021 년 2 월 6 일
 
 ## 프로젝트 미션
 

diff --git a/ko/stream.md b/ko/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter 는 주어진 워크 시트 이름으로 스트림 기록기를 반환하여 대량의 데이터가 포함 된 새 워크 시트를 생성합니다. 행을 설정 한 후 스트리밍 쓰기 프로세스를 종료하고 행 번호 순서가 오름차순이되도록 [`Flush`](stream.md#Flush) 메소드를 호출해야합니다. 예를 들어, 크기가 `102400` 행 x `50` 열인 워크 시트의 데이터를 숫자로 설정하십시오:
+NewStreamWriter 는 주어진 워크 시트 이름으로 스트림 기록기를 반환하여 대량의 데이터가 포함 된 새 워크 시트를 생성합니다. 행을 설정 한 후 스트리밍 쓰기 프로세스를 종료하고 행 번호 순서가 오름차순이되도록 [`Flush`](stream.md#Flush) 메소드를 호출해야합니다. 워크 시트에 데이터를 쓰기 위해 일반 API를 스트리밍 API와 혼합 할 수 없습니다. 예를 들어, 크기가 `102400` 행 x `50` 열인 워크 시트의 데이터를 숫자로 설정하십시오:
 
 ```go
 file := excelize.NewFile()

diff --git a/ko/workbook.md b/ko/workbook.md
@@ -314,6 +314,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - 예 1:
 
@@ -394,6 +395,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - 예 1: `Sheet1` 이라는 워크 시트의 마지막 뷰에 대 한 그리드 선 특성 설정을 가져옵니다.
 

diff --git a/ru/README.md b/ru/README.md
@@ -9,7 +9,7 @@ EXCELIZE - это библиотека, написанная на чистом G
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - Лицензии: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - Последняя версия: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- Время обновления документа: 18 Январь 2021 г.
+- Время обновления документа: 6 Февраль 2021 г.
 
 ## Миссия проекта
 

diff --git a/ru/stream.md b/ru/stream.md
@@ -17,7 +17,7 @@ type StreamWriter struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter возвращает структуру записи потока по заданному имени рабочего листа для создания нового рабочего листа с большими объемами данных. Обратите внимание, что после установки строк необходимо вызвать метод [`Flush`](stream.md#Flush), чтобы завершить процесс потоковой записи и убедиться, что порядок номеров строк возрастает. Например, задайте данные для рабочего листа размером `102400` строк x` 50` столбцов с номерами:
+NewStreamWriter возвращает структуру записи потока по заданному имени рабочего листа для создания нового рабочего листа с большими объемами данных. Обратите внимание, что после установки строк необходимо вызвать метод [`Flush`](stream.md#Flush), чтобы завершить процесс потоковой записи и убедиться, что порядок номеров строк возрастает, общий API и потоковый API нельзя смешивать для записи данных на рабочие листы. Например, задайте данные для рабочего листа размером `102400` строк x `50` столбцов с номерами:
 
 ```go
 file := excelize.NewFile()

diff --git a/ru/workbook.md b/ru/workbook.md
@@ -314,6 +314,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Пример 1:
 
@@ -394,6 +395,7 @@ ShowGridLines|bool
 ShowRowColHeaders|bool
 ZoomScale|float64
 TopLeftCell|string
+ShowZeros|bool
 
 - Пример 1, чтобы получить параметры свойства сетки для последнего представления на листе с именем `Sheet1`:
 

diff --git a/zh-hans/README.md b/zh-hans/README.md
@@ -9,7 +9,7 @@ Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基
 - go.dev: [pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc](https://pkg.go.dev/github.com/360EntSecGroup-Skylar/excelize/v2?tab=doc)
 - 许可协议: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
 - 当前版本: [v2.3.2](https://github.com/360EntSecGroup-Skylar/excelize/releases/latest)
-- 文档更新: 2021年1月18日
+- 文档更新: 2021年2月6日
 
 ## 项目使命