# opencsv

**Repository Path**: ludisi/opencsv

## Basic Information

- **Project Name**: opencsv
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 16
- **Created**: 2022-06-11
- **Last Updated**: 2022-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCSV
## OpenCSV简介
   现在好多的网站中导出的文件会出现一种csv文件，我们接下来学习一下csv文件的导出方式。

CSV文件：Comma-Separated Values，中文叫逗号分隔值或者字符分割值，其文件以纯文本的形式存储表格数据。该文件是一个字符序列，可以由任意数目的记录组成，记录间以某种换行符分割。每条记录由字段组成，字段间的分隔符是其他字符或者字符串。所有的记录都有完全相同的字段序列，相当于一个结构化表的纯文本形式。
用文本文件、excel或者类似与文本文件的编辑器都可以打开CSV文件。

## 下载安装
```shell
npm install @ohos/opencsv --save
```
OpenHarmony npm环境配置等更多内容，请参考 [如何安装OpenHarmony npm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md) 。

## 使用说明
写入数据
```javascript
import { getPath, openSync,CSVWriter } from '@ohos/opencsv';
getPath().then((path) => {
   let fd = openSync(path,'test.csv'/* csv文件名 */,0o2 | 0o100, 0o666);
   let writer = new CSVWriter(fd);
   writer.writeNext([1,'张三',18], true); // 写入数据
   writer.writeNext([2,'李四',19], true);
   writer.writeNext([3,'王五',20], true);
   writer.writeNext([4,'赵六',21], true);
   writer.close(); // 写入关闭
})
```

读取数据

```typescript
import { getPath, openSync,CSVReaderBuilder,CSVParser } from '@ohos/opencsv';
getPath().then((path) => {
    let rd = openSync(path, 'test.csv'/* csv文件名 */, 0o2)
    let readerBuilder: CSVReaderBuilder = new CSVReaderBuilder(rd)
    let readerbuildcsv = readerBuilder
          .withCSVParser(new CSVParser())
          .buildCSVReader()
    let lines: Array<Array<string>> = null;
    lines = readerbuildcsv.readAll() // 读取csv文件中所有数据
    console.log(lines)
    /* [
     *  [1,'张三',18]
     *  [2,'李四',19]
     *  [3,'王五',20]
     *  [4,'赵六',21]
     *               ]
     */
    readerbuildcsv.close() //读取关闭
})
```
## 接口说明

## 兼容性
支持 OpenHarmony API version 8 及以上版本。

## 目录结构
````
|---- opencsv 
|     |---- entry  # 示例代码文件夹
|     |---- opencsv  # opencsv库文件夹
|           |---- index.ets  # 对外接口
|     |---- README.md  # 安装使用方法                    
````

## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/openharmony-tpc/VCard/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/openharmony-tpc/VCard/pulls) 。

## 开源协议
本项目基于 [Apache License 2.0](https://gitee.com/openharmony-tpc/VCard/blob/master/LICENSE) ，请自由地享受和参与开源。