Filename API Functions - Versionsgeschichte

Cg: /* Contents */

2025-03-29T19:01:40Z

Contents

← Nächstältere Version		Version vom 29. März 2025, 19:01 Uhr
Zeile 260:		Zeile 260:
	The following functions read/write the whole contents of a file as one possibly big data object.		The following functions read/write the whole contents of a file as one possibly big data object.
	<br>You should not use them for very large files, as they might allocate/require large amounts of memory;		<br>You should not use them for very large files, as they might allocate/require large amounts of memory;
	<br>use stream functions instead (and process it linewise, blockwise or characterwise).		<br>use [[Stream_API Functions\|stream functions]] instead (and process it linewise, blockwise or characterwise).

	:''aFilename'' '''contents'''		:''aFilename'' '''contents'''

Cg: /* Contents */

2025-03-29T19:00:57Z

Contents

← Nächstältere Version		Version vom 29. März 2025, 19:00 Uhr
Zeile 260:		Zeile 260:
	The following functions read/write the whole contents of a file as one possibly big data object.		The following functions read/write the whole contents of a file as one possibly big data object.
	<br>You should not use them for very large files, as they might allocate/require large amounts of memory;		<br>You should not use them for very large files, as they might allocate/require large amounts of memory;
	<br>use stream functions instead.		<br>use stream functions instead (and process it linewise, blockwise or characterwise).

	:''aFilename'' '''contents'''		:''aFilename'' '''contents'''

Cg: /* Contents */

2023-08-08T08:34:23Z

Contents

← Nächstältere Version		Version vom 8. August 2023, 08:34 Uhr
Zeile 259:		Zeile 259:
	=== Contents===		=== Contents===
	The following functions read/write the whole contents of a file as one possibly big data object.		The following functions read/write the whole contents of a file as one possibly big data object.
	You should not use them for very large files, as they might allocate/require large amounts of memory.		<br>You should not use them for very large files, as they might allocate/require large amounts of memory;
			<br>use stream functions instead.

	:''aFilename'' '''contents'''		:''aFilename'' '''contents'''

Cg: /* Streaming */

2023-08-08T08:32:18Z

Streaming

← Nächstältere Version		Version vom 8. August 2023, 08:32 Uhr
Zeile 256:		Zeile 256:

	Notice that there are many more enumeration/filter functions provided by the Filename class. Use a class browser or consult the [http://live.exept.de/ClassDoc/classDocOf:,Filename full online documentation].		Notice that there are many more enumeration/filter functions provided by the Filename class. Use a class browser or consult the [http://live.exept.de/ClassDoc/classDocOf:,Filename full online documentation].

			=== Contents===
			The following functions read/write the whole contents of a file as one possibly big data object.
			You should not use them for very large files, as they might allocate/require large amounts of memory.

			:''aFilename'' '''contents'''
			::Returns a collection of text-lines (i.e. an Array-like object where each element represents one line of text)
			:''aFilename'' '''contentsAsString'''
			::Returns a single (possibly big) string, a collection of characters
			:''aFilename'' '''binaryContents'''
			::Returns a single (possibly big) byte array, a collection of integers in the range 0..255

			:''aFilename'' '''contents:''' ''aStringOrByteArrayOrCollectionOfLines''
			::Creates (i.e. writes) the file.
			::Examples:
			:::<code> 'foo1' asFilename contents:'Hello world'.</code>
			:::<code> 'foo2' asFilename contents:#[1 2 3 4 0xFF 0xFE 0xFD].</code>
			:::<code> 'foo3' asFilename contents:#('line1' 'line2' 'line3').</code>

	=== Streaming ===		=== Streaming ===

Cg: /* Streaming */

2023-08-08T08:25:13Z

Streaming

← Nächstältere Version		Version vom 8. August 2023, 08:25 Uhr
Zeile 272:		Zeile 272:
	:::<code>nextNumber := Number readFrom:s</code>		:::<code>nextNumber := Number readFrom:s</code>
	:::<code>s close</code></code>		:::<code>s close</code></code>

			:''aFilename'' '''utf8ReadStream'''
			:''aFilename'' '''utf8WriteStream'''
			::Return a stream for reading or writing to the file. The stream will automatically generate/convert utf8 code sequences; i.e. the stream will not deliver/expect escape sequences, but possibly character instances with codepoints above 0xFF.
			::Example:
			::Writing as UTF8, reading binary:
			:::<code>\|s bytes\|</code>
			:::<code>s := 'test.dat' asFilename utf8WriteStream.</code>
			:::<code>s nextPutLine:'αβγψω⮠'.</code>
			:::<code>s close.</code></code>
			:::<code>bytes := 'test.dat' asFilename binaryContents.</code>
			:::<code>bytes.</code>
			:::
			:::=> #[206 177 206 178 206 179 207 136 207 137 226 174 160 10]
			:::
			::Reading UTF8:
			:::<code>\|s text\|</code>
			:::<code>s := 'test.dat' asFilename utf8ReadStream.</code>
			:::<code>text := s nextLine.</code>
			:::<code>s close.</code></code>
			:::<code>text.</code>
			:::
			:::=> 'αβγψω⮠' (a widestring)

Cg: /* Enumerating Directory Contents */

2023-08-08T08:15:41Z

Enumerating Directory Contents

← Nächstältere Version		Version vom 8. August 2023, 08:15 Uhr
Zeile 255:		Zeile 255:
	:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']</code>		:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']</code>

	Notice that there are many more enumeration/filter functions provided by the Filename class. Use a class browser or consult the full online documentation.		Notice that there are many more enumeration/filter functions provided by the Filename class. Use a class browser or consult the [http://live.exept.de/ClassDoc/classDocOf:,Filename full online documentation].

	=== Streaming ===		=== Streaming ===

Cg: /* Enumerating Directory Contents */

2023-08-08T08:14:49Z

Enumerating Directory Contents

← Nächstältere Version		Version vom 8. August 2023, 08:14 Uhr
Zeile 254:		Zeile 254:
	::to enumerate all files and folders under a top folder, but only in subfolders named "Font", you could write:		::to enumerate all files and folders under a top folder, but only in subfolders named "Font", you could write:
	:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']</code>		:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']</code>

			Notice that there are many more enumeration/filter functions provided by the Filename class. Use a class browser or consult the full online documentation.

	=== Streaming ===		=== Streaming ===

Cg: /* Enumerating Directory Contents */

2023-08-08T08:13:46Z

Enumerating Directory Contents

← Nächstältere Version		Version vom 8. August 2023, 08:13 Uhr
Zeile 251:		Zeile 251:
	::Example:		::Example:
	::to enumerate all files and folders under a top folder, but not in folders named "*.tmp", you could write:		::to enumerate all files and folders under a top folder, but not in folders named "*.tmp", you could write:
	:::<code>'c:\myDir' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| (dir hasSuffix:'tmp') not]		:::<code>'c:\myDir' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| (dir hasSuffix:'tmp') not]</code>
	::to enumerate all files and folders under a top folder, but only in subfolders named "Font", you could write:		::to enumerate all files and folders under a top folder, but only in subfolders named "Font", you could write:
	:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']		:::<code>'c:\Windows' asFilename recursiveDirectoryContentsDo:[:eachFile \| ... ] filterForVisitingDirectories:[:dir \| dir baseName = 'Fonts']</code>

	=== Streaming ===		=== Streaming ===

Cg: /* Enumerating Directory Contents */

2023-08-08T08:13:10Z

Enumerating Directory Contents

← Nächstältere Version		Version vom 8. August 2023, 08:13 Uhr
Zeile 235:		Zeile 235:

	:''aFilename'' '''allDirectoriesDo:''' ''aOneArgBlock''		:''aFilename'' '''allDirectoriesDo:''' ''aOneArgBlock''
	:''aFilename''.'''~~alLDirectoriesDo~~'''(''aOneArgLambdaOrFunction'') [JS]		:''aFilename''.'''allDirectoriesDo'''(''aOneArgLambdaOrFunction'') [JS]
	::Same as above, but recurses into sub-directories (i.e. the whole tree of directories is enumerated)		::Same as above, but recurses into sub-directories (i.e. the whole tree of directories is enumerated)

Cg: /* Directory Contents */

2023-08-08T08:12:47Z

Directory Contents

@@ Zeile 224: / Zeile 224: @@
 :::<code>'c:\' asFilename directories</code>
 :::=> #( ... 'c:\Program Files' ...)
 === Streaming ===