Fully qualified name
In computer programming, a fully qualified name is an unambiguous name that specifies which object, function, or variable a call refers to without regard to the context of the call. In a hierarchical structure, a name is fully qualified when it "is complete in the sense that it includes (a) all names in the hierarchic sequence above the given element and (b) the name of the given element itself."
||This article may contain indiscriminate, excessive, or irrelevant examples. (October 2011)|
In computer programming, a fully qualified name is an unambiguous name that specifies which object, function, or variable a call refers to without regard to the context of the call. In a hierarchical structure, a name is fully qualified when it "is complete in the sense that it includes (a) all names in the hierarchic sequence above the given element and (b) the name of the given element itself." Thus fully qualified names explicitly refer to namespaces that would otherwise be implicit because of the scope of the call. While always done to eliminate ambiguity, this can mean different things dependent on context.
To distinguish a fully qualified name from a regular name, C++, Tcl, Perl and Ruby use two colons (::), and Java uses dots (.), as does Visual Basic .NET. and C#. In Java, ActionScript, and other object-oriented languages the use of the dot is known as "dot syntax". Other examples include:
- As an example of a relational database, in Microsoft SQL Server the fully qualified name of an object is the one that specifies all four parts:
- In Perl, a fully qualified scalar (
$scalar) that is in the package
package2would be referred to as
- In Ruby, the fully qualified name of a class is the name of such class with all its parent modules, as Vehicles::Cars::Factory would be the fully qualified name of Factory class within Cars module within Vehicles module.
- In Unix pathnames, instead of referring to
/home/user/quz, which uses a relative pathname, the fully qualified name would be
/home/user/quz/foo/bar/baz.shThis is an example of a fully qualified file name.
- In the sense of domain names, a fully qualified domain name is explicitly suffixed with a dot, to eliminate the step of resolving, and to ensure that no additional suffix is added:
wikipedia.com.for instance. This is an example of a fully qualified domain name.
Filenames and paths
The term fully qualified file name means a file on a computer whose exact name is completely specified such that it is unambiguous and cannot be mistaken for any other file on that system.[clarification needed] It is somewhat equivalent on the Internet to a URL specifying the full name of the computer and the entire name of a particular document as a file. The alternative is an unqualified file name or a partially qualified file name.
- On Unix-style systems, DOS, and Microsoft Windows, the name "sample" refers to a file in the current directory named "sample". If the current directory is changed, then the file referred to by the name "sample" is different. If you start the filename with "/" indicating the root directory as in "/Users/Name/sample", then on Unix this is a fully qualified file name. In DOS, this is still relative to the root directory of the current disk, to get a fully qualified file name, one must prefix the file name with the drive letter and a colon, as in "C:\Users\Name\sample", where "C:" specifies the "C" drive.
- Also on the above systems, some programs such as the command-line shell will search a path for a file. Inserting a leading (back)slash, as in "./name", will stop the searching of the path. This is a partially qualified name, but not a fully qualified name as it still depends on the current directory. A fully qualified name, because it contains (back)slashes, will always stop a path search.
- On the mainframe operating system MUSIC/SP, if one asks for the file name "X", one is making an unqualified reference either to the file X in the user's library, or to the file X in the common library if the user does not have a file named X and one does exist in the common library. If, however, one were to refer to "*COM:X" one is using a fully qualified file name reference to the file X in the common library even if they have a different file named X in their library. Similarly, a reference to "*USR:X" would mean the file in their own library, and "MA45:X" would be a fully qualified file name referring to the specific file X in the library of user MA45.
- On the RSTS/E operating system on the PDP-11 minicomputer, specifying a file "X.X" would refer to a file in one's own directory. Referring to "$X.X" would be referring to the file "[1,2]X.X" but to fully qualify the file name, one would have to indicate the device, so "SY:[46,145]MYFILE.TXT", "SY:$X.X", or "SY:[1,2]X.X" (the last two examples meaning the same thing) would be a fully qualified file name under RSTS/E.
- On the UNIVAC Series 90 mainframe operating system VS/9, specifying a file "X" could mean either the file X in the account of that user, or could mean the file X in the library of the system manager, $TSOS. However, specifying "$S0103.X" would be a fully qualified file name.
- This term can also include the case where one prefixes a fully qualified file name with a specific computer name as a prefix to a file name (where the particular system permits referencing a file on another system), so long as the exact name is unambiguous.
Fully qualified path name (FQPN) is the full path of a resource, directory or file, stored in a computer. It is composed by the full path to the resource and its syntax depends on the operating system. In Unix-like operating systems it is represented in the following form:
/root/path-to/file[OR]directory, while in DOS and Microsoft Windows it is represented in the following form:
[Drive]:\path-to\file.ext[OR]directory. FQPN is also used in Networking and takes the following form:
/root/ is the root directory, the first or top-most directory in a hierarchy, and, in this case, the rooted tree;
FQDN is the fully qualified domain name or node. It is also used in bootstrapping, computer programming and in computer science referencing.
- Weik, Martin H. (2000). Computer Science and Communications Dictionary. Volume 1. Springer. p. 662. ISBN 978-0-7923-8425-0.
- Hejlsberg, Anders; Torgersen, Mads; Wiltamuth, Scott (29 October 2010). The C# Programming Language (Covering C# 4.0). Addison-Wesley Professional. p. 190. ISBN 978-0-13-248172-4. Retrieved 28 October 2011.
- Vick, Paul (2004). The Visual Basic .NET programming language. Addison-Wesley Professional. p. 160. ISBN 978-0-321-16951-8.
- Mayo, Joe. ": C# Tutorial Lesson 06 - Namespaces". C# Station. Retrieved 2011-10-27.
- "ActionScript 3 fundamentals: Packages". Adobe Systems Incorporated. Retrieved 2011-10-27.
- "Using Identifiers As Object Names". msdn.microsoft.com. Retrieved 2011-10-27.
- "mod_perl: Perl Reference". perl.apache.org. Retrieved 2011-10-23.
- Kochan, Stephen G.; Wood, Patrick H. (2003). UNIX Shell programming. Sams Publishing. p. 11. ISBN 978-0-672-32490-1. Retrieved 28 October 2011.
- Lowe, Doug (8 February 2011). Networking For Dummies. For Dummies. p. 80. ISBN 978-1-118-05100-9. Retrieved 28 October 2011.