src/DataTypeWriterBase.h
author František Kučera <franta-hg@frantovo.cz>
Thu, 29 Nov 2018 22:30:12 +0100
branchv_0
changeset 29 142bdbba520f
parent 25 135ef93a4ac2
child 30 3f18cb7a6963
permissions -rw-r--r--
license: GNU GPLv3+
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
29
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     1
/**
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     2
 * Relational pipes
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     3
 * Copyright © 2018 František Kučera (Frantovo.cz, GlobalCode.info)
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     4
 *
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     5
 * This program is free software: you can redistribute it and/or modify
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     6
 * it under the terms of the GNU General Public License as published by
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     7
 * the Free Software Foundation, either version 3 of the License, or
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     8
 * (at your option) any later version.
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
     9
 *
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    10
 * This program is distributed in the hope that it will be useful,
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    13
 * GNU General Public License for more details.
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    14
 *
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    15
 * You should have received a copy of the GNU General Public License
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    16
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
142bdbba520f license: GNU GPLv3+
František Kučera <franta-hg@frantovo.cz>
parents: 25
diff changeset
    17
 */
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    18
#pragma once
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    19
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    20
#include <string>
25
135ef93a4ac2 imports, namespaces
František Kučera <franta-hg@frantovo.cz>
parents: 20
diff changeset
    21
#include "../include/relpipe/writer/TypeId.h"
20
bef6648e79b1 relpipe-lib-writer: move public header files to: include/relpipe/writer/
František Kučera <franta-hg@frantovo.cz>
parents: 19
diff changeset
    22
#include "../include/relpipe/writer/typedefs.h"
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    23
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    24
namespace relpipe {
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    25
namespace writer {
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    26
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    27
/**
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    28
 * This class contains common features that are independent from particular data type (generic/template type)
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    29
 */
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    30
class DataTypeWriterBase {
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    31
private:
15
8fd6c4d44071 use more TypeId enum
František Kučera <franta-hg@frantovo.cz>
parents: 9
diff changeset
    32
	const TypeId typeId;
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    33
	const string_t typeCode;
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    34
public:
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    35
15
8fd6c4d44071 use more TypeId enum
František Kučera <franta-hg@frantovo.cz>
parents: 9
diff changeset
    36
	DataTypeWriterBase(const TypeId typeId, const string_t typeCode) :
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    37
	typeId(typeId), typeCode(typeCode) {
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    38
	}
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    39
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    40
	virtual ~DataTypeWriterBase() {
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    41
	};
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    42
4
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    43
	/**
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    44
	 * @param output output stream, should be at position where the value is to be written; the stream will not be closed not flushed after writing
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    45
	 * @param stringValue write value as given data type (e.g. integer or boolean); stringValue parameter contains given value in string representation of given data type
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    46
	 * E.g. integer 123 is passed as a character string "123"
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    47
	 * boolean true is passed as a character string "true".
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    48
	 * See Relational pipes format specification for details.
e6db28447957 documentation for readString() and writeString() methods
František Kučera <franta-hg@frantovo.cz>
parents: 3
diff changeset
    49
	 */
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    50
	virtual void writeString(std::ostream& output, const string_t &stringValue) = 0;
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    51
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    52
	/**
16
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    53
	 * @param output output stream, should be at position where the value is to be written; the stream will not be closed not flushed after writing
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    54
	 * @param value raw pointer to the value, must exactly match data type of this writer
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    55
	 * @param type used as a safety mechanism to avoid wrong pointer interpretation;
18
90efe2db1ca8 documentation for RelationalWriter and DataTypeWriterBase
František Kučera <franta-hg@frantovo.cz>
parents: 16
diff changeset
    56
	 * should be called in this way: writeRaw(output, &value, typeid(value));
16
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    57
	 * if the type does not match, the RelpipeWriterException is thrown
19
98b901d7bb95 ASan: add AddressSanitizer g++ option: -fsanitize=address
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
    58
	 * 
98b901d7bb95 ASan: add AddressSanitizer g++ option: -fsanitize=address
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
    59
	 * TODO: typeid() / type_info seems working but consider also sizeof() / size_t and teplates
16
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    60
	 */
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    61
	virtual void writeRaw(std::ostream& output, const void * value, const std::type_info& type) = 0;
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    62
3613617d3076 writeAttribute() with raw pointer and type_info
František Kučera <franta-hg@frantovo.cz>
parents: 15
diff changeset
    63
	/**
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    64
	 * @param dataType data type code as defined in DDP L0
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    65
	 * @return whether this class supports conversions of this type
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    66
	 */
15
8fd6c4d44071 use more TypeId enum
František Kučera <franta-hg@frantovo.cz>
parents: 9
diff changeset
    67
	virtual bool supports(const TypeId &dataType) {
9
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    68
		return dataType == typeId;
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    69
	}
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    70
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    71
	/**
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    72
	 * @param dataType data type name as defined in DDP L0
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    73
	 * @return whether this class supports conversions of this type
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    74
	 */
9
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    75
	virtual bool supports(const string_t &dataType) {
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    76
		return dataType == typeCode;
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    77
	}
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    78
15
8fd6c4d44071 use more TypeId enum
František Kučera <franta-hg@frantovo.cz>
parents: 9
diff changeset
    79
	TypeId getTypeId() {
9
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    80
		return typeId;
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    81
	}
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    82
9
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    83
	string_t getTypeCode() {
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    84
		return typeCode;
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    85
	}
1
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    86
};
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    87
6e3494943c91 base classes
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    88
}
9
0a40752e401d shared library with pure abstract class (interface)
František Kučera <franta-hg@frantovo.cz>
parents: 5
diff changeset
    89
}