commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Martin Cooper <mfncoo...@gmail.com>
Subject Re: [io] Filename prefixes
Date Mon, 22 Nov 2004 01:25:23 GMT
On Mon, 22 Nov 2004 01:17:40 -0000, Stephen Colebourne
<scolebourne@btopenworld.com> wrote:
> Basically it looks like we'll need:
> 
> getPrefix()  - C:\
> getPath()  - dev\project
> getFullPath()  - C:\dev\project
> getName()  - file.txt
> getExtension()  - txt
> (input  C:\dev\project\file.txt)

Perhaps one more:
getBaseName() - file

> Normalize/catPath can then use the other methods to stitch together a
> result.
> 
> Naming:
> catPath() should be renamed to concat()

That's fine. I think your earlier suggestion was merge(), but I like
concat() better. ;-)

> getFullPath()/getPath() - are these logical names?

I think getFullPath() is fine. I'm not so thrilled with getPath(),
since I suspect people might expect it to do what getFullPath() does,
but I don't have any good suggestions for an alternative name.

I'm fine with the use of the term 'prefix', since I've seen it used
elsewhere with the same meaning.

--
Martin Cooper


> 
> Stephen
> 
> 
> 
> ----- Original Message -----
> From: "Martin Cooper" <mfncooper@gmail.com>
> > On Mon, 22 Nov 2004 01:03:28 -0000, Stephen Colebourne
> > <scolebourne@btopenworld.com> wrote:
> > > In order to write the normalize() method properly, I realised that we
> have
> > > to deal with filename prefixes properly. The point being that you can't
> ..
> > > up into a filename prefix.
> > >
> > > Here's the javadoc for the method I'm writing. Does this cover the
> cases?
> >
> > Looks good to me. I can't think of any other options, at least for
> > Windows and Unix.
> >
> > --
> > Martin Cooper
> >
> >
> > >
> > >    /**
> > >     * Returns the length of the filename prefix, such as
> <code>C:/</code>
> > > or <code>~/</code>.
> > >     * <p>
> > >     * This method will handle a file in either Unix or Windows format.
> > >     * The prefix includes the first slash in the full filename.
> > >     * <pre>
> > >     * Windows:
> > >     * a\b\c.txt           --> ""          --> relative
> > >     * \a\b\c.txt          --> "\"         --> drive relative
> > >     * C:\a\b\c.txt        --> "C:\"       --> absolute
> > >     * \\server\a\b\c.txt  --> "\\server\" --> UNC
> > >     *
> > >     * Unix:
> > >     * a/b/c.txt           --> ""          --> relative
> > >     * /a/b/c.txt          --> "/"         --> absolute
> > >     * ~/a/b/c.txt         --> "~/"        --> current user relative
> > >     * ~user/a/b/c.txt     --> "~user/"    --> named user relative
> > >     * </pre>
> > >     *
> > >     * @param filename  the filename to find the prefix in, null
> returns -1
> > >     * @return the length of the prefix, -1 if invalid or null
> > >     */
> > >
> > > Stephen
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> > >
> > >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
> 
> 
> ---------------------------------------------------------------------
> 
> 
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> 
>

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message