Path Name Handling - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:23:44Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:23, 26 January 2025
Line 8:		Line 8:
	follows the last separator character, "/"). The last part of the string is normally a file or directory name.		follows the last separator character, "/"). The last part of the string is normally a file or directory name.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	STRPTR FilePart(STRPTR mypath);		STRPTR FilePart(STRPTR mypath);
	</syntaxhighlight>		</syntaxhighlight>
Line 16:		Line 16:
	The PathPart() function returns a pointer to the last character in the path string that doesn't include the file name (usually the separator character "/"):		The PathPart() function returns a pointer to the last character in the path string that doesn't include the file name (usually the separator character "/"):

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	STRPTR PathPart(STRPTR mypath);		STRPTR PathPart(STRPTR mypath);
	</syntaxhighlight>		</syntaxhighlight>
Line 68:		Line 68:
	== Example ==		== Example ==

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	// Part.c - File/Path separator example.		// Part.c - File/Path separator example.

Line 281:		Line 281:
	The dos.library AddPart() function lets you append a file or directory name to the end of a (relative) path, inserting any necessary separator characters:		The dos.library AddPart() function lets you append a file or directory name to the end of a (relative) path, inserting any necessary separator characters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	BOOL AddPart(STRPTR mypathname, STRPTR myfilename, uint32 mysize);		BOOL AddPart(STRPTR mypathname, STRPTR myfilename, uint32 mysize);
	</syntaxhighlight>		</syntaxhighlight>
Line 292:		Line 292:
	Another dos.library function called SplitName() makes it possible to extract individual volume/device, directory, or file names (referred to here as path components) from a path string:		Another dos.library function called SplitName() makes it possible to extract individual volume/device, directory, or file names (referred to here as path components) from a path string:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	int16 = SplitName(STRPTR mypathname, uint8 separatorchar, STRPTR buffer, int16 oldposition, int32 buffersize);		int16 = SplitName(STRPTR mypathname, uint8 separatorchar, STRPTR buffer, int16 oldposition, int32 buffersize);
	</syntaxhighlight>		</syntaxhighlight>
Line 309:		Line 309:
	== Example ==		== Example ==

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	// Split.c - SplitName() example		// Split.c - SplitName() example

Steven Solie: /* AddPart() */

2013-03-28T16:55:02Z

AddPart()

← Older revision		Revision as of 16:55, 28 March 2013
Line 282:		Line 282:

	<syntaxhighlight>		<syntaxhighlight>
	BOOL AddPart(~~UBYTE~~ mypathname, ~~UBYTE~~ myfilename, ~~ULONG~~ mysize);		BOOL AddPart(STRPTR mypathname, STRPTR myfilename, uint32 mysize);
	</syntaxhighlight>		</syntaxhighlight>

Steven Solie: /* FilePart() and PathPart() */

2013-03-28T16:53:08Z

FilePart() and PathPart()

← Older revision		Revision as of 16:53, 28 March 2013
Line 26:		Line 26:
	Neither FilePart() nor PathPart() check the syntax of the path string passed to them, so if your application passes an invalid path to them, they will pass back equally invalid path fragments. Also, they do not process any of the wildcard tokens, treating them as normal characters. The following chart summarizes the possible results of the FilePart() and PathPart() functions. It assumes that the path supplied to the functions is valid.		Neither FilePart() nor PathPart() check the syntax of the path string passed to them, so if your application passes an invalid path to them, they will pass back equally invalid path fragments. Also, they do not process any of the wildcard tokens, treating them as normal characters. The following chart summarizes the possible results of the FilePart() and PathPart() functions. It assumes that the path supplied to the functions is valid.

			{\| class="wikitable"
	wholepath is the path passed to FilePart() and PathPart(), pathpart is result of PathPart() ~~and~~ filepart is the result of FilePart().		!colspan="2" \| wholepath is the path passed to FilePart() and PathPart()<br/>pathpart is result of PathPart()<br/>filepart is the result of FilePart()

			\|-
	1. If (wholepath != pathpart != filepart), then filepart points to the the file or directory name in wholepath and pathpart points to the '/' before the file or directory name in wholepath. ~~For example:~~		\| If (wholepath != pathpart != filepart) then filepart points to the the file or directory name in wholepath and pathpart points to the '/' before the file or directory name in wholepath.
			\|
	wholepath: "ram:t/tmpfile"		wholepath: "ram:t/tmpfile"
	Filepart: "tmpfile"		Filepart: "tmpfile"
Line 36:		Line 38:
	Filepart: "tmpfile"		Filepart: "tmpfile"
	Pathpart: "/tmpfile"		Pathpart: "/tmpfile"
			\|-

	2. If (wholepath != pathpart == filepart), then filepart and pathpart point to a file or a directory name preceded by a volume name or series of separator characters. ~~For example:~~		\| If (wholepath != pathpart == filepart) then filepart and pathpart point to a file or a directory name preceded by a volume name or series of separator characters.
			\|
	wholepath: "ram:tmpfile"		wholepath: "ram:tmpfile"
	Filepart: "tmpfile"		Filepart: "tmpfile"
Line 45:		Line 48:
	Filepart: "tmpfile"		Filepart: "tmpfile"
	Pathpart: "tmpfile"		Pathpart: "tmpfile"
			\|-

	3. If (wholepath == pathpart == filepart) then pathpart points to either a file or a directory name. This name is not preceded by a volume name.		\| If (wholepath == pathpart == filepart) then pathpart points to either a file or a directory name. This name is not preceded by a volume name.
			\|
	wholepath: "tmpfile"		wholepath: "tmpfile"
	Filepart: "tmpfile"		Filepart: "tmpfile"
	Pathpart: "tmpfile"		Pathpart: "tmpfile"
			\|-

	4. If (pathpart[0] == 0), then path points to either "" (current directory), a series of separators ("/", "//", ":", etc.), or a volume/device name.		\| If (pathpart[0] == 0) then path points to either "" (current directory), a series of separators ("/", "//", ":", etc.), or a volume/device name.
			\|
	wholepath: "////"		wholepath: "////"
	Filepart: ""		Filepart: ""
Line 59:		Line 64:
	Filepart: ""		Filepart: ""
	Pathpart: ""		Pathpart: ""
			\|}

	== Example ==		== Example ==

Steven Solie: /* SplitName() */

2013-03-28T15:32:16Z

SplitName()

← Older revision		Revision as of 15:32, 28 March 2013
Line 300:		Line 300:

	If SplitName() runs out of room in the buffer, it will copy as much of the characters as it can fit (buffersize - 1) and will write a NULL into the last position in the buffer. Also, if SplitName() runs out of room in the buffer and it finds another separator character, the position it returns will not be of the character that follows the separator character. Instead, SplitName() will return the position of the actual separator character.		If SplitName() runs out of room in the buffer, it will copy as much of the characters as it can fit (buffersize - 1) and will write a NULL into the last position in the buffer. Also, if SplitName() runs out of room in the buffer and it finds another separator character, the position it returns will not be of the character that follows the separator character. Instead, SplitName() will return the position of the actual separator character.

			== Example ==

			<syntaxhighlight>
			// Split.c - SplitName() example

			#include <exec/memory.h>
			#include <dos/dosextens.h>
			#include <dos/rdargs.h>

			#include <proto/exec.h>
			#include <proto/dos.h>

			#define BUFFERSIZE 128

			int main()
			{
			struct RDArgs *readargs;
			LONG rargs[2];
			UBYTE filename, buffer;
			ULONG buffersize;
			WORD position = 0;
			LONG vargs[4];

			/* See the DOS Autodocs for more information about ReadArgs() */
			if (readargs = IDOS->ReadArgs("FILE/A,BUFFERSIZE/A/N", rargs, NULL))
			{
			filename = (UBYTE *) rargs[0];
			buffersize = ((LONG ) rargs[1]);
			if (buffersize < 1 \|\| buffersize > BUFFERSIZE)
			buffersize = BUFFERSIZE;

			if (buffer = IExec->AllocVecTags(buffersize, AVT_ClearWithValue, 0, TAG_END))
			{
			position = IDOS->SplitName(filename, ':', buffer, position, buffersize);

			vargs[0] = position;
			vargs[1] = (LONG) buffer;
			IDOS->VFPrintf(IDOS->Output(), "Devicename: position: %ld Buffer: %s\n", vargs);

			if (position == -1)
			position = 0;

			do
			{
			position =
			IDOS->SplitName(filename, '/', buffer, position, buffersize);
			vargs[0] = position;
			vargs[1] = (LONG) buffer;
			IDOS->VFPrintf(IDOS->Output(),
			"Path component: position: %ld Buffer: %s\n",
			vargs);
			} while (position != -1);
			IExec->FreeVec(buffer);
			}
			IDOS->FreeArgs(readargs);
			}
			else
			IDOS->PrintFault(IDOS->IoErr(), NULL);

			return 0;
			}
			</syntaxhighlight>

Steven Solie: /* Example */

2013-03-28T15:28:11Z

Example

Show changes

Steven Solie: /* Description */

2013-03-28T15:25:02Z

Description

← Older revision		Revision as of 15:25, 28 March 2013
Line 2:		Line 2:

	When processing file names, it is often necessary to extract only a file name from a path or to generate an absolute path to a file. The dos.library contains several routines designed to make this easier.		When processing file names, it is often necessary to extract only a file name from a path or to generate an absolute path to a file. The dos.library contains several routines designed to make this easier.

			= FilePart() and PathPart() =

	The FilePart() function takes a pointer to a file path and returns a pointer to the last part of the string (the part of the string that		The FilePart() function takes a pointer to a file path and returns a pointer to the last part of the string (the part of the string that
Line 57:		Line 59:
	Filepart: ""		Filepart: ""
	Pathpart: ""		Pathpart: ""

			== Example ==



			= AddPart() =

	The dos.library AddPart() function lets you append a file or directory name to the end of a (relative) path, inserting any necessary separator characters:		The dos.library AddPart() function lets you append a file or directory name to the end of a (relative) path, inserting any necessary separator characters:
Line 66:		Line 74:
	AddPart() will add myfilename to the end of mypathname. The mysize argument indicates how large the mypathname buffer is. In case this		AddPart() will add myfilename to the end of mypathname. The mysize argument indicates how large the mypathname buffer is. In case this
	buffer is too small, AppPart() returns FALSE and makes no changes to the buffer. If myfilename is an absolute path, it will replace the current contents of the mypathname buffer. If myfilename starts with a colon, AddPart() will generate a new path relative to the root of the volume/device in mypathname.		buffer is too small, AppPart() returns FALSE and makes no changes to the buffer. If myfilename is an absolute path, it will replace the current contents of the mypathname buffer. If myfilename starts with a colon, AddPart() will generate a new path relative to the root of the volume/device in mypathname.

			= SplitName() =

	Another dos.library function called SplitName() makes it possible to extract individual volume/device, directory, or file names (referred to here as path components) from a path string:		Another dos.library function called SplitName() makes it possible to extract individual volume/device, directory, or file names (referred to here as path components) from a path string:

Steven Solie: /* Description */

2013-03-27T23:29:59Z

Description

← Older revision		Revision as of 23:29, 27 March 2013
Line 66:		Line 66:
	AddPart() will add myfilename to the end of mypathname. The mysize argument indicates how large the mypathname buffer is. In case this		AddPart() will add myfilename to the end of mypathname. The mysize argument indicates how large the mypathname buffer is. In case this
	buffer is too small, AppPart() returns FALSE and makes no changes to the buffer. If myfilename is an absolute path, it will replace the current contents of the mypathname buffer. If myfilename starts with a colon, AddPart() will generate a new path relative to the root of the volume/device in mypathname.		buffer is too small, AppPart() returns FALSE and makes no changes to the buffer. If myfilename is an absolute path, it will replace the current contents of the mypathname buffer. If myfilename starts with a colon, AddPart() will generate a new path relative to the root of the volume/device in mypathname.

			Another dos.library function called SplitName() makes it possible to extract individual volume/device, directory, or file names (referred to here as path components) from a path string:

			<syntaxhighlight>
			int16 = SplitName(STRPTR mypathname, uint8 separatorchar, STRPTR buffer, int16 oldposition, int32 buffersize);
			</syntaxhighlight>

			SplitName() searches through the string mypathname for the separator character (separatorchar from the above prototype) starting at
			oldposition. As it is stepping through mypathname, SplitName() copies the characters it encounters from mypathname to the buffer, terminating the resulting string with a NULL. It does not copy the separator character into the buffer. If it finds the separator character, SplitName() returns the position of the character that follows the separator character. This position can be used as the oldposition argument in subsequent calls to SplitName() to extract other path components from the same path. If SplitName() does not find another separator character, it will return -1, although it will still copy characters from mypathname to buffer. For example, if SplitName() was called with the following arguments:
			mypathname = "ram:env/sys/win.pat"
			separatorchar = '/'
			oldposition = 8
			buffersize = 10

			buffer would contain the NULL terminated string "sys" and SplitName() would return a value of 12. If SplitName() was called again placing the return value of 12 into oldposition, buffer would contain the NULL terminated string "win.pat" and SplitName() would return a value of -1, as there are no separator characters in mypathname beyond the eleventh character.

			If SplitName() runs out of room in the buffer, it will copy as much of the characters as it can fit (buffersize - 1) and will write a NULL into the last position in the buffer. Also, if SplitName() runs out of room in the buffer and it finds another separator character, the position it returns will not be of the character that follows the separator character. Instead, SplitName() will return the position of the actual separator character.

Steven Solie at 23:25, 27 March 2013

2013-03-27T23:25:10Z

← Older revision		Revision as of 23:25, 27 March 2013
Line 11:		Line 11:

	In case mypath (from the prototype above) consists only of a file or directory name (like startup-sequence, s, or libs), FilePart() returns a pointer to the start of the string (a.k.a. the same value as mypath).		In case mypath (from the prototype above) consists only of a file or directory name (like startup-sequence, s, or libs), FilePart() returns a pointer to the start of the string (a.k.a. the same value as mypath).

			The PathPart() function returns a pointer to the last character in the path string that doesn't include the file name (usually the separator character "/"):

			<syntaxhighlight>
			STRPTR PathPart(STRPTR mypath);
			</syntaxhighlight>

			If passed a pointer to the path string "sys:s/startup-sequence", PathPart() will return a pointer to "/startup-sequence". The application can then put a \0 where PathPart() points so that the original string has been shortened to a path part string. In case mypath (from the above prototype) is only a file name, PathPart() returns a pointer to this file name (the same value as mypath). This can confuse an application if it blindly expects PathPart() to return a path. An application should make sure the pointer PathPart() returns is not the same pointer the application passed to the function.

			Both FilePart() and PathPart() consider the initial colon of an absolute path name (a path starting with a volume/device/assign name) to be a special separator character, but PathPart() will not include the colon in the string it returns a pointer to. For example, if passed the string "ram:tmpfile", PathPart() will return a pointer to the string "tmpfile".

			Neither FilePart() nor PathPart() check the syntax of the path string passed to them, so if your application passes an invalid path to them, they will pass back equally invalid path fragments. Also, they do not process any of the wildcard tokens, treating them as normal characters. The following chart summarizes the possible results of the FilePart() and PathPart() functions. It assumes that the path supplied to the functions is valid.

			wholepath is the path passed to FilePart() and PathPart(), pathpart is result of PathPart() and filepart is the result of FilePart().

			1. If (wholepath != pathpart != filepart), then filepart points to the the file or directory name in wholepath and pathpart points to the '/' before the file or directory name in wholepath. For example:
			wholepath: "ram:t/tmpfile"
			Filepart: "tmpfile"
			Pathpart: "/tmpfile"

			wholepath: "//t/tmpfile"
			Filepart: "tmpfile"
			Pathpart: "/tmpfile"

			2. If (wholepath != pathpart == filepart), then filepart and pathpart point to a file or a directory name preceded by a volume name or series of separator characters. For example:
			wholepath: "ram:tmpfile"
			Filepart: "tmpfile"
			Pathpart: "tmpfile"

			wholepath: "//tmpfile"
			Filepart: "tmpfile"
			Pathpart: "tmpfile"

			3. If (wholepath == pathpart == filepart) then pathpart points to either a file or a directory name. This name is not preceded by a volume name.
			wholepath: "tmpfile"
			Filepart: "tmpfile"
			Pathpart: "tmpfile"

			4. If (pathpart[0] == 0), then path points to either "" (current directory), a series of separators ("/", "//", ":", etc.), or a volume/device name.
			wholepath: "////"
			Filepart: ""
			Pathpart: ""

			wholepath: "ram:"
			Filepart: ""
			Pathpart: ""

			The dos.library AddPart() function lets you append a file or directory name to the end of a (relative) path, inserting any necessary separator characters:

			<syntaxhighlight>
			BOOL AddPart(UBYTE mypathname, UBYTE myfilename, ULONG mysize);
			</syntaxhighlight>

			AddPart() will add myfilename to the end of mypathname. The mysize argument indicates how large the mypathname buffer is. In case this
			buffer is too small, AppPart() returns FALSE and makes no changes to the buffer. If myfilename is an absolute path, it will replace the current contents of the mypathname buffer. If myfilename starts with a colon, AddPart() will generate a new path relative to the root of the volume/device in mypathname.

Steven Solie: Created page with "= Description = When processing file names, it is often necessary to extract only a file name from a path or to generate an absolute path to a file. The dos.library contains ..."

2013-03-22T23:35:28Z

Created page with "= Description = When processing file names, it is often necessary to extract only a file name from a path or to generate an absolute path to a file. The dos.library contains ..."

New page

= Description =

When processing file names, it is often necessary to extract only a file name from a path or to generate an absolute path to a file. The dos.library contains several routines designed to make this easier.

The FilePart() function takes a pointer to a file path and returns a pointer to the last part of the string (the part of the string that
follows the last separator character, "/"). The last part of the string is normally a file or directory name.

<syntaxhighlight>
STRPTR FilePart(STRPTR mypath);
</syntaxhighlight>

In case mypath (from the prototype above) consists only of a file or directory name (like startup-sequence, s, or libs), FilePart() returns a pointer to the start of the string (a.k.a. the same value as mypath).