/** * Copyright (c) 2021 Dominic Masters * * This software is released under the MIT License. * https://opensource.org/licenses/MIT */ #pragma once #include #include "asset.h" #include "../util/array.h" /** * Buffer each cell within a CSV Asset Buffer with a callback. * * @param asset Asset to buffer the CSV from. * @param callback Callback to fire for each cell parsed. * @param user Pointer to any custom user data. * @return The result of the CSV Buffer Operation. */ csvbufferresult_t csvBuffer( assetbuffer_t *asset, csvbuffercallback_t *callback, void *user ); /** Callback for when the CSV Row Buffer is parsing a row */ bool _csvBufferRowParserCallback( assetbuffer_t *asset, void *user, int32_t row, int32_t column, char *data ); /** * Buffer each row within a CSV Asset Buffer with a callback. * * @param asset Asset to buffer the CSV from. * @param callback Callback to fire when a row is parsed. * @param user Pointer to any custom user data. * @return The result of the CSV Buffer Operation. */ csvbufferresult_t csvBufferRow( assetbuffer_t *asset, csvbufferrowcallback_t *callback, void *user ); /** Parser that the header parser buffer uses. */ bool _csvBufferRowWithHeadersCallback( assetbuffer_t *asset, void *user, int32_t row, csvrow_t *csv ); /** * Buffer each row within a CSV Asset Buffer with a callback. This will also * provide the callback with the header row (The first row), already parsed. * * @param asset * @param callback * @param user * @return csvbufferresult_t */ csvbufferresult_t csvBufferRowWithHeaders( assetbuffer_t *asset, csvbufferrowwitheaderscallback_t *callback, void *user ); /** * Essentially a CSV Row Cloner, copies data from one CSV row to another and * updates the char pointers for you. * * @param source The source CSV row to copy from. * @param dest The destination CSV row to copy to. */ void csvRowPopulate(csvrow_t *source, csvrow_t *dest); /** Callback used to parse and get the headers row */ bool _csvHeadersGetCallback( assetbuffer_t *asset, void *user, int32_t row, csvrow_t *current ); /** * Parses just the headers row from a CSV and stores the output into the * provided buffers. * * @param asset Asset to get the headers from. * @param row The CSV Row to store the headers data in. * @return The result of the buffer operation. */ csvbufferresult_t csvHeadersGet(assetbuffer_t *asset, csvrow_t *row); /** * Gets the column index within the CSV Row for the specific key. * @param row Row to get from. * @param key Key to search for * @return The column index for the key, or -1 if not found. */ int32_t csvColumnGetIndex(csvrow_t *row, char *key); /** Callback to use while scanning the CSV to find the matching row */ bool _csvRowSearchCallback( assetbuffer_t *asset, void *user, int32_t row, csvrow_t *csv ); /** * Search the CSV for a matching row. Will return data only if the given column * matches the given value. * * @param asset Asset buffer to search. * @param row Where the returned row will be stored. * @param column Column to check. * @param value Value to check in that column * @return The row index that the result was found on, or -1 if not found. */ int32_t csvRowSearch( assetbuffer_t *asset, csvrow_t *row, int32_t column, char *value );