file open option More...

#include <ZFIODef_fwd.h>

Inheritance diagram for v_ZFIOOpenOption:

Public Types
enum
enum	ZFEnumType { e_Read , e_Write , e_Modify , ZFEnumCount , _ZFP_ZFEnumMax }
	see v_ZFIOOpenOption More...
Public Types inherited from ZFStyle
enum
Public Types inherited from ZFObject
enum

Public Member Functions
virtual const ZFClass *	classData (void)
	get instance's class info
zfself::ZFEnumType	zfv (void)
	util method to access original enum value
virtual const zfstring &	zfvTypeId (void)
	type id for this wrapper type
Public Member Functions inherited from ZFEnum
virtual void	objectInfoImpl (zfstring &ret)
	see objectInfo
virtual zfidentity	objectHashImpl (void)
	see objectHash
virtual ZFCompareResult	objectCompareImpl (ZFObject *anotherObj)
	compare result of two enum values as int, or return ZFCompareUncomparable if any of them are ZFEnumInvalid
virtual zfbool	objectIsInternal (void)
	whether this object is internal object or its class is ZFClass::classIsInternal
virtual zfbool	objectIsInternalPrivate (void)
	whether this object is internal private object or its class is ZFClass::classIsInternalPrivate
virtual void *	wrappedValue (void)
	access the value's address
virtual void	wrappedValue (const void *v)
	set the value, no type safe check
virtual void	wrappedValueCopy (void *v)
	get the value, no type safe check
virtual void	zfvReset (void)
	reset the value to it's init value
virtual zfbool	zfvIsInit (void)
	true if the value is in init value state
virtual zfbool	wrappedValuePreferStringConverter (void)
	whether prefer string converter during serialization, which would result much shorter result
virtual zfbool	zfvFromData (const ZFSerializableData &serializableData, zfstring outErrorHint=zft_zfnull, ZFSerializableData outErrorPos=zft_zfnull)
	convert from serializable data
virtual zfbool	zfvToData (ZFSerializableData &serializableData, zfstring *outErrorHint=zft_zfnull)
	convert to serializable data
virtual zfbool	zfvFromString (const zfchar src, zfindex srcLen=((zfindex) -1), zfstring errorHint=zft_zfnull)
	convert from string
virtual zfbool	zfvToString (zfstring &s, zfstring *errorHint=zft_zfnull)
	convert to string
virtual zfindex	enumCount (void)=0
	get value num
virtual zfindex	enumIndexForValue (zfuint value)=0
	get the index of enum value, or zfindexMax() if no such enum value
virtual zfuint	enumValueAt (zfindex index)=0
	get the value at index, or ZFEnumInvalid if not exist
virtual const zfstring &	enumNameAt (zfindex index)=0
	get the name at index, or ZFEnumNameInvalid if not exist
virtual zfbool	enumValueContain (zfuint value)=0
	return true if contain the specified value
virtual zfuint	enumValueForName (const zfstring &name)=0
	get the value with specified name, or ZFEnumInvalid if not exist
virtual const zfstring &	enumNameForValue (zfuint value)=0
	get the name with specified value, or ZFEnumNameInvalid if not exist
virtual zfbool	enumIsFlags (void)=0
	true if this enum type is flags type (which support bit operation)
virtual zfuint	enumDefault (void)=0
	default value of this enum
virtual zfuint const &	enumValue (void)
	get the enum value, or ZFEnumInvalid if invalid
virtual const zfstring &	enumName (void)
	get current value's name, or ZFEnumNameInvalid if invalid
virtual void	enumValue (zfuint const &value)
	set the enum value
virtual void	wrappedValueOnAssign (ZFTypeIdWrapper *ref)
	see zfvAssign
Public Member Functions inherited from ZFTypeIdWrapper
ZFTypeIdWrapper *	zfvAssign (ZFTypeIdWrapper *ref)
	copy internal value
Public Member Functions inherited from ZFObject
const ZFClass *	classDynamic (void)
	dynamic class of this object, see ZFClassDynamicRegister
zfindex	objectRetainCount (void)
	return the object's retain count
void	objectInfoOfInstanceT (zfstring &ret)
	see objectInfoOfInstance
zfstring	objectInfoOfInstance (void)
	return a short string describe the object instance
void	objectInfoT (zfstring &ret)
	see objectInfo
zfstring	objectInfo (void)
	return object info
zfidentity	objectHash (void)
	get hash of this object
ZFCompareResult	objectCompare (ZFObject *anotherObj)
	compare with anotherObj
ZFCompareResult	objectCompareValue (ZFObject *anotherObj)
	explicitly compare object by logical value, see objectCompare
virtual zfauto	invoke (const zfstring &methodName)
	util method to perform ZFDI_invoke, do nothing if fail
virtual zfauto	invoke (const zfstring &methodName, ZFObject param0, ZFObject param1=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param2=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param3=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param4=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param5=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param6=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param7=((ZFObject *const &) _ZFP_ZFMP_DEF))
	util method to perform ZFDI_invoke, do nothing if fail
virtual zfbool	invokeT (zfauto &ret, zfstring errorHint, const zfstring &methodName, ZFObject param0=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param1=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param2=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param3=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param4=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param5=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param6=((ZFObject const &) _ZFP_ZFMP_DEF), ZFObject param7=((ZFObject *const &) _ZFP_ZFMP_DEF))
	util method to perform ZFDI_invoke, do nothing if fail
virtual zfauto	invokeDetail (const zfstring &methodName, const ZFCoreArray< zfauto > &params, zfbool success=zft_zfnull, zfstring errorHint=zft_zfnull)
	util method to perform ZFDI_invoke, do nothing if fail
zfbool	objectTagExist (void)
	see objectTag, true if this object has tag, and tag can be checked by objectTagGetAllKeyValue
void	objectTag (const zfstring &key, ZFObject *tag)
	used to hold a object for app's use, auto retained
zfany	objectTag (const zfstring &key)
	see objectTag
void	objectTagGetAllKeyValue (ZFCoreArray< zfstring > &allKey, ZFCoreArray< zfauto > &allValue)
	get all key value
void	objectTagRemove (const zfstring &key)
	remove tag, same as set tag to null
zfauto	objectTagRemoveAndGet (const zfstring &key)
	remove tag, return removed tag or null if not exist
void	objectTagRemoveAll (void)
	remove all tag
void	observerAdd (zfidentity eventId, const ZFListener &observer, ZFLevel observerLevel=ZFLevelAppNormal)
	see observerNotify
void	observerAddForOnce (zfidentity eventId, const ZFListener &observer, ZFLevel observerLevel=ZFLevelAppNormal)
	see observerNotify
void	observerRemove (zfidentity eventId, const ZFListener &callback)
	see observerNotify
void	observerRemoveAll (zfidentity eventId)
	see observerNotify
void	observerRemoveAll (void)
	see observerNotify
zfbool	observerHasAdd (void)
	true if any observer has been added
zfbool	observerHasAdd (zfidentity eventId)
	true if any observer with eventId has been added
void	observerNotify (zfidentity eventId, ZFObject param0=zft_zfnull, ZFObject param1=zft_zfnull)
	notify the observer with eventId
void	observerNotifyWithSender (ZFObject customSender, zfidentity eventId, ZFObject param0=zft_zfnull, ZFObject *param1=zft_zfnull)
	see observerNotify
void	observerNotifyReversely (zfidentity eventId, ZFObject param0=zft_zfnull, ZFObject param1=zft_zfnull)
	see observerNotify
void	observerNotifyReverselyWithSender (ZFObject customSender, zfidentity eventId, ZFObject param0=zft_zfnull, ZFObject *param1=zft_zfnull)
	see observerNotify
ZFObserver &	observerHolder (void)
	access the internal observer holder
void	on (const zfstring &eventName, const ZFListener &observer, ZFLevel observerLevel=ZFLevelAppNormal)
	util to observerAdd
void	on (zfidentity eventId, const ZFListener &observer, ZFLevel observerLevel=ZFLevelAppNormal)
	util to observerAdd
void	onInit (const ZFListener &impl)
	util for script to achieve chained call
void	onDealloc (const ZFListener &impl)
	util for script to achieve chained call
zfbool	objectInstanceStateCheck (ZFObjectInstanceState state)
	object instance's state
zfbool	objectInitRunning (void)
	util method to check whether ZFObjectInstanceStateOnInit or ZFObjectInstanceStateOnInitFinish running
zfbool	objectDeallocRunning (void)
	util method to check whether ZFObjectInstanceStateOnDeallocPrepare or ZFObjectInstanceStateOnDealloc running
Public Member Functions inherited from ZFStyleable
virtual zfanyT< ZFStyleable >	defaultStyle (void)
	return default style of this instance
void	styleableCopyFrom (ZFObject *anotherStyleable)
	copy style from another styleable, see ZFStyleable
virtual zfbool	styleableIsDefaultStyle (void)
	true if this object is defaultStyle
void	styleablePropertyGetAllT (ZFCoreArray< const ZFProperty * > &ret)
	return a list of styleable property, for debug use only
ZFCoreArray< const ZFProperty * >	styleablePropertyGetAll (void)
	return a list of styleable property, for debug use only
void	styleKey (const zfstring &styleKey)
	see ZFStyleSet
const zfstring &	styleKey (void)
	see ZFStyleSet
void	propStyle (const zfstring &propertyName, const zfstring &styleKey)
	see ZFStyleSet
const zfstring &	propStyle (const zfstring &propertyName)
	see ZFStyleSet
Public Member Functions inherited from ZFInterface
virtual ZFObject *	toObject (void)=0
	convert to ZFObject type
Public Member Functions inherited from ZFSerializable
zfbool	serializable (void)
	true if object is currently serializable, see ZFSerializable
zfbool	serializeFromData (const ZFSerializableData &serializableData, zfstring outErrorHint=zft_zfnull, ZFSerializableData outErrorPos=zft_zfnull)
	serialize from data, see ZFSerializable
zfbool	serializeToData (ZFSerializableData &serializableData, zfstring outErrorHint=zft_zfnull, ZFSerializable refOwner=zft_zfnull)
	serialize to data, see ZFSerializable
zfbool	serializeFromString (const zfchar src, zfindex srcLen=((zfindex) -1), zfstring errorHint=zft_zfnull)
	serialize from string, return false by default
zfbool	serializeToString (zfstring &ret, zfstring *errorHint=zft_zfnull)
	see serializeFromString
void	serializablePropertyTypeGetAll (ZFCoreArray< const ZFProperty * > &notSerializableProperty, ZFCoreArray< const ZFProperty * > &serializableProperty, ZFCoreArray< const ZFProperty * > &embededProperty)
	return a list of each type of property, for debug use only
zfstring	serializablePropertyTypeInfo (void)
	return info of serializablePropertyTypeGetAll, for debug use only
void	serializableGetAllSerializablePropertyT (ZFCoreArray< const ZFProperty * > &ret)
	see serializableGetAllSerializableProperty
ZFCoreArray< const ZFProperty * >	serializableGetAllSerializableProperty (void)
	get all serializable property, usually for debug only, see serializableOnCheckPropertyType
void	serializableGetAllSerializableEmbededPropertyT (ZFCoreArray< const ZFProperty * > &ret)
	see serializableGetAllSerializableEmbededProperty
ZFCoreArray< const ZFProperty * >	serializableGetAllSerializableEmbededProperty (void)
	get all serializable embeded property, usually for debug only, see serializableOnCheckPropertyType
virtual void	serializableInfoT (zfstring &ret)
	get info as a serializable
virtual zfstring	serializableInfo (void)
	see serializableInfoT
Public Member Functions inherited from ZFCopyable
zfautoT< ZFCopyable >	copy (void)
	return a copy of this object
void	copyFrom (ZFObject *anotherObj)
	see copy, anotherObj must be same type as this object (by classData), otherwise, do nothing
Public Member Functions inherited from ZFProgressable
virtual zfbool	progressUpdate (ZFProgressable from, ZFProgressable to, zffloat progress)
	see ZFProgressable

Static Public Member Functions
static const ZFClass *	ClassData (void)
	get class info
static zfindex	EnumCount (void)
	get the count of enum value
static zfindex	EnumIndexForValue (zfuint value)
	get the index of enum value, or zfindexMax() if no such enum value
static zfuint	EnumValueAt (zfindex index)
	get the value at index, or ZFEnumInvalid if not exist
static const zfstring &	EnumNameAt (zfindex index)
	get the name at index, or ZFEnumNameInvalid if not exist
static zfbool	EnumValueContain (zfuint value)
	return true if contain the specified value
static zfuint	EnumValueForName (const zfstring &name)
	get value with name, or ZFEnumInvalid if not exist
static const zfstring &	EnumNameForValue (zfuint value)
	get name with value, or ZFEnumNameInvalid if not exist
static zfbool	EnumIsFlags (void)
	see ZFEnum::enumIsFlags
static v_ZFIOOpenOption::ZFEnumType	EnumDefault (void)
	default value for ZFIOOpenOption
Static Public Member Functions inherited from ZFEnum
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFTypeIdWrapper
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFStyle
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFObject
static const ZFClass *	ClassData (void)
	get class info
static zfidentity	E_ObjectBeforeAlloc (void)
	see ZFObject::observerNotify
static zfidentity	E_ObjectAfterAlloc (void)
	see ZFObject::observerNotify
static zfidentity	E_ObjectBeforeDealloc (void)
	see ZFObject::observerNotify
static zfidentity	E_ObjectPropertyValueOnUpdate (void)
	see ZFObject::observerNotify
static zfidentity	E_ObjectPropertyValueOnReset (void)
	see ZFObject::observerNotify
Static Public Member Functions inherited from ZFStyleable
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFInterface
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFSerializable
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFCopyable
static const ZFClass *	ClassData (void)
	get class info
Static Public Member Functions inherited from ZFProgressable
static const ZFClass *	ClassData (void)
	get class info

Protected Types
typedef ZFEnum	zfsuper
	class ref to super
typedef v_ZFIOOpenOption	zfself
	class ref to self
Protected Types inherited from ZFEnum
typedef ZFTypeIdWrapper	zfsuper
	class ref to super
typedef ZFEnum	zfself
	class ref to self
Protected Types inherited from ZFTypeIdWrapper
typedef ZFStyle	zfsuper
	class ref to super
typedef ZFTypeIdWrapper	zfself
	class ref to self
Protected Types inherited from ZFStyle
typedef ZFObject	zfsuper
	class ref to super
typedef ZFStyle	zfself
	class ref to self
Protected Types inherited from ZFObject
typedef _ZFP_Obj_Base	zfsuper
	class ref to super
typedef ZFObject	zfself
	class ref to self
Protected Types inherited from ZFStyleable
typedef ZFInterface	zfsuper
	typedef for super (always ZFInterface for an interface type)
typedef ZFStyleable	zfself
	typedef for self
Protected Types inherited from ZFInterface
typedef _ZFP_ObjI_Base	zfsuper
	typedef for super (always ZFInterface for an interface type)
typedef ZFInterface	zfself
	typedef for self
Protected Types inherited from ZFSerializable
typedef ZFInterface	zfsuper
	typedef for super (always ZFInterface for an interface type)
typedef ZFSerializable	zfself
	typedef for self
Protected Types inherited from ZFCopyable
typedef ZFInterface	zfsuper
	typedef for super (always ZFInterface for an interface type)
typedef ZFCopyable	zfself
	typedef for self
Protected Types inherited from ZFProgressable
typedef ZFInterface	zfsuper
	typedef for super (always ZFInterface for an interface type)
typedef ZFProgressable	zfself
	typedef for self

Additional Inherited Members
Protected Member Functions inherited from ZFEnum
virtual zfbool	serializableOnSerializeFromData (const ZFSerializableData &serializableData, zfstring outErrorHint=zft_zfnull, ZFSerializableData outErrorPos=zft_zfnull)
	for serializable data that has "category" attribute, ZFSerializable would ignore it and leave it to subclass to resolve, see ZFSerializable
virtual zfbool	serializableOnSerializeToData (ZFSerializableData &serializableData, zfstring outErrorHint=zft_zfnull, ZFSerializable refOwner=zft_zfnull)
	corresponding to serializableOnSerializeFromData, return whether the task is success, see ZFSerializable
virtual void	copyableOnCopyFrom (ZFObject *anotherObj)
	called by copy to copy contents from anotherObj
virtual void	objectOnInit (zfuint value)
	init with value or ZFEnumInvalid if invalid
virtual void	objectOnInit (ZFEnum *another)
	init with ZFEnum
virtual void	objectOnInit (void)
	override this to init your object
Protected Member Functions inherited from ZFTypeIdWrapper
virtual void	styleableOnCopyFrom (ZFObject *anotherStyleable)
	for subclass to achieve custom style copy step, called by styleableCopyFrom, see ZFStyleable
virtual zfbool	serializableOnSerializeFromString (const zfchar src, zfindex srcLen=((zfindex) -1), zfstring errorHint=zft_zfnull)
	see serializeFromString
virtual zfbool	serializableOnSerializeToString (zfstring &ret, zfstring *errorHint=zft_zfnull)
	see serializeFromString
Protected Member Functions inherited from ZFObject
virtual void	objectInfoImplAppend (zfstring &ret)
	see objectInfo
virtual ZFCompareResult	objectCompareValueImpl (ZFObject *anotherObj)
	see objectCompareValue
virtual void	observerOnAdd (zfidentity eventId)
	called when add first observer
virtual void	observerOnRemove (zfidentity eventId)
	called when remove last observer
virtual void	observerOnEvent (const ZFArgs &zfargs)
	notified when observerNotify
virtual void	objectOnInitFinish (void)
	called after objectOnInit, safe to call virtual functions here
virtual void	objectOnDeallocPrepare (void)
	called before objectOnDealloc, safe to call virtual functions here
virtual void	objectOnDealloc (void)
	override this to destroy your object
virtual void	objectOnRetain (void)
	called to retain object
virtual void	objectOnRelease (void)
	called to release object
virtual void	objectPropertyValueOnUpdate (const ZFProperty property, const void oldValue)
	see E_ObjectPropertyValueOnUpdate
virtual void	objectPropertyValueOnReset (const ZFProperty *property)
	see E_ObjectPropertyValueOnReset
Protected Member Functions inherited from ZFStyleable
virtual void	styleableOnCopyPropertyFrom (ZFObject anotherStyleable, const ZFProperty property)
	copy property with styleable logic
Protected Member Functions inherited from ZFSerializable
virtual ZFSerializablePropertyType	serializableOnCheckPropertyType (const ZFProperty *property)
	check the property type that serializable should do what while serializing
virtual zfbool	serializableOnCheck (void)
	see serializable
virtual zfbool	serializableOnSerializePropertyFromData (const ZFSerializableData &propertyData, const ZFProperty property, zfstring outErrorHint=zft_zfnull, ZFSerializableData *outErrorPos=zft_zfnull)
	see serializableOnCheckPropertyType, usually you have no need to override this method, see ZFSerializable
virtual zfbool	serializableOnSerializePropertyToData (ZFSerializableData &ownerData, const ZFProperty property, zfstring outErrorHint=zft_zfnull, ZFSerializable *refOwner=zft_zfnull)
	see serializableOnCheckPropertyType, usually you have no need to override this method, see ZFSerializable
virtual zfbool	serializableOnSerializeEmbededPropertyFromData (const ZFSerializableData &propertyData, const ZFProperty property, zfstring outErrorHint=zft_zfnull, ZFSerializableData *outErrorPos=zft_zfnull)
	see serializableOnCheckPropertyType, usually you have no need to override this method, see ZFSerializable
virtual zfbool	serializableOnSerializeEmbededPropertyToData (ZFSerializableData &ownerData, const ZFProperty property, ZFSerializable refOwner, zfstring *outErrorHint=zft_zfnull)
	see serializableOnCheckPropertyType, usually you have no need to override this method, see ZFSerializable
Protected Member Functions inherited from ZFProgressable
virtual zfbool	progressOnUpdate (ZFProgressable from, ZFProgressable to, zffloat progress)
	see ZFProgressable

Detailed Description

file open option

usage:

v_ZFIOOpenOption::e_Read
open for read only, fail if not exist
v_ZFIOOpenOption::e_Write
open for write only, create file if not exist, clear contents if exists
v_ZFIOOpenOption::e_Read | v_ZFIOOpenOption::e_Write
open for read and write, create file if not exist, clear contents if exists
v_ZFIOOpenOption::e_Modify
open for read and write, create file if not exist, keep contents if exists, position would be set to 0, seek to end to achieve "append" logic

difference to fopen's flag:

binary mode only
no a (append flag), recommended to use Modify + seek to simulate

Member Enumeration Documentation

◆ ZFEnumType

enum v_ZFIOOpenOption::ZFEnumType

see v_ZFIOOpenOption

Enumerator
e_Read	Read(1 << 0) read only
e_Write	Write(1 << 1) write only
e_Modify	Modify(1 << 2) modify
ZFEnumCount	max enum value

Member Function Documentation

◆ classData()

virtual const ZFClass * v_ZFIOOpenOption::classData ( void )

inlinevirtual

get instance's class info

Reimplemented from ZFEnum.

◆ zfvTypeId()

virtual const zfstring & v_ZFIOOpenOption::zfvTypeId ( void )

virtual

type id for this wrapper type

Implements ZFTypeIdWrapper.

The documentation for this class was generated from the following file:

ZFIODef_fwd.h

ZFFramework

Public Types

Public Member Functions

Static Public Member Functions