/* * Copyright (c) 2019 TAOS Data, Inc. * * This program is free software: you can use, redistribute, and/or modify * it under the terms of the GNU Affero General Public License, version 3 * or later ("AGPL"), as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */ #ifndef _TD_DATA_FORMAT_H_ #define _TD_DATA_FORMAT_H_ #include #include #include // #include "schema.h" #ifdef __cplusplus extern "C" { #endif // ----------------- Data row structure /* A data row, the format is like below: * +---------+---------------------------------+ * | int32_t | | * +---------+---------------------------------+ * | len | row | * +---------+---------------------------------+ * len: the length including sizeof(row) + sizeof(len) * row: actual row data encoding */ typedef void *SDataRow; #define dataRowLen(r) (*(int32_t *)(r)) #define dataRowTuple(r) ((char *)(r) + sizeof(int32_t)) #define dataRowSetLen(r, l) (dataRowLen(r) = (l)) #define dataRowIdx(r, i) ((char *)(r) + i) #define dataRowCpy(dst, r) memcpy((dst), (r), dataRowLen(r)) SDataRow tdNewDataRow(int32_t bytes); // SDataRow tdNewDdataFromSchema(SSchema *pSchema); void tdFreeDataRow(SDataRow row); // int32_t tdAppendColVal(SDataRow row, void *value, SColumn *pCol, int32_t suffixOffset); void tdDataRowCpy(void *dst, SDataRow row); void tdDataRowReset(SDataRow row); SDataRow tdDataRowDup(SDataRow row); /* Data rows definition, the format of it is like below: * +---------+-----------------------+--------+-----------------------+ * | int32_t | | | | * +---------+-----------------------+--------+-----------------------+ * | len | SDataRow | .... | SDataRow | * +---------+-----------------------+--------+-----------------------+ */ typedef void *SDataRows; #define TD_DATA_ROWS_HEAD_LEN sizeof(int32_t) #define dataRowsLen(rs) (*(int32_t *)(rs)) #define dataRowsSetLen(rs, l) (dataRowsLen(rs) = (l)) #define dataRowsInit(rs) dataRowsSetLen(rs, sizeof(int32_t)) void tdDataRowsAppendRow(SDataRows rows, SDataRow row); // Data rows iterator typedef struct { int32_t totalLen; int32_t len; SDataRow row; } SDataRowsIter; void tdInitSDataRowsIter(SDataRows rows, SDataRowsIter *pIter); SDataRow tdDataRowsNext(SDataRowsIter *pIter); /* Data column definition * +---------+---------+-----------------------+ * | int32_t | int32_t | | * +---------+---------+-----------------------+ * | len | npoints | data | * +---------+---------+-----------------------+ */ typedef char *SDataCol; /* Data columns definition * +---------+---------+-----------------------+--------+-----------------------+ * | int32_t | int32_t | | | | * +---------+---------+-----------------------+--------+-----------------------+ * | len | npoints | SDataCol | .... | SDataCol | * +---------+---------+-----------------------+--------+-----------------------+ */ typedef char *SDataCols; #ifdef __cplusplus } #endif #endif // _TD_DATA_FORMAT_H_