Proyectos de Subversion Iphone Microlearning

// Copyright 2019 Google

//

// Licensed under the Apache License, Version 2.0 (the "License");

// you may not use this file except in compliance with the License.

// You may obtain a copy of the License at

//

//      http://www.apache.org/licenses/LICENSE-2.0

//

// Unless required by applicable law or agreed to in writing, software

// distributed under the License is distributed on an "AS IS" BASIS,

// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

// See the License for the specific language governing permissions and

// limitations under the License.

#pragma once

#include <stdbool.h>

#include <stdint.h>

#include <sys/cdefs.h>

// Required for 1P builds

#include <stddef.h>

#include <sys/types.h>

#include <unistd.h>

#if defined(__OBJC__)

#import <Foundation/Foundation.h>

#endif

__BEGIN_DECLS

typedef struct {

  int fd;

  int collectionDepth;

  bool needComma;

  bool bufferWrites;

  char* writeBuffer;

  size_t writeBufferLength;

  off_t writtenLength;

} FIRCLSFile;

typedef FIRCLSFile* FIRCLSFileRef;

#define CLS_FILE_MAX_STRING_LENGTH (10240)

#define CLS_FILE_HEX_BUFFER \

  (32)  // must be at least 2, and should be even (to account for 2 chars per hex value)

#define CLS_FILE_MAX_WRITE_ATTEMPTS (50)

extern const size_t FIRCLSWriteBufferLength;

// make sure to stop work if either FIRCLSFileInit... method returns false, because the FIRCLSFile

// struct will contain garbage data!

bool FIRCLSFileInitWithPath(FIRCLSFile* file, const char* path, bool bufferWrites);

bool FIRCLSFileInitWithPathMode(FIRCLSFile* file,

                                const char* path,

                                bool appendMode,

                                bool bufferWrites);

void FIRCLSFileFlushWriteBuffer(FIRCLSFile* file);

bool FIRCLSFileClose(FIRCLSFile* file);

bool FIRCLSFileCloseWithOffset(FIRCLSFile* file, off_t* finalSize);

bool FIRCLSFileIsOpen(FIRCLSFile* file);

bool FIRCLSFileLoopWithWriteBlock(const void* buffer,

                                  size_t length,

                                  ssize_t (^writeBlock)(const void* partialBuffer,

                                                        size_t partialLength));

bool FIRCLSFileWriteWithRetries(int fd, const void* buffer, size_t length);

// writing

void FIRCLSFileWriteSectionStart(FIRCLSFile* file, const char* name);

void FIRCLSFileWriteSectionEnd(FIRCLSFile* file);

void FIRCLSFileWriteHashStart(FIRCLSFile* file);

void FIRCLSFileWriteHashEnd(FIRCLSFile* file);

void FIRCLSFileWriteHashKey(FIRCLSFile* file, const char* key);

void FIRCLSFileWriteHashEntryUint64(FIRCLSFile* file, const char* key, uint64_t value);

void FIRCLSFileWriteHashEntryInt64(FIRCLSFile* file, const char* key, int64_t value);

void FIRCLSFileWriteHashEntryString(FIRCLSFile* file, const char* key, const char* value);

void FIRCLSFileWriteStringUnquoted(FIRCLSFile* file, const char* string);

#if defined(__OBJC__)

void FIRCLSFileWriteHashEntryNSString(FIRCLSFile* file, const char* key, NSString* string);

void FIRCLSFileWriteHashEntryNSStringUnlessNilOrEmpty(FIRCLSFile* file,

                                                      const char* key,

                                                      NSString* string);

#endif

void FIRCLSFileWriteHashEntryHexEncodedString(FIRCLSFile* file, const char* key, const char* value);

void FIRCLSFileWriteHashEntryBoolean(FIRCLSFile* file, const char* key, bool value);

void FIRCLSFileWriteArrayStart(FIRCLSFile* file);

void FIRCLSFileWriteArrayEnd(FIRCLSFile* file);

void FIRCLSFileWriteArrayEntryUint64(FIRCLSFile* file, uint64_t value);

void FIRCLSFileWriteArrayEntryString(FIRCLSFile* file, const char* value);

void FIRCLSFileWriteArrayEntryHexEncodedString(FIRCLSFile* file, const char* value);

void FIRCLSFileFDWriteUInt64(int fd, uint64_t number, bool hex);

void FIRCLSFileFDWriteInt64(int fd, int64_t number);

void FIRCLSFileWriteUInt64(FIRCLSFile* file, uint64_t number, bool hex);

void FIRCLSFileWriteInt64(FIRCLSFile* file, int64_t number);

#if defined(__OBJC__) && TARGET_OS_MAC

NSArray* FIRCLSFileReadSections(const char* path,

                                bool deleteOnFailure,

                                NSObject* (^transformer)(id obj));

NSString* FIRCLSFileHexEncodeString(const char* string);

NSString* FIRCLSFileHexDecodeString(const char* string);

#endif

__END_DECLS