VS2003 Jscript Es-Es
VS2003 Jscript Es-Es
VS2003 Jscript Es-Es
El contenido de este documento se ha retirado y ya no se actualiza o admite. Algunos vínculos podrían no funcionar. El contenido retirado
representa la versión más reciente actualizada de este contenido.
JScript .NET
JScript
JScript .NET is a modern scripting language with a wide variety of applications. It is a true object-oriented language, and yet it still
keeps its "scripting" feel. JScript .NET maintains full backwards compatibility with previous versions of JScript, while incorporating
great new features and providing access to the common language runtime and .NET Framework.
The following topics introduce the essential components of JScript .NET and provide information about how to use the language.
As with any modern programming language, JScript supports a number of common programming constructs and language
elements.
If you have programmed in other languages, much of the material covered in this section may seem familiar. While most of the
constructs are the same as in previous versions of JScript, JScript .NET introduces powerful new constructs similar to those in
other class-based, object-oriented languages.
If you are new to programming, the material in this section will serve as an introduction to the basic building blocks for writing
code. Once you understand the basics, you will be able to create powerful scripts and applications using JScript.
In This Section
Getting Started With JScript .NET
Introduces what is new in JScript .NET.
Writing, Compiling, and Debugging JScript Code
Provides a collection of links to topics that explain how to write, edit, and debug code with JScript .NET.
Displaying Information with JScript .NET
Includes a list of links to topics that explain how to display information from a command program, from ASP.NET, and in a
browser.
Introduction to Regular Expressions
Comprises a guide to the elements and procedures that encompass Regular Expressions in JScript .NET. Topics explain the
concept of Regular Expressions, proper syntax, and appropriate use.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Related Sections
Devenv Command Line Switches
Lists language reference topics that explain how to launch Visual Studio and how to build from the command prompt.
Development Environment Reference
Provides a list of links to topics such as shortcut keys, regular expression syntax, wildcard syntax, and so on.
Language Equivalents
Compares keywords, data types, operators, and programmable objects (controls) for Visual Basic, C++, C#, JScript, and Visual
FoxPro.
.NET Framework Class Library
Contains links to topics that explain the namespaces in the .NET Framework class library and explains how to use the class
library documentation.
User Interface Reference
Contains topics that explain options that appear on various dialog boxes, windows, and other user interfaces in Visual Studio.
Visual Studio Commands
Lists language reference topics that explain how to use commands to interact with the IDE from the Command Window and
Find/Command box.
Visual Studio Walkthroughs
Provides links to topics that discuss the steps involved in the development of specific applications or how to use major
application features.
JScript .NET
En esta sección
Información de versión
Recoge todas las características de JScript y la correspondiente versión en la que se introdujo cada una de ellas.
Paseo por el lenguaje JScript
Comenta los elementos y procedimientos que utilizan los programadores para escribir código de JScript, así como vínculos a
áreas específicas que explican con más detalle los elementos del lenguaje y la sintaxis del código.
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
JScript .NET
Lo nuevo en JScript.NET
JScript .NET, la siguiente generación del lenguaje Microsoft JScript, está diseñado como un modo de acceso rápido y sencillo a la
plataforma Microsoft .NET a través del lenguaje del Web. El propósito principal de JScript es la creación de sitios Web con
ASP.NET y la personalización de aplicaciones con secuencia de comandos para .NET Framework.
JScript .NET, que es compatible con el estándar ECMAScript, tiene características adicionales no especificadas por ECMAScript,
como código compilado real, admisión de varios lenguajes gracias a la compatibilidad con CLS (Common Language Specification,
especificación de lenguaje común) y acceso a NET Framework. Si bien la versión de JScript .NET que se incluye con
Visual Studio .NET 2002 aprovechaba la seguridad inherente de .NET Framework, JScript .NET 2003 mejora aún más la seguridad
agregando un contexto de seguridad restringido para el método eval.
Varias características nuevas de JScript .NET se benefician de CLS, un conjunto de reglas que normaliza aspectos como los tipos
de datos, cómo se muestran los objetos y cómo interactúan estos. Cualquier lenguaje compatible con CLS puede utilizar las
clases, los objetos y los componentes que se crean en JScript .NET. El usuario, como programador de JScript, puede obtener
acceso a las clases, los componentes y objetos desde otros lenguajes de programación compatibles con CLS sin tener en cuenta
diferencias específicas del lenguaje tales como los tipos de datos. Algunas de las características de CLS que utilizan los programas
de JScript .NET son los espacios de nombres, los atributos, los parámetros por referencia y las matrices nativas.
A continuación se muestran algunas de las características nuevas de JScript .NET:
Lo nuevo en JScript .NET 2003
Contexto de seguridad restringido para el método eval
A fin de mejorar la seguridad, el método eval integrado ejecuta ahora de manera predeterminada las secuencias de comandos
en un contexto de seguridad restringido, independientemente de los permisos que tenga el llamador. Al llamar a eval con
"unsafe" como segundo parámetro opcional, la secuencia de comandos se ejecuta con los permisos del llamador, permitiendo
así el acceso al sistema de archivos, a la red o a la interfaz de usuario. Para obtener más información, vea eval (Método).
Lo nuevo en JScript .NET 2002
Objetos basados en clases
JScript .NET (al igual que JScript) admite la herencia mediante objetos basados en prototipos. JScript .NET admite también
objetos basados en clase que permiten la declaración de clases que definen los datos y el comportamiento de los objetos. Las
clases que se crean en JScript .NET pueden ser utilizadas y extendidas a cualquier lenguaje .NET. Las clases pueden heredar las
propiedades y métodos de una clase base. Existen varios atributos que se pueden aplicar a las clases y a los miembros de clase
que modifican su comportamiento y visibilidad. Para obtener más información, vea Objetos basados en clases.
Tipos de datos de JScript
En JScript .NET (al igual que JScript), se puede escribir programas sin especificar los tipos de datos para las variables. JScript
.NET también se puede utilizar como un leguaje con establecimiento inflexible de tipos, en el que todas las variables se enlazan
a un tipo de dato determinado o se puede utilizar una combinación de variables con y sin tipo. JScript .NET proporciona algunos
tipos de datos nuevos. También se pueden utilizar como tipos de datos clases y tipos .NET. Para obtener más información, vea
Tipos de datos de JScript.
Compilación condicional
Las directivas controlan la compilación del programa JScript .NET. Por ejemplo, la directiva @debug activa o desactiva la
emisión de información de depuración para una parte determinada de la secuencia de comandos Para obtener más
información, vea @debug (Directiva). la directiva @position fija el número de línea del depurador para la línea actual. Para
obtener más información, vea @debug (Directiva). Estas dos directivas son útiles si se está escribiendo código que será
incorporado en otras secuencias de comandos. Para obtener más información, vea Compilación condicional.
Espacios de nombres JScript
Los espacios de nombres evitan los conflictos de nomenclatura mediante la organización de clases, interfaces y métodos dentro
de unas jerarquías. En JScript .NET se pueden definir espacios de nombres propios. También, se puede obtener acceso a
cualquier espacio de nombres .NET Framework con JScript .NET, además de los que el usuario defina. La instrucción package
permite el empaquetado de clases relacionadas para un desarrollo sencillo y para evitar conflictos de nomenclatura. Para
obtener más información, vea package (Instrucción). La instrucción import hace que un espacio de nombres .NET Framework
este disponible para una secuencia de comandos de modo que éste pueda obtener acceso a las clases y a los interfaces en el
espacio de nombres. Para obtener más información, vea import (Instrucción).
Variables y constantes de JScript
JScript .NET presenta una instrucción const que define un identificador que representa un valor constante. Para obtener más
información, vea Variables y constantes de JScript.
Enumeraciones
JScript .NET presenta la instrucción enum que permite crear tipos de datos enumerados. Con una enumeración se pueden
especificar nombres útiles para los valores de los tipos de datos. Para obtener más información, vea enum (Instrucción).
Vea también
¿Qué es JScript .NET? | Lo nuevo en el lenguaje Visual Basic | Lo nuevo en Visual Studio .NET | Modificadores | Tipos de datos |
Directivas | Instrucciones | Referencia de JScript
JScript .NET
Comments
The first line of the example contains a comment. Since the compiler ignores the comment, you can write any text. This comment
describes the purpose of the program.
The double forward slash (//) means that the rest of the line is a comment. You can make an entire line a comment, or you can
append a comment to the end of another statement, as follows:
You can also use multiline comments. A multiline JScript comment begins with a forward slash and asterisk (/*), and ends with
the reverse (*/).
/*
Multiline comments allow you to write long comments.
They can also be used to "comment out" blocks of code.
*/
This example uses the print statement to display the string Hello World!:
print("Hello World!");
For more information, see Compiling JScript code from the Command Line.
See Also
Writing, Compiling, and Debugging JScript Code | Displaying Information with JScript .NET | JScript Reference
JScript .NET
See Also
Getting Started With JScript .NET | Introduction to JScript .NET for JScript Programmers | /fast
JScript .NET
microsoft.public.dotnet.languages.jscript
Provides a forum for questions and general discussion about JScript .NET.
microsoft.public.dotnet.scripting
Provides a forum for questions and general discussion about script with the .NET Framework.
microsoft.public.vsnet.documentation
Provides a forum for questions and issues on the JScript .NET documentation.
microsoft.public.scripting.jscript
Provides a forum for questions and general discussion about JScript 5.x.
microsoft.public.scripting.wsh
Provides a forum for questions and general discussion about using JScript 5.x in Microsoft Windows Script Host (WSH).
Other Resources
On the Web
4GuysFromRolla.com (http://www.4GuysFromRolla.com/)
Provides articles, demos, tool previews, and other information for Web development in JScript .NET.
DevX (http://www.devx.com/)
Provides articles, demos, tool previews, and other information for development in JScript .NET.
JScript .NET
6. Haga clic en Aceptar para aceptar los cambios y cerrar los cuadros de diálogo.
Después de cambiar la variable de entorno PATH, podrá ejecutar el compilador de JScript .NET en el símbolo del sistema de
Windows desde cualquier directorio del equipo.
Usar el compilador
El compilador de la línea de comandos dispone de ayuda integrada. La pantalla de ayuda se muestra cuando se utiliza la opción
de la línea de comandos /help o /? o cuando se usa el compilador sin ninguna opción. Por ejemplo:
jsc /help
Existen dos formas de utilizar JScript .NET: puede escribir programas para compilarlos desde la línea de comandos o para
ejecutarlos en ASP .NET.
Para compilar mediante jsc
En el símbolo del sistema, escriba jsc archivo.js.
El comando compila el programa archivo.js para generar el archivo ejecutable denominado archivo.exe.
Para producir un archivo .dll mediante jsc
En el símbolo del sistema, escriba jsc /target:library file.js.
El comando compila el programa archivo.js con la opción /target:library para producir el archivo de biblioteca llamado
archivo.dll.
El comando compila el programa archivo.js con la opción /out: para producir el ejecutable llamado nuevonombre.exe.
Para compilar con información de depuración mediante jsc
En el símbolo del sistema, escriba jsc /debug file.js.
El comando compila el programa archivo.js con la opción /debug para producir el ejecutable llamado archivo.exe y un
archivo denominado archivo.pdb que contiene información de depuración.
Hay muchas más opciones de la línea de comandos disponibles para el compilador de la línea de comandos de JScript. Para
obtener más información, vea Opciones del compilador de JScript.
Vea también
Escribir, compilar y depurar código JScript | Opciones del compilador de JScript | Compilación condicional
JScript .NET
Vea también
Escribir, compilar y depurar código JScript | Desarrollar con Visual Studio .NET | Utilizar IntelliSense |
Generar desde la línea de comandos | Depurar JScript con Visual Studio .NET |
Depurar JScript con el depurador de Common Language Runtime
JScript .NET
Conditional Compilation
Conditional compilation enables JScript to use new language features without sacrificing compatibility with older versions that do
not support the features. Some typical uses for conditional compilation include using new features in JScript, embedding
debugging support into a script, and tracing code execution.
In This Section
Conditional Compilation Directives
Lists the directives that control how a script is compiled and links to information that explains the proper syntax for each
directive.
Conditional Compilation Statements
Lists and discusses the statements that control compilation of a script depending on the values of the conditional compilation
variables.
Conditional Compilation Variables
Lists the predefined variables available for conditional compilation.
Related Sections
Writing, Compiling, and Debugging JScript Code
Links to topics that explain how to use the Integrated Development Environment (IDE) to write JScript code.
Compiling JScript Code from the Command Line
Describes how to use the command-line compiler to produce compiled JScript programs.
Detecting Browser Capabilities
Describes how to determine what versions of JScript a Web browser engine supports by using script engine functions and
conditional compilation.
JScript Compiler Options
Links to information that lists the compiler options available for the JScript command-line compiler.
JScript .NET
/*@cc_on @*/
/*@if (@_jscript_version >= 5)
document.write("JScript Version 5.0 or better.<BR>");
@else @*/
document.write("You need a more recent script engine.<BR>");
/*@end @*/
This example uses special comment delimiters that are only used if the @cc_on statement has activated conditional compilation.
Scripting engines that do not support conditional compilation display a message advising of the need for a new scripting engine
without generating errors. Engines that support conditional compilation compile either the first or second document.write,
depending on the version of the engine. Note that version 7.x represents JScript .NET. For more information, see
Detecting Browser Capabilities.
Conditional compilation is also useful for server-side scripts and command-line programs. In those applications, conditional
compilation can be used to compile additional functions into a program to help with profiling when in debug mode.
See Also
Conditional Compilation | Conditional Compilation Variables | Conditional Compilation Directives | /define |
Detecting Browser Capabilities
JScript .NET
/*@cc_on
document.write("JScript version: " + @_jscript_version + ".<BR>");
@if (@_win32)
document.write("Running on 32-bit Windows.<BR>");
@elif (@_win16)
document.write("Running on 16-bit Windows.<BR>");
@else
document.write("Running on a different platform.<BR>");
@end
@*/
Conditional compilation variables can be used to determine the version information of the engine interpreting a script. This allows
a script to take advantage of the features available in the latest versions of JScript while maintaining backwards compatibility. For
more information, see Detecting Browser Capabilities.
See Also
Conditional Compilation | Conditional Compilation Directives | Conditional Compilation Statements |
Detecting Browser Capabilities
JScript .NET
Conditional Compilation
Conditional compilation variables and statements can hide JScript code from engines that do not support conditional compilation.
This approach is useful if you want to include a small amount of alternate code directly in the Web page.
Note Do not use multiline comments within the conditional compilation blocks since engines that do not support
conditional compilation may misinterpret them.
<script>
/*@cc_on
@if(@_jscript_version >= 5 )
// Can use JScript Version 5 features such as the for...in statement.
// Initialize an object with an object literal.
var obj = {"a" : "Athens" , "b" : "Belgrade", "c" : "Cairo"};
var key;
// Iterate the properties.
for (key in obj) {
document.write("The "+key+" property has value "+obj[key]+".<BR>");
}
@else
@*/
alert("Engine cannot interpret JScript Version 5 code.");
//@end
</script>
If the conditional @if block includes a lot of code, it may be easier to use the approach outlined above for using the script engine
functions.
See Also
Writing, Compiling, and Debugging JScript Code | Version Information | Functions | Conditional Compilation
JScript .NET
function clobber(param) {
// Overwrite the parameter; this will not be seen in the calling code
param = new Object();
param.message = "This will not work.";
}
function update(param) {
// Modify the property of the object; this will be seen in the calling code.
param.message = "I was changed.";
}
Data Comparison
JScript can compare data either by value or by reference. To perform a test by value, JScript compares two distinct items to
determine whether they are equal to each other. Usually, this comparison is performed on a byte-by-byte basis. When it tests by
reference, it checks to see whether two items refer to the same item. If they do, then they compare as equal; if not, although they
may contain the exact same values, byte-for-byte, they compare as unequal.
Strings may be compared by value or by reference, depending on whether or not the strings are objects. If both strings are String
objects, the strings are compared by reference; otherwise, they are compared by value. This allows two strings to compare as
equal if each was created separately from the other but each has the same content. To compare the values of two String objects,
first convert the objects to non-object strings with the toString or valueOf methods, and then compare the resulting strings. For
more information, see JScript Assignments and Equality.
See Also
JScript Language Tour | JScript Functions | JScript Assignments and Equality | Data Type Summary
JScript .NET
Comentarios
Cuando se depura un programa compilado desde la línea de comandos, Visual Studio .NET lee de nuevo el programa compilado
cada vez que inicia el proceso de depuración. Esto permite hacer modificaciones en el código JScript y (después de compilar de
nuevo el código) comprobar el efecto de tales cambios.
Vea también
Utilizar el depurador | Generar desde la línea de comandos | Escribir código JScript con Visual Studio .NET |
Generar desde la línea de comandos | Depurar JScript con el depurador de Common Language Runtime |
Depurar secuencias de comandos y aplicaciones Web
JScript .NET
Remarks
When debugging program compiled from the command line, dgbclr rereads the compiled program each time you start
debugging. Consequently, you can modify your JScript code and (after recompiling the code) check the effect of those changes.
See Also
Using the Debugger | Writing JScript code with Visual Studio .NET | Building from the Command Line |
Debugging JScript with Visual Studio .NET | CLR Debugger
JScript .NET
"100" == 100;
false == 0;
To check that both the type and value are the same, use the strict equality operator, ===. The following both evaluate to false:
Operator Precedence
The order of operation execution during the evaluation of an expression depends more on operator precedence than on the order
of operators in the expression. Thus, in the following example, multiplication is performed before subtraction even though the
subtraction operator appears before the multiplication operator in the expression.
See Also
Writing, Compiling, and Debugging JScript Code | Writing JScript Code with Visual Studio .NET |
Debugging JScript with Visual Studio .NET
JScript .NET
Si el valor de name fuera "Frank", el código escribiría la siguiente cadena en la página actual:
Hello Frank!
La construcción <%= %> resulta muy útil para mostrar partes individuales de la información.
Response.Write (Instrucción)
Otra manera de mostrar texto es utilizar la instrucción Response.Write. Se puede incluir en un bloque <% %>.
<% Response.Write("Hello, World!") %>
La instrucción Response.Write se puede usar también en una función o un método en un bloque de secuencias de comandos. En
el ejemplo siguiente se muestra una función que contiene una instrucción Response.Write.
Nota En páginas ASP.NET, funciones y variables debe definirse dentro de bloques <script>, mientras que el código
ejecutable debe ir entre bloques <% %>.
El resultado de la instrucción Response.Write se incorpora a la página que se está procesando. De este modo, el resultado de
Response.Write puede escribir código que, a su vez, muestra texto. Por ejemplo, el siguiente código escribe un bloque de
secuencias de comandos que muestra la fecha actual (del servidor) en una ventana de alerta del explorador que tiene acceso a la
página. La etiqueta "<script>" está dividida para que el servidor no la procese.
Vea también
Mostrar información con JScript .NET | Introducción a ASP.NET | Page.Response (Propiedad)
JScript .NET
Note The print statement is only available for programs compiled with the JScript command-line compiler. Using
print in an ASP.NET page causes a compiler error.
The Console Class
The class System.Console exposes methods and properties that facilitate interaction with users of the console. The WriteLine
method of the Console class provides functionality similar to the print statement. The Write method displays a string without
appending a newline character. Another useful method of the Console class is the ReadLine method, which reads a line of text
that is entered from the console.
To use classes and methods from the .NET Framework, first use the import statement to import the namespace to which the class
belongs. To call the method, use either the fully qualified name or just the name if there is no method in the current scope with
the same name.
import System;
System.Console.WriteLine("What is your name: ");
var name : String = Console.ReadLine();
Console.Write("Hello ");
Console.Write(name);
Console.WriteLine("!");
The program requests that a name be entered from the console. After entering the name, Pete, the program displays:
import System.Windows.Forms;
System.Windows.Forms.MessageBox.Show("Welcome! Press OK to continue.");
MessageBox.Show("Great! Now press OK again.");
You can use other overloads of the Show method to include a caption, other buttons, an icon, or default button. For more
information, see MessageBox.Show Method.
See Also
Displaying Information with JScript .NET | print Statement | import Statement
JScript .NET
Note The following simple function enables you to avoid typing document.write every time you want text to appear
in the browser window. This function does not inform you if something that you attempt to write is undefined, but it
does let you issue the command w();, which displays a blank line.
w('<IMG SRC="horse.gif">');
w();
w("This is an engraving of a horse.");
w();
The writeln method, which is almost identical to the write method, appends a newline character to the provided string. In HTML
this ordinarily results only in a space after an item; within <PRE> and <XMP> tags, the newline character is interpreted literally
and the browser displays it.
The write method opens and clears the document if the document is not in the process of being opened and parsed when the
write method is called. This poses potentially unexpected results. The following example, which shows a script that is intended to
display the time once a minute, fails to do so after the first time because it clears itself in the process.
<HTML>
<HEAD>
<SCRIPT LANGUAGE="JScript">
function singOut() {
var theMoment = new Date();
var theHour = theMoment.getHours();
var theMinute = theMoment.getMinutes();
var theDisplacement = (theMoment.getTimezoneOffset() / 60);
theHour -= theDisplacement;
if (theHour > 23) {
theHour -= 24
}
// The following line clears the script the second time it is run.
document.write(theHour + " hours, " + theMinute + " minutes, Coordinated Universal Time.")
;
window.setTimeout("singOut();", 60000);
}
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT>
singOut();
</SCRIPT>
</BODY>
</HTML>
If you use the alert method of the window object instead of document.write, the script works.
document.clear();
See Also
Displaying Information with JScript .NET | Using Message Boxes | Detecting Browser Capabilities
JScript .NET
See Also
Displaying Information with JScript .NET | Displaying Information in the Browser | Detecting Browser Capabilities
JScript .NET
In This Section
Regular Expressions
Explains the concept of regular expressions by comparing with concepts that are already familiar to most readers.
Uses for Regular Expressions
Indicates how regular expressions extend conventional search criteria through practical examples.
Regular Expression Syntax
Explains the characters that comprise a regular expression, the characters that comprise metacharacters, and the behavior of
metacharacters.
Build a Regular Expression
Describes the components of a regular expression and the relationship between the components and delimiters.
Order of Precedence
Explains how regular expressions are evaluated and how the sequence and syntax of the regular expression effects the result.
Ordinary Characters
Distinguishes ordinary characters from metacharacters and illustrates how to combine single-character regular expressions to
create larger expressions.
Special Characters
Explains the concept of escaping characters and how to create a regular expression that matches metacharacters.
Non-Printable Characters
Lists the escape sequences that are used to represent non-printing characters in a regular expression.
Character Matching
Illustrates how regular expressions use periods, escape characters, and brackets to create sequences that return specific results.
Quantifiers
Explains how to create regular expressions when you cannot specify how many characters comprise a match.
Anchors
Indicates how to fix a regular expression to either the beginning of a line or the end of a line and how to create regular
expressions that occur within a word, at the beginning of a word, or at the end of a word.
Alternation and Grouping
Illustrates how alternation uses the '|' character to allow a choice between two or more alternatives and how grouping works in
conjunction with alternation to further refine the result.
Backreferences
Explains how to create regular expressions that can access part of a stored matched pattern without recreating the regular
expression that found the matched pattern.
Related Sections
.NET Framework Regular Expressions
Clarifies how pattern-matching notation of regular expressions allows developers to quickly parse large amounts of text to find
specific character patterns; to extract, edit, replace, or delete text substrings; or to add the extracted strings to a collection in
order to generate a report.
Regular Expression Examples
Provides a list of links to code examples that illustrate the use of regular expressions in common applications.
JScript .NET
Regular Expressions
Unless you have previously used regular expressions, the term may be unfamiliar to you. However, you have undoubtedly used
some regular expression concepts outside the area of scripting.
For example, you most likely use the ? and * wildcard characters to find files on your hard disk. The ? wildcard character matches a
single character in a file name, while the * wildcard character matches zero or more characters. A pattern such as data?.dat would
find the following files:
data1.dat
data2.dat
datax.dat
dataN.dat
Using the * character instead of the ? character expands the number of found files. data*.dat matches all of the following:
data.dat
data1.dat
data2.dat
data12.dat
datax.dat
dataXYZ.dat
While this method of searching is useful, it is also limited. The ability of the ? and * wildcard characters introduces the concept
behind regular expressions, but regular expressions are more powerful and flexible.
See Also
Introduction to Regular Expressions
JScript .NET
See Also
/expression/
En el ejemplo anterior, el modelo de expresión regular (expression) se almacena en la propiedad Pattern del objeto RegExp.
Los componentes de una expresión regular pueden ser caracteres individuales, juegos de caracteres, intervalos de caracteres,
opciones entre caracteres o cualquier combinación de todos estos componentes.
Vea también
Order of Precedence
A regular expression is evaluated from left to right and follows an order of precedence, much like an arithmetic expression.
The following table illustrates, from highest to lowest, the order of precedence of the various regular expression operators:
Operator(s) Description
\ Escape
(), (?:), (?=), [] Parentheses and Brackets
*, +, ?, {n}, {n,}, {n,m} Quantifiers
^, $, \anymetacharacter, anycharacter Anchors and Sequences
| Alternation
Characters have higher precedence than the alternation operator, which allows 'm|food' to match "m" or "food". To match "mood"
or "food", use parentheses to create a subexpression, which results in '(m|f)ood'.
See Also
Introduction to Regular Expressions
JScript .NET
Ordinary Characters
Ordinary characters consist of all printable and non-printable characters that are not explicitly designated as metacharacters. This
includes all uppercase and lowercase alphabetic characters, all digits, all punctuation marks, and some symbols.
The simplest form of a regular expression is a single, ordinary character that matches itself in a searched string. For example, a
single-character pattern, such as A, matches the letter A wherever it appears in the searched string. Here are some examples of
single-character regular expression patterns:
/a/
/7/
/M/
You can combine a number of single characters to form a large expression. For example, the following regular expression
combines the single-character expressions: a, 7, and M.
/a7M/
Notice that there is no concatenation operator. You just type one character after another.
See Also
Caracteres especiales
Diversos metacaracteres requieren un tratamiento especial cuando se intenta que coincidan. Para buscar coincidencias con estos
caracteres especiales, primero debe especificar un carácter de escape, es decir, incluya una barra diagonal invertida (\) antes de
estos caracteres. En la tabla siguiente se incluyen los caracteres especiales y su significado:
Carácter especial Comentario
$ Coincide con la posición al final de la cadena de entrada. Si la propiedad Multiline del objeto RegExp está
establecida, $ coincide también con la posición que precede a \n o \r. Para que coincida con el carácter $, ut
ilice \$.
() Marca el principio y el final de una subexpresión. Las subexpresiones se pueden capturar para su uso poste
rior. Para buscar coincidencias con estos caracteres, utilice \( y \).
* Coincide cero o más veces con el carácter o subexpresión anterior. Para que coincida con el carácter *, utilic
e \*.
+ Coincide una o más veces con el carácter o subexpresión anterior. Para que coincida con el carácter +, utilic
e \+.
. Coincide con cualquier carácter individual excepto con el carácter de nueva línea \n. Para que coincida con .
, utilice \.
[] Marca el inicio de una expresión de corchetes. Para buscar coincidencias con estos caracteres, utilice \[ y \].
? Coincide una vez o ninguna con el carácter o subexpresión anterior, o indica un cuantificador no expansivo.
Para que coincida con el carácter ?, utilice \?.
\ Marks the next character as a special character, a literal, a backreference, or an octal escape. Por ejemplo, el
carácter n coincide con el carácter n. \n coincide con el carácter de nueva línea. La secuencia \\ coincide con
\ y \( coincide con (.
/ Denota el comienzo o el fin de una expresión regular literal. Para buscar coincidencias con el carácter /, utili
ce \/.
^ Coincide con la posición al principio de una cadena de entrada excepto cuando se utiliza en una expresión c
on corchetes donde niega el conjunto de caracteres. Para que el carácter ^ coincida consigo mismo, utilice
\^.
{} Marca el inicio de una expresión de cuantificadores. Para buscar coincidencias con estos caracteres, utilice \
{ y \}.
| Indica una opción entre dos elementos. Para que coincida con |, utilice \|.
Vea también
Introducción a las expresiones regulares
JScript .NET
Non-Printable Characters
Non-printing characters may also be part of a regular expression. The following table lists the escape sequences that represent
non-printing characters:
Character Meaning
\cx Matches the control character indicated by x. For example, \cM matches a Control-M or carriage return cha
racter. The value of x must be in the range of A-Z or a-z. If not, c is assumed to be a literal c character.
\f Matches a form-feed character. Equivalent to \x0c and \cL.
\n Matches a newline character. Equivalent to \x0a and \cJ.
\r Matches a carriage return character. Equivalent to \x0d and \cM.
\s Matches any white space character including space, tab, form-feed, and so on. Equivalent to [\f\n\r\t\v].
\S Matches any non-white space character. Equivalent to [^ \f\n\r\t\v].
\t Matches a tab character. Equivalent to \x09 and \cI.
\v Matches a vertical tab character. Equivalent to \x0b and \cK.
See Also
Introduction to Regular Expressions
JScript .NET
Character Matching
The period (.) matches all but one single printing or non-printing character in a string. The exception is a newline character (\n).
The following regular expression matches aac, abc, acc, adc, and so on, as well as a1c, a2c, a-c, and a#c:
/a.c/
To match a string containing a file name in which a period (.) is part of the input string, precede the period in the regular
expression with a backslash (\) character. To illustrate, the following regular expression matches filename.ext:
/filename\.ext/
These expressions only let you match any single character. You may want to match specific characters from a list. For example,
you might want to find chapter headings that are expressed numerically (Chapter 1, Chapter 2, and so on).
Bracket Expressions
To create a list of matching characters, place one or more individual characters within square brackets ([ and ]). When characters
are enclosed in brackets, the list is called a bracket expression. Within brackets, as anywhere else, an ordinary character represents
itself, that is, it matches an occurrence of itself in the input text. Most special characters lose their meaning when they occur inside
a bracket expression. Here are some exceptions:
The ] character ends a list if it is not the first item. To match the ] character in a list, place it first, immediately following the
opening [.
The \ character continues to be the escape character. To match the \ character, use \\.
Characters enclosed in a bracket expression match only a single character for the position in the regular expression. The following
regular expression matches Chapter 1, Chapter 2, Chapter 3, Chapter 4, and Chapter 5:
/Chapter [12345]/
Notice that the word Chapter and the space that follows are fixed in position relative to the characters within brackets. The bracket
expression is used to specify only the set of characters that matches the single character position immediately following the word
Chapter and a space. That is the ninth character position.
To express the matching characters using a range instead of the characters themselves, use the hyphen (-) character to separate
the beginning and ending characters in the range. The character value of the individual characters determines the relative order
within a range. The following regular expression contains a range expression that is equivalent to the bracketed list shown above.
/Chapter [1-5]/
When a range is specified in this manner, both the starting and ending values are included in the range. It is important to note
that the starting value must precede the ending value in Unicode sort order.
To include the hyphen character in a bracket expression, do one of the following:
Escape it with a backslash:
[\-]
Put the hyphen character at the beginning or the end of the bracketed list. The following expressions match all lowercase
letters and the hyphen:
[-a-z]
[a-z-]
Create a range in which the beginning character value is lower than the hyphen character and the ending character value is
equal to or greater than the hyphen. Both of the following regular expressions satisfy this requirement:
[!--]
[!-~]
To find all characters not in the list or range, place the caret (^) character at the beginning of the list. If the caret character appears
in any other position within the list, it matches itself. The following regular expression matches chapter headings with numbers
greater than 5:
/Chapter [^12345]/
In the examples above, the expression matches any digit character in the ninth position except 1, 2, 3, 4, or 5. So, for example,
Chapter 7 is a match and so is Chapter 9.
The above expressions can be represented using the hyphen character (-):
/Chapter [^1-5]/
A typical use of a bracket expression is to specify matches of any upper- or lowercase alphabetic characters or any digits. The
following expression specifies such a match:
/[A-Za-z0-9]/
See Also
Quantifiers
Quantifiers add optional quantity data to a regular expression. A quantifier expression applies to the character, group, or character
class that immediately precedes it. The .NET Framework regular expressions support minimal matching ("lazy") quantifiers.
The following table describes the metacharacters that affect matching quantity.
Quantifier Description
* Specifies zero or more matches; for example, \w* or (abc)*. Equ
ivalent to {0,}.
+ Specifies one or more matches; for example, \w+ or (abc)+. Equi
valent to {1,}.
? Specifies zero or one matches; for example, \w? or (abc)?. Equiv
alent to {0,1}.
{n} Specifies exactly n matches; for example, (pizza){2}.
{n,} Specifies at least n matches; for example, (abc){2,}.
{n,m} Specifies at least n, but no more than m, matches.
*? Specifies the first match that consumes as few repeats as possib
le (equivalent to lazy *).
+? Specifies as few repeats as possible, but at least one (equivalent
to lazy +).
?? Specifies zero repeats if possible, or one (lazy ?).
{n}? Equivalent to {n} (lazy {n}).
{n,}? Specifies as few repeats as possible, but at least n (lazy {n,}).
{n,m}? Specifies as few repeats as possible between n and m (lazy {n,m
}).
See Also
Regular Expression Language Elements
JScript .NET
Anchors
Examples in previous topics in this section have only been concerned with finding chapter headings. Any occurrence of the string
Chapter followed by a space and a number could be an actual chapter heading, or it could also be a cross-reference to another
chapter. Since true chapter headings always appear at the beginning of a line, it may be useful to devise a way to find only the
headings and not the cross-references.
Anchors provide that capability. Anchors allow you to fix a regular expression to either the beginning or end of a line. They also
allow you to create regular expressions that occur within a word, at the beginning of a word, or at the end of a word. The
following table contains the list of regular expression anchors and their meanings:
Character Description
^ Matches the position at the beginning of the input string. If the RegExp object's Multiline property is set,
^ also matches the position following \n or \r.
$ Matches the position at the end of the input string. If the RegExp object's Multiline property is set, $ also
matches the position preceding \n or \r.
\b Matches a word boundary, that is, the position between a word and a space.
\B Matches a nonword boundary.
You cannot use a quantifier with an anchor. Since you cannot have more than one position immediately before or after a newline
or word boundary, expressions such as ^* are not permitted.
To match text at the beginning of a line of text, use the ^ character at the beginning of the regular expression. Do not confuse this
use of the ^ with the use within a bracket expression.
To match text at the end of a line of text, use the $ character at the end of the regular expression.
To use anchors when searching for chapter headings, the following regular expression matches a chapter heading that contains
no more than two following digits and that occurs at the beginning of a line:
/^Chapter [1-9][0-9]{0,1}/
Not only does a true chapter heading occur at the beginning of a line, it is also the only text on the line. It occurs at beginning of
the line and also at the end of the same line. The following expression ensures that the specified match only matches chapters and
not cross-references. It does so by creating a regular expression that matches only at the beginning and end of a line of text.
/^Chapter [1-9][0-9]{0,1}$/
Matching word boundaries is a little different but adds a very important capability to regular expressions. A word boundary is the
position between a word and a space. A nonword boundary is any other position. The following expression matches the first three
characters of the word Chapter because the characters appear following a word boundary:
/\bCha/
The position of the \b operator is critical. If it is at the beginning of a string to be matched, it looks for the match at the beginning
of the word. If it is at the end of the string, it looks for the match at the end of the word. For example, the following expression
matches the string ter in the word Chapter because it appears before a word boundary:
/ter\b/
The following expression matches the string apt as it occurs in Chapter but not as it occurs in aptitude:
/\Bapt/
The string apt occurs on a nonword boundary in the word Chapter but on a word boundary in the word aptitude. For the \B
nonword boundary operator, position is not important because the match is not relative to the beginning or end of a word.
See Also
Introduction to Regular Expressions
JScript .NET
/^Chapter|Section [1-9][0-9]{0,1}$/
Unfortunately, the above regular expression matches either the word Chapter at the beginning of a line, or the word Section and
whatever numbers follow Section at the end of the line. If the input string is Chapter 22, the above expression only matches the
word Chapter. If the input string is Section 22, the expression matches Section 22.
To make the regular expressions more responsive, you can use parentheses to limit the scope of the alternation, that is, to make
sure that it applies only to the two words Chapter and Section. However, parentheses are also used to create subexpressions and
possibly capture them for later use, something that is covered in the section on backreferences. By adding parentheses in the
appropriate places of the above regular expression, you can make the regular expression match either Chapter 1 or Section 3.
The following regular expression uses parentheses to group Chapter and Section so the expression works properly:
/^(Chapter|Section) [1-9][0-9]{0,1}$/
Although these expressions work properly, the parentheses around Chapter|Section also cause either of the two matching words
to be captured for future use. Since there is only one set of parentheses in the above expression, there is only one captured
submatch. This submatch can be referred to by using the $1-$9 properties of the RegExp object.
In the above example, you merely want to use the parentheses to group a choice between the words Chapter and Section. To
prevent the match from being saved for possible later use, place ?: before the regular expression pattern inside the parentheses.
The following modification provides the same capability without saving the submatch:
/^(?:Chapter|Section) [1-9][0-9]{0,1}$/
In addition to the ?: metacharacters, two other non-capturing metacharacters create something called lookahead matches. A
positive lookahead, which is specified using ?=, matches the search string at any point where a matching regular expression
pattern in parentheses begins. A negative lookahead, which is specified using ?!, matches the search string at any point where a
string not matching the regular expression pattern begins.
For example, suppose you have a document that contains references to Windows 3.1, Windows 95, Windows 98, and Windows
NT. Suppose further that you need to update the document by changing all references to Windows 95, Windows 98, and
Windows NT to Windows 2000. The following regular expression, which is an example of a positive lookahead, matches Windows
95, Windows 98, and Windows NT:
Once a match is found, the search for the next match begins immediately following the matched text without including the
characters in the look-ahead. For example, if the above expression matched Windows 98, the search resumes after Windows not
after 98.
See Also
Introduction to Regular Expressions | Backreferences
JScript .NET
Referencias inversas
Una de las características más importantes de las expresiones regulares es la capacidad de almacenar parte de un modelo
coincidente para su uso posterior. Recuerde que si el modelo, o parte del modelo, de una expresión regular se incluye entre
paréntesis, esa parte de la expresión se almacena en un búfer temporal. Para que no se guarde esa parte de la expresión regular,
utilice los metacaracteres sin captura ?:, ?= o ?!.
Cada subcoincidencia capturada se almacena de izquierda a derecha tal como se encontró en el modelo de expresiones regulares.
Los números de búfer comienzan por uno y continúan hasta un máximo de 99 subexpresiones capturadas. Se puede tener acceso
a cada búfer mediante \n, donde n equivale a uno o dos dígitos decimales que identifican un búfer específico.
Una de las aplicaciones más sencillas y útiles de las referencias inversas proporciona la capacidad para localizar la aparición de
dos palabras idénticas y adyacentes en el texto. Considere la frase siguiente:
Esta frase contiene claramente varias palabras duplicadas. Se podría idear alguna forma de corregir esta frase sin buscar los
duplicados de cada palabra. La siguiente expresión regular utiliza una única subexpresión para hacer esto:
/\b([a-z]+) \1\b/gi
La expresión capturada, como especifica [a-z]+, incluye uno o varios caracteres alfabéticos. La segunda parte de la expresión
regular es la referencia a la subcoincidencia capturada previamente, esto es, la segunda aparición de la palabra que se había
encontrado justo antes con respecto a la expresión entre paréntesis. \1 especifica la primera subcoincidencia. Los metacaracteres
del límite de palabra garantizan que sólo se detectan palabras enteras. En caso contrario, esta expresión identificaría de forma
incorrecta frases como "es emitido" o "esto es".
El indicador global (g), que va después de la expresión regular, indica que la expresión se aplica a todas las coincidencias que se
puedan encontrar en la cadena de entrada. El indicador (i), situado al final de la expresión, especifica que no se hace distinción
entre mayúsculas y minúsculas. El indicador multiline especifica que se pueden encontrar coincidencias en cualquiera de los lados
de un carácter de nueva línea.
Mediante la expresión regular anterior, el siguiente código puede utilizar la información de subcoincidencia para reemplazar una
aparición de dos palabras idénticas consecutivas en una cadena de texto con una sola aparición de la misma palabra:
El uso de $1 en el método replace hace referencia a la primera subcoincidencia guardada. Si hubiera más de una
subcoincidencia, se podría hacer referencia a las mismas de forma consecutiva mediante $2, $3, etc.
Las referencias inversas también pueden desglosar un URI (Universal Resource Indicator, Indicador de recursos universal) en sus
distintos componentes. Supongamos que desea desglosar el siguiente URI en el protocolo (ftp, http, etc.), la dirección de dominio
y la página o ruta de acceso:
http://msdn.microsoft.com:80/scripting/default.htm
/(\w+):\/\/([^/:]+)(:\d*)?([^# ]*)/
La primera subexpresión entre paréntesis captura la parte del protocolo de la dirección Web. Esa subexpresión coincide con
cualquier palabra que preceda a los dos puntos y a dos barras diagonales. La segunda subexpresión entre paréntesis captura la
parte de la dirección del dominio. Esa subexpresión coincide con cualquier secuencia de caracteres que no incluya los caracteres /
o :. La tercera subexpresión entre paréntesis captura un número de puerto, si se ha especificado alguno. Esa subexpresión coincide
con cero o más dígitos que sigan a un signo de dos puntos. Por último, la cuarta subexpresión entre paréntesis captura la
información de ruta de acceso y/o la página especificada por la dirección Web. Esa subexpresión coincide con uno o varios
caracteres distintos de # o del carácter de espacio.
Al aplicar la expresión regular al URI anterior, las subcoincidencias contienen lo siguiente:
RegExp.$1 contiene "http"
RegExp.$2 contiene "msdn.microsoft.com"
RegExp.$3 contiene ":80"
RegExp.$4 contiene "/scripting/default.htm"
Vea también
JScript Reference
The JScript .NET programming language includes an assortment of properties, methods, objects, functions, and so on. In addition,
JScript .NET can utilize many corresponding features from the .NET Framework class library. The following sections explain the
proper use of these features and the proper syntax within JScript .NET.
In This Section
Feature Information
Provides version information about the language features in JScript .NET, and compares the features with those specified by the
ECMAScript standard.
JScript Language Tour
Introduces the elements and procedures that developers use to write JScript code and links to specific areas that explain the
details behind language elements and code syntax.
JScript .NET Language Reference
Lists the essential components of the JScript .NET object-oriented programming language and links to topics that explain how
to use the language.
JScript Compiler Options
Lists options available for the command line compiler and links to topics that organize the options either alphabetically or by
category.
Related Sections
.NET Framework Reference
Lists links to topics that explain the syntax and structure of the .NET Framework class library and other essential elements.
JScript .NET
Feature Information
The JScript .NET programming language includes an assortment of properties, methods, objects, functions, and so on. In addition,
JScript .NET can utilize many corresponding features from the .NET Framework class library. The following sections explain the
proper use of these features and the proper syntax within JScript .NET.
In This Section
Microsoft JScript Features - ECMA
Identifies the language features in JScript .NET that are part of the ECMAScript Language Specification.
Microsoft JScript Features - Non-ECMA
Identifies the language features in JScript .NET that are not included in the ECMAScript Language Specification.
Version Information
Provides comparisons between the different versions of JScript.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
JScript .NET
Vea también
Características de Microsoft JScript no incluidas en el estándar ECMA Referencia de JScript
JScript .NET
Vea también
Características de Microsoft JScript incluidas en el estándar ECMA Referencia de JScript
JScript .NET
Información de versión
JScript es un lenguaje que continúa evolucionando y cada nueva versión del lenguaje presenta nuevas características. Para sacar
partido a todas las características que proporciona una versión determinada del lenguaje, es necesario poseer una versión
compatible del compilador o motor de secuencias de comandos.
Cuando se escribe código para una aplicación de servidor o un programa de línea de comandos, normalmente se conocen la
versión del compilador y la versión de JScript que admite. Sin embargo, cuando se escriben secuencias de comandos de cliente
que se ejecutan en el motor de secuencias de comandos de un explorador, la secuencia en ejecución detecta la versión del motor.
Una vez que se conoce la versión del motor, se puede ejecutar una secuencia de comandos escrita en una versión compatible de
JScript. Para obtener más información, vea Detectar las funciones del explorador.
La tabla siguiente muestra la versión de Microsoft JScript implementada por las aplicaciones host.
Aplicación host 1.0 2.0 3.0 4.0 5.0 5.1 5.5 5.6 .NET
Microsoft Internet Explorer 3.0 x
Microsoft Internet Information Server 3.0 x
Microsoft Internet Explorer 4.0 x
Microsoft Internet Information Server 4.0 x
Microsoft Internet Explorer 5.0 x
Microsoft Internet Explorer 5.01 x
Microsoft Windows 2000 x
Microsoft Internet Explorer 5.5 x
Microsoft Windows Millennium Edition x
Microsoft Internet Explorer 6.0 x
Microsoft Windows XP x
Microsoft Windows Server 2003 x
Microsoft .NET Framework 1.0 x
Nota El número de versión proporcionado por la función ScriptEngineMajorVersion y la variable de compilación
condicional @_jscript_version siempre son valores numéricos. De esta forma, es posible realizar la comparación
numérica con el número de versión. Para las aplicaciones de la versión .NET, la versión proporcionada es la 7.x, no la
.NET. Esto significa que los motores que proporcionan la versión 7.x o superior pueden compilar código de JScript
.NET.
La tabla siguiente muestra las características del lenguaje JScript y la versión en la que se introdujeron por primera vez.
Elemento del lenguaje 1.0 2.0 3.0 4.0 5.0 5.5 .NET
0...n (Propiedad) x
$1...$9 (Propiedades) x
abs (Método) x
abstract (Modificador) x
acos (Método) x
ActiveXObject (Objeto) x
Operador de suma (+) x
Operador de asignación y suma (+=) x
anchor (Método) x
apply (Método) x
arguments (Objeto) x
arguments (Propiedad) x
Array (Objeto) x
asin (Método) x
Operador de asignación (=) x
atan (Método) x
atan2 (Método) x
atEnd (Método) x
big (Método) x
Operador AND bit a bit (&) x
Operador de asignación y AND bit a bit (&=) x
Operador de desplazamiento bit a bit a la izquierda (<<) x
Operador NOT bit a bit (~) x
Operador OR bit a bit (|) x
Operador de asignación y OR bit a bit (|=) x
Operador de desplazamiento bit a bit a la derecha (>>) x
Operador XOR bit a bit (^) x
Operador de asignación y XOR bit a bit (^=) x
blink (Método) x
bold (Método) x
boolean (Tipo de datos) x
Boolean (Objeto) x
break (Instrucción) x
byte (Tipo de datos) x
call (Método) x
callee (Propiedad) x
caller (Propiedad) x
catch (Instrucción) x
@cc_on (Instrucción) x
ceil (Método) x
char (Tipo de datos) x
charAt (Método) x
charCodeAt (Método) x
class (Instrucción) x
Operador coma (,) x
// (Instrucción, comentario de una sola línea) x
/*..*/ (Instrucción, comentario de varias líneas) x
Operadores de comparación x
compile (Método) x
concat (Método, Array) x
concat (Método, String) x
Compilación condicional x
Variables de compilación condicional x
Operador condicional ternario (?:) x
const (Instrucción) x
constructor (Propiedad) x
continue (Instrucción) x
cos (Método) x
Conversión de tipo de datos x
Date (Objeto) x
@debug (Directiva) x
debugger (Instrucción) x
decimal (Tipo de datos) x
decodeURI (Método) x
decodeURIComponent (Método) x
Operador de decremento (--) x
delete (Operador) x
description (Propiedad) x
dimensions (Método) x
Operador de división (/) x
Operador de asignación y división (/=) x
do...while (Instrucción) x
double (Tipo de datos) x
E (Propiedad) x
encodeURI (Método) x
encodeURIComponent (Método) x
enum (Instrucción) x
Enumerator (Objeto) x
Operador de igualdad (==) x
Error (Objeto) x
escape (Método) x
eval (Método) x
exec (Método) x
exp (Método) x
expando (Modificador) x
false (Literal) x
final (Modificador) x
fixed (Método) x
float (Tipo de datos) x
floor (Método) x
fontcolor (Método) x
fontsize (Método) x
for (Instrucción) x
for...in (Instrucción) x
fromCharCode (Método) x
function get (Instrucción) x
Function (Objeto) x
function set (Instrucción) x
function (Instrucción) x
getDate (Método) x
getDay (Método) x
getFullYear (Método) x
getHours (Método) x
getItem (Método) x
getMilliseconds (Método) x
getMinutes (Método) x
getMonth (Método) x
GetObject (Función) x
getSeconds (Método) x
getTime (Método) x
getTimezoneOffset (Método) x
getUTCDate (Método) x
getUTCDay (Método) x
getUTCFullYear (Método) x
getUTCHours (Método) x
getUTCMilliseconds (Método) x
getUTCMinutes (Método) x
getUTCMonth (Método) x
getUTCSeconds (Método) x
getVarDate (Método) x
getYear (Método) x
Global (Objeto) x
global (Propiedad) x
Operador mayor que (>) x
Operador mayor o igual que (>=) x
hasOwnProperty (Método) x
hide (Modificador) x
@if (Instrucción) x
if...else (Instrucción) x
ignoreCase (Propiedad) x
import (Instrucción) x
in (Operador) x
Operador de incremento (++) x
index (Propiedad) x
indexOf (Método) x
Operador de desigualdad (!=) x
Infinity (Propiedad) x
input ($_) (Propiedad) x
Operador instanceof x
int (Tipo de datos) x
interface (Instrucción) x
internal (Modificador) x
isFinite (Método) x
isNaN (Método) x
isPrototypeOf (Método) x
italics (Método) x
item (Método) x
Tipos de datos de JScript x
join (Método) x
Instrucción con etiqueta x
lastIndex (Propiedad) x
lastIndexOf (Método) x
lastMatch ($&) (Propiedad) x
lastParen ($+) (Propiedad) x
lbound (Método) x
leftContext ($`) (Propiedad) x
Operador de asignación y desplazamiento a la izquierda (<<=) x
length (Propiedad, arguments) x
length (Propiedad, Array) x
length (Propiedad, Function) x
length (Propiedad, String) x
Operador menor que (<) x
Operador menor o igual que (<=) x
link (Método) x
LN2 (Propiedad) x
LN10 (Propiedad) x
localeCompare (Método) x
log (Método) x
LOG2E (Propiedad) x
LOG10E (Propiedad) x
Operador lógico AND (&&) x
Operador lógico NOT (!) x
Operador lógico OR (||) x
long (Tipo de datos) x
match (Método) x
Math (Objeto) x
max (Método) x
MAX_VALUE (Propiedad) x
message (Propiedad) x
min (Método) x
MIN_VALUE (Propiedad) x
Operador de módulo (%) x
Operador de asignación y módulo (%=) x
moveFirst (Método) x
moveNext (Método) x
multiline (Propiedad) x
Operador de multiplicación (*) x
Operador de asignación y multiplicación (*=) x
name (Propiedad) x
NaN (Propiedad, Global) x
NaN (Propiedad, Number) x
NEGATIVE_INFINITY (Propiedad) x
new (Operador) x
Operador de no identidad (!==) x
null (Literal) x
Number (Tipo de datos) x
Number (Objeto) x
number (Propiedad) x
Object (Objeto) x
Precedencia de operadores x
override (Modificador) x
package (Instrucción) x
parse (Método) x
parseFloat (Método) x
parseInt (Método) x
PI (Propiedad) x
pop (Método) x
@position (Directiva) x
POSITIVE_INFINITY (Propiedad) x
pow (Método) x
print (Instrucción) x
private (Modificador) x
propertyIsEnumerable (Propiedad) x
protected (Modificador) x
prototype (Propiedad) x
public (Modificador) x
push (Método) x
random (Método) x
RegExp (Objeto) x
Regular Expression (Objeto) x
Sintaxis de expresiones regulares x
replace (Método) x
return (Instrucción) x
reverse (Método) x
rightContext ($') (Propiedad) x
Operador de asignación y desplazamiento a la derecha (>>=) x
round (Método) x
sbyte (Tipo de datos) x
ScriptEngine (Función) x
ScriptEngineBuildVersion (Función) x
ScriptEngineMajorVersion (Función) x
ScriptEngineMinorVersion (Función) x
search (Método) x
@set (Instrucción) x
setDate (Método) x
setFullYear (Método) x
setHours (Método) x
setMilliseconds (Método) x
setMinutes (Método) x
setMonth (Método) x
setSeconds (Método) x
setTime (Método) x
setUTCDate (Método) x
setUTCFullYear (Método) x
setUTCHours (Método) x
setUTCMilliseconds (Método) x
setUTCMinutes (Método) x
setUTCMonth (Método) x
setUTCSeconds (Método) x
setYear (Método) x
shift (Método) x
short (Tipo de datos) x
sin (Método) x
slice (Método, Array) x
slice (Método, String) x
small (Método) x
sort (Método) x
source (Propiedad) x
splice (Método) x
split (Método) x
sqrt (Método) x
SQRT1_2 (Propiedad) x
SQRT2 (Propiedad) x
static (Modificador) x
static (Instrucción) x
Operador de igualdad estricta (===) x
strike (Método) x
String (Tipo de datos) x
String (Objeto) x
sub (Método) x
substr (Método) x
substring (Método) x
Operador de resta (-) x
Operador de asignación y resta (-=) x
sup (Método) x
super (Instrucción) x
switch (Instrucción) x
tan (Método) x
test (Método) x
this (Instrucción) x
throw (Instrucción) x
toArray (Método) x
toDateString (Método) x
toExponential (Método) x
toFixed (Método) x
toGMTString (Método) x
toLocaleDateString (Método) x
toLocaleLowerCase (Método) x
toLocaleString (Método) x
toLocaleTimeString (Método) x
toLocaleUpperCase (Método) x
toLowerCase (Método) x
toPrecision (Método) x
toString (Método) x
toTimeString (Método) x
toUpperCase (Método) x
toUTCString (Método) x
true (Literal) x
try...catch...finally (Instrucción) x
Anotaciones de tipo x
Conversión de tipos x
Operador typeof x
ubound (Método) x
uint (Tipo de datos) x
ulong (Tipo de datos) x
Operador unario de negación (-) x
undefined (Propiedad) x
unescape (Método) x
unshift (Método) x
Operador de desplazamiento bit a bit a la derecha (>>>) x
Operador de asignación y desplazamiento a la derecha sin signo (>>>=) x
ushort (Tipo de datos) x
UTC (Método) x
valueOf (Método) x
var (Instrucción) x
VBArray (Objeto) x
Operador void x
while (Instrucción) x
with (Instrucción) x
Vea también
Related Sections
JScript .NET Language Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
.NET Framework Class Library
Contains links to topics that explain the classes in the .NET Framework class library and explains how to use the class library
documentation.
JScript .NET
JScript Arrays
An array groups related pieces of data in one variable. A unique number, called an index or subscript, combined with the shared
variable name distinguishes each element in the array. Arrays result in shorter and simpler code in many situations because loops
can deal efficiently with any number of elements by using the index number.
JScript provides two different types of arrays, JScript array objects and typed arrays. In JScript array objects, which are sparse, a
script can dynamically add and remove elements, and elements can be of any data type. In typed arrays, which are dense, the size
is fixed, and elements must be the same type as the base type of the array.
In This Section
Arrays Overview
Describes the two types of JScript arrays, the differences between the types, and how to choose the appropriate array type.
Array Declaration
Explains the concept of declaring arrays and how declaring arrays with the new operator differs from declaring array literals.
Array Use
Demonstrates how to access the elements of one-dimensional arrays, multidimensional arrays, and arrays of arrays.
Arrays of Arrays
Explains the concept of arrays of arrays, why arrays of arrays are useful, and how to use them.
Multidimensional Arrays
Explains the concept of multidimensional arrays, how they differ from arrays of arrays, and how to use them.
Related Sections
Array Data
Illustrates how to compose array literal values and how to combine data types in the same array.
Array Object
Reference information that describes the JScript Array object, how to use it, and how it interoperates with the System.Array
data type.
JScript .NET
Arrays Overview
An array collects more than one piece of data in one variable. A single index number (for a one-dimensional array) or several
index numbers (for an array of arrays or a multidimensional array) references the data in the array. You can refer to an individual
element of an array with the array identifier followed with the array index in square brackets ([]). To refer to the array as a whole,
just use the array identifier. Collecting data in arrays simplifies data management. For example, by using an array, a method can
pass a list of names to a function using only one parameter.
There are two types of arrays in JScript, JScript arrays and typed arrays. While the two types of arrays are similar, there are a few
differences. JScript arrays and typed arrays can interoperate with each other. Consequently, a JScript Array object can call the
methods and properties of any typed array, and typed arrays can call many of the methods and properties of the Array object.
Furthermore, functions that accept typed arrays accept Array objects, and vice versa. For more information, see Array Object.
Typed Arrays
Typed arrays (also called native arrays) are similar to arrays used in languages such as C and C++. Typed arrays provide type
safety by only storing data that corresponds to the type that the array type declaration specified.
Note You can define a typed array of type Object to store data of any type.
When the script creates or initializes the array, it sets the number of elements in a typed array. The only way to change the
number of elements is by recreating the array. A typed array created with n elements has elements numbered 0 through n-1. An
attempt to access elements outside that range generates an error. In addition, typed arrays are dense, that is, every index in the
allowed range refers to an element.
A script can assign a declared, typed array to a variable or constant, or it can pass the array to a function, operator, or statement.
When assigning to a variable (or constant), make sure that the data type of the variable matches the type of the array and that the
dimensionalities of the arrays match.
A typed array is an instance of the .NET Framework System.Array object. To access static members of the System.Array object
or to explicitly create a System.Array object requires the fully qualified name System.Array. This syntax distinguishes it from
Array, the intrinsic JScript Array object.
JScript Arrays
A JScript Array object, which provides more flexibility than a typed array, is convenient when you want a generic stack, when you
want a list of items, and when performance is not a top concern. However, since typed arrays provide type safety, performance
improvements, and better interaction with other languages, developers typically choose typed arrays instead of JScript arrays.
A JScript array can store data of any type, which makes it easy to quickly write scripts that use arrays without considering type
conflicts. Since this bypasses the strong type checking that JScript .NET provides, use this feature carefully.
Scripts can dynamically add elements to or remove elements from JScript arrays. To add an array element, assign a value to the
element. The delete operator can remove elements.
A JScript array is sparse. That is, if an array has three elements that are numbered 0, 1, and 2, element 50 can exist without the
presence of elements 3 through 49. Each JScript array has a length property that is automatically updated when an element is
added. In the previous example, the addition of element 50 causes the value of the length variable to change to 51 rather than to
4.
A JScript Array object and a JScript Object are almost identical. The two main differences are that an Object (by default) does not
have an automatic length property, and a JScript Object does not have the properties and methods of an Array. For more
information, see JScript Array Object.
See Also
JScript Arrays | Array Data | Array Object | JScript Array Object
JScript .NET
Array Declaration
As with all other data in JScript, variables can store arrays. Type annotation can specify that a variable must contain an array
object or a typed array, but it does not provide an initial array. To store an array in a variable, you must declare an array and
assign it to that variable.
Declaring a JScript array object creates a new Array object, while declaring a typed array reserves a section of memory large
enough to store every element of the array. Both types of arrays can be declared either by using the new operator to explicitly
construct a new array, or by using an array literal.
Array Declaration with the new Operator
To declare a new JScript Array object, you can use the new operator with the Array constructor. Since you can dynamically add
members to a JScript array, you do not need to specify an initial size for the array. In this example, a1 is assigned a zero length
array.
To assign an initial length to the array created with the Array constructor, pass an integer to the array constructor. The array
length must be zero or positive. The following code assigns an array of length 10 to a2.
If more than one parameter or a single non-numeric parameter is passed to the Array constructor, the resulting array contains all
the parameters as the array elements. For example, the following code creates an array in which element 0 is the number 10,
element 1 is the string "Hello", and element 2 is the current date.
The new operator can also declare typed arrays. Since typed arrays cannot accept dynamically added elements, the declaration
must specify the size of the array. The constructor for typed arrays uses square brackets instead of parentheses around the array
size. For example, the following code declares an array of five integers.
The new operator can also declare multidimensional arrays. The following example declares a three-by-four-by-five array of
integers.
When declaring an array of arrays, the base array must be declared before declaring the subarrays; they cannot all be declared at
the same time. This provides flexibility in determining the sizes of the subarrays. In this example, the first subarray has length 1,
the second has length 2, and so on.
Array literals can also initialize arrays of arrays. In the following example, an array of two arrays of integers initializes both the
JScript array and the typed array.
Array Use
There are several types of arrays that can be used in JScript .NET. The following information explains how to use some of these
arrays and how to choose an appropriate array for your particular application.
One-Dimensional Arrays
The following example shows how to access the first and last elements of the addressBook array. This assumes that another part
of the script defines and assigns a value to addressBook. Since arrays are zero-indexed in JScript, the first element of an array is
zero and the last element is the length of the array minus one.
See Also
JScript Arrays | Arrays of Arrays | Multidimensional Arrays | for...in Statement
JScript .NET
Arrays of Arrays
It is possible to create an array and populate it with other arrays. The base array can be either a JScript array or a typed array.
JScript arrays allow more flexibility in the types of stored data, while typed arrays prevent storage of inappropriately typed data in
the array.
Arrays of arrays are useful for applications in which each subarray has a different length. If each subarray has the same length, a
multidimensional array may be more useful. For more information, see Multidimensional Arrays.
Typed Arrays of Arrays
In the following example, an array of arrays of strings stores pet names. Since the number of elements in each subarray is
independent of the others (the number of cat names can be different from the number of dog names), an array of arrays is used
instead of a multidimensional array.
// Create two arrays, one for cats and one for dogs.
// The first element of each array identifies the species of pet.
var cats : String[] = ["Cat","Beansprout", "Pumpkin", "Max"];
var dogs : String[] = ["Dog","Oly","Sib"];
// Create a typed array of String arrays, and initialze it.
var pets : String[][] = [cats, dogs];
Cat: Beansprout
Cat: Pumpkin
Cat: Max
Dog: Oly
Dog: Sib
You can also use a typed array of type Object to store arrays.
JScript Array of Arrays
Using a JScript array as the base array provides flexibility in the types of stored subarrays. For example, the following code creates
a JScript array that stores JScript arrays containing strings and integers.
Matrices multidimensionales
En JScript puede crear matrices con tipo multidimensionales. Las matrices multidimensionales utilizan varios índices para tener
acceso a los datos. Cuando la secuencia de comandos declara la matriz, establece el intervalo de cada índice. Las matrices
multidimensionales son similares a las matrices de matrices, en las que cada submatriz puede tener una longitud diferente. Para
obtener más información, vea Matrices de matrices.
El tipo de datos de una matriz unidimensional se define mediante el nombre del tipo de datos seguido de un par de corchetes ([]).
Para especificar el tipo de datos de una matriz multidimensional se utiliza el mismo procedimiento, pero se incluyen comas (,)
entre los corchetes. La dimensionalidad de la matriz es igual al número de comas más uno. En el ejemplo siguiente se ilustra la
diferencia entre definir una matriz unidimensional y definir una multidimensional.
En el ejemplo siguiente, se utiliza una matriz bidimensional de caracteres para almacenar el estado de un tablero del tres en raya.
O| |
-+-+-
X|X|X
-+-+-
| |O
Puede utilizar una matriz con tipo multidimensional de tipo Object para almacenar datos de cualquier tipo.
Vea también
Matrices de JScript | Datos de matriz | Matrices de matrices
JScript .NET
anInteger = 3;
y = (x == 2000);
Here, the value of the variable x is tested to see if it is equal to the number 2000. If it is, the result of the comparison is the
Boolean value true, which is assigned to the variable y. If x is not equal to 2000, then the result of the comparison is the Boolean
value false, assigned to y.
The equality operator will type convert to check if the values are the same. In the following line of JScript code, the literal string
"42" will be converted to a number before comparing it to the number 42. The result is true.
42 == "42";
Objects are compared using different rules. The behavior of the equality operator depends on the type of the objects. If the objects
are instances of a class that is defined with an equity operator, the returned value depends on the implementation of the equity
operator. Classes which provide an equity operator cannot be defined in JScript .NET, although other .NET Framework languages
allow for such class definitions.
Objects without a defined equity operator, such as an object based on the JScript Object object or an instance of a JScript .NET
class, compare as equal only if both objects refer to the same object. This means that two distinct objects that contain the same
data compare as different. The following example illustrates this behavior.
// A primitive string.
var string1 = "Hello";
// Two distinct String objects with the same value.
var StringObject1 = new String(string1);
var StringObject2 = new String(string1);
// An object converts to a primitive when
// comparing an object and a primitive.
print(string1 == StringObject1); // Prints true.
// Two distinct objects compare as different.
print(StringObject1 == StringObject2); // Prints false.
Equality operators are especially useful in the condition statements of control structures. Here, you combine an equality operator
with a statement that uses it. Consider the following JScript code sample.
if (x == 2000)
z = z + 1;
else
x = x + 1;
The if...else statement in JScript performs one action (in this case, z = z + 1) if the value of x is 2000, and an alternate action (x
= x + 1) if the value of x is not 2000. For more information, see JScript Conditional Structures.
The strict equality operator (===) only performs type conversion on numeric data types. This means that the integer 42 is
considered to be identical to the double 42, but both are not identical to the string "42". This behavior is demonstrated by this
JScript code.
See Also
JScript Language Tour | Boolean Data | JScript Conditional Structures | Type Conversion
JScript .NET
JScript Comments
A single-line JScript comment begins with a pair of forward slashes (//). Here is an example of a single-line comment, followed by
a line of code.
A multiline JScript comment begins with a forward slash and asterisk (/*), and ends with the reverse (*/).
/*
This is a multiline comment that explains the preceding code statement.
The statement assigns a value to the aGoodIdea variable. The value,
which is contained between the quote marks, is called a literal. A
literal explicitly and directly contains information; it does not
refer to the information indirectly. The quote marks are not part
of the literal.
*/
If you attempt to embed one multiline comment within another, JScript interprets the resulting multiline comment in an
unexpected way. The */ that marks the end of the embedded multiline comment is interpreted as the end of the entire multiline
comment. Consequently, the text following the embedded multiline comment is interpreted as JScript code and may generate
syntax errors.
In the following example, the third line of text is interpreted as JScript code because JScript has interpreted the innermost */ to be
the end of the outermost comment:
It is recommended that you write all comments as blocks of single-line comments. This allows you to comment out large
segments of code with a multiline comment later.
Alternatively, you can use conditional compilation to safely and effectively comment out large segments of code.
See Also
JScript Reference | JScript Language Tour | Conditional Compilation
JScript .NET
JScript Expressions
A JScript expression is a combination of keywords, operators, variables, and literals that yield a value. An expression can perform
a calculation, manipulate data, call a function, test data, or perform other operations.
The simplest expressions are literals. Here are some examples of JScript literal expressions. For more information, see
Data in JScript.
Expressions that are more complicated can contain variables, function calls, and other expressions. You can use operators to
combine expressions and create complex expressions. Examples of using operators are:
4 + 5 // additon
x += 1 // addition assignment
10 / 2 // division
a & b // bitwise AND
radius = 10;
anExpression = 3 * (4 / 5) + 6;
aSecondExpression = Math.PI * radius * radius;
aThirdExpression = "Area is " + aSecondExpression + ".";
myArray = new Array("hello", Math.PI, 42);
myPi = myArray[1];
See Also
JScript Reference | JScript Language Tour | JScript Operators | JScript Variables and Constants
JScript .NET
JScript Identifiers
In JScript, identifiers are used to:
name variables, constants, functions, classes, interfaces, and enumerations
provide labels for loops (not used very often).
JScript is a case-sensitive language. Consequently, a variable named myCounter is different from a variable named MyCounter.
Variable names can be of any length. The rules for creating valid variable names are as follows:
The first character must be a Unicode letter (either uppercase or lowercase) or an underscore (_) character. Note that a
number cannot be used as the first character.
Subsequent characters must be letters, numbers, or underscores.
The variable name must not be a reserved word.
Here are some examples of valid identifiers:
_pagecount
Part9
Number_Items
When choosing identifiers, avoid JScript reserved words and words that are already the names of intrinsic JScript objects or
functions, such as String or parseInt.
See Also
JScript Variables and Constants | JScript Functions | JScript Objects | JScript Reserved Words
JScript .NET
JScript Statements
A JScript program is a collection of statements. A JScript statement, which is equivalent to a complete sentence in a natural
language, combines expressions that perform one complete task.
A statement consists of one or more expressions, keywords, or operators (symbols). Typically, a statement is contained within a
single line, although two or more statements can appear on the same line if they are separated with semicolons. In addition, most
statements can span multiple lines. The exceptions are:
The postfix increment and decrement operators must appear on the same line as their argument. For example, x++ and i--.
The continue and break keywords must appear on the same line as their label. For example, continue label1 and break
label2.
The return and throw keywords must appear on the same line as their expression. For example, return (x+y), and throw
"Error 42".
A custom attribute must appear on the same line as the declaration it is modifying, unless it is preceded by a modifier. For
example, myattribute class myClass.
Although explicit termination of statements at the end of a line is not required, most of the JScript .NET examples provided here
are explicitly terminated for clarity. This is done with the semicolon (;), which is the JScript statement termination character. Here
are two examples of JScript statements.
var aBird = "Robin"; // Assign the text "Robin" to the variable aBird.
var today = new Date(); // Assign today's date to the variable today.
A group of JScript statements surrounded by braces ({}) is called a block. Statements within a block can generally be treated as a
single statement. This means you can use blocks in most places that JScript expects a lone statement. Notable exceptions include
the headers of for and while loops. The following example illustrates a typical for loop:
var i : int = 0;
var x : double = 2;
var a = new Array(4);
for (i = 0; i < 4; i++) {
x *= x;
a[i] = x;
}
Notice that the individual statements within the block end with semicolons, but the block itself does not.
Generally, functions, conditionals, and classes use blocks. Notice that unlike C++ and most other languages, JScript does not
consider a block to be a new scope; only functions, classes, static initializers, and catch blocks create a new scope.
In the following example, the first statement begins the definition of a function that consists of an if...else sequence of three
statements. Following that block is a statement that is not enclosed in the braces of the function block. Therefore, the last
statement is not part of the function definition.
See Also
JScript Reference | JScript Language Tour | class Statement | function Statement | if...else Statement | static Statement
JScript .NET
Data in JScript
As with most languages, JScript uses several fundamental kinds of data. Among these are numeric data and string data. A string is
a block of text. There are several ways to enter this data in a JScript program. Data is often entered with literal expressions.
In This Section
Array Data
Explains the concept of arrays in JScript and how to enter array data using array literals in a script.
Boolean Data
Explains the concept of Boolean data and how to use either of its two literal values in JScript code.
Numeric Data
Describes the difference between integral and floating-point data and how to enter numeric data in a script.
String Data
Explains the concept of string data, its syntax, and the use of escape characters.
Object Data
Describes the concept of object data in Jscript, its initialization and use.
Related Sections
JScript Data Types
Includes links to topics that explain how to use primitive data types, reference data types, and .NET Framework data types in
JScript.
Data Types
Lists links to reference topics that explain the intrinsic data types and their associated properties and methods.
JScript .NET
Array Data
An array literal can initialize an array in JScript. An array literal, which represents a JScript Array object, is represented by a
comma-delimited list that is surrounded by a pair of square brackets ([]). Each element of the list can be either a valid JScript
expression or empty (two consecutive commas). The index number of the first element in the array literal list is zero; each
subsequent element in the list corresponds to a subsequent element in the array. A JScript Array is sparse; if an element of the
array literal list is empty, the corresponding element in the JScript Array is not initialized.
In this example, the variable arr is initialized to be an array with three elements.
You can use empty elements in the Array literal list to create a sparse array. For example, the following Array literal represents an
array that defines only elements 0 and 4.
An array literal can include data of any type, including other arrays. In the following array of arrays, the second subarray has both
string and numeric data.
Since JScript Array objects interoperate with typed arrays, array literals can initialize typed arrays as well with a few restrictions.
The data in the array literal must be convertible to the data type of the typed array. An array literal cannot initialize a
multidimensional typed array, but an array literal can initialize a typed array of typed arrays. A two-step process occurs when an
array literal initializes a typed array. First, the array literal is converted to a typed array, which is used to initialize the typed array.
As a part of the conversion, each empty element of the array literal is first interpreted as undefined, and then every element of
the literal is converted to the appropriate data type for the typed array. In the following example, the same array literal is used to
initialize a JScript array, an integer array, and a double array.
The empty element of the array literal is represented as 0 in the integer array and NaN in the double array, since undefined
maps to those values.
See Also
Data in JScript | JScript Expressions | Data Types | JScript Arrays | Intrinsic Objects | Array Object | Type Conversion
JScript .NET
Boolean Data
Whereas numeric and string data types can have a virtually unlimited number of different values, the boolean data type can have
only two. They are the literals true and false. A Boolean value expresses the validity of a condition (tells whether the condition is
true or false).
You can use a literal Boolean value (true or false) as the condition statement in a control structure. For example, you can create a
potentially infinite loop using true as the condition for the while statement.
Note that the condition for breaking out of an infinite loop can be moved to the loop control, making it an explicitly finite loop.
However, some loops can be written much more simply using the infinite loop construction.
Using a Boolean literal in an if...else statement allows you to easily include a statement or choose between statements in your
program. This technique is useful for developing programs. However, it is more efficient to include a statement directly (without
an if statement) or use comments to prevent inclusion of a statement.
For more information, see JScript Conditional Structures.
See Also
Data in JScript | JScript Expressions | JScript Conditional Structures | true Literal | false Literal | boolean Data Type | Boolean Object
JScript .NET
Numeric Data
The choice between the two types of numeric data in JScript, integral data and floating-point data, depend on the particular
circumstances in which they are used. There are also different ways of representing integral data and floating-point data literally.
Positive whole numbers, negative whole numbers, and the number zero are integers. They can be represented in base 10
(decimal), base 8 (octal), and base 16 (hexadecimal). Most numbers in JScript are written in decimal. You denote octal integers by
prefixing them with a leading 0 (zero). They can contain digits 0 through 7 only. A number with a leading 0, containing the digits 8
and/or 9 is interpreted as a decimal number. Use of octal numbers is not generally recommended.
You denote hexadecimal (hex) integers by prefixing them with a leading "0x" (zero and x|X). They can contain digits 0 through 9,
and letters A through F (either uppercase or lowercase) only. The letters A through F represent, as single digits, 10 through 15 in
base 10. That is, 0xF is equivalent to 15, and 0x10 is equivalent to 16.
Both octal and hexadecimal numbers, which can be negative, cannot have a decimal portion and cannot be written in scientific
(exponential) notation.
Floating-point values are whole numbers with a decimal portion. Like integers, they can be represented literally with digits
followed by a decimal point and more digits. Additionally, they can be expressed in scientific notation. That is, an uppercase or
lowercase letter e is used to represent "times ten to the power of". A number that begins with a single 0 and contains a decimal
point is interpreted as a decimal floating-point literal and not an octal literal.
Additionally, floating-point numbers in JScript can represent special numerical values that integral data types cannot. These are:
NaN (not a number). This is used when a mathematical operation is performed on inappropriate data, such as strings or the
undefined value.
Infinity. This is used when a positive number is too large to represent in JScript.
-Infinity (negative Infinity) This is used when the magnitude of a negative number is too large to represent in JScript.
Positive and Negative 0. JScript differentiates between positive and negative zero in some situations.
Here are some examples of JScript numbers. Notice that a number that begins with "0x" and contains a decimal point will
generate an error.
Number Description Decimal Equivalent
.0001, 0.0001, 1e-4, 1.0e-4 Four equivalent floating-point numbers. 0.0001
3.45e2 A floating-point number. 345
42 An integer. 42
0378 An integer. Although this looks like an octal number (it begins 378
with a zero), 8 is not a valid octal digit, so the number is treate
d as a decimal. This produces a level 1 warning.
0377 An octal integer. Notice that although it only appears to be on 255
e less than the number above, its actual value is quite differen
t.
0.0001, 00.0001 A floating point number. Even though this begins with a zero, 0.0001
it is not an octal number because it has a decimal point.
0Xff A hexadecimal integer. 255
0x37CF A hexadecimal integer. 14287
0x3e7 A hexadecimal integer. Notice that the letter e is not treated a 999
s exponentiation.
0x3.45e2 This is an error. Hexadecimal numbers cannot have decimal p N/A (compiler error)
arts.
Variables of any integral data type can represent only a finite range of numbers. If you attempt to assign a numeric literal that is
too large or too small to an integral data type, a type-mismatch error will be generated at compile time. For more information, see
Data Type Summary.
Data Types of Literals
In most situations, the data type that JScript interprets numeric literals as is inconsequential. However, when the numbers are very
large or very precise, these details are important.
Integer literals in JScript can represent data of type int, long, ulong, decimal, or double, depending on the size of the literal and
its use. Literals in the range of the int type (-2147483648 to 2147483647) are interpreted as type int. Literals outside of that
range but within the range of the long type (-9223372036854775808 to 9223372036854775807) are interpreted as long.
Literals outside of that range but within the range of the ulong type (9223372036854775807 to 18446744073709551615) are
interpreted as ulong. All others integer literals are interpreted as type double, which entails a loss of precision. An exception to
the last rule is that the literal will be interpreted as a decimal if the literal is immediately stored in a variable or constant typed as
decimal, or if it is passed to a function that is typed to receive a decimal.
A JScript floating-point literal is interpreted as the data type double, unless the literal is immediately used as decimal (like
integer literals), in which case the literal is interpreted as a decimal. The decimal data type cannot represent NaN, positive
Infinity, or negative Infinity.
See Also
Data in JScript | JScript Expressions | Data Types | NaN Property (Global) | Infinity Property
JScript .NET
Object Data
An object literal can initialize a JScript Object object. An object literal is represented by a comma-delimited list that is surrounded
with a pair of curly braces ({}). Each element of the list is a property followed by a colon and the value of the property. The value
can be any valid JScript expression.
In this example, the variable obj is initialized to be an object with two properties, x and y, with the values 1 and 2 respectively.
Object literals can be nested. In this example, an identifier cylinder refers to an object with three properties, height, radius, and
sectionAreas. The sectionAreas property is an object with its own properties, top, bottom, and side.
var r = 3;
var h = 2;
var cylinder = { height : h, radius : r,
sectionAreas : { top : 4*Math.PI*r*r,
bottom : 4*Math.PI*r*r,
side : 2*Math.PI*r*h } };
Note An object literal cannot be used to initialize an instance of a class-based object. The appropriate constructor
function must be used to perform the initialization. For more information, see Class-based Objects.
See Also
Data in JScript | JScript Expressions | Intrinsic Objects | Object Object
JScript .NET
String Data
A string value is a chain of zero or more concatenated, Unicode characters (letters, digits, and punctuation marks). The string data
type represents text in JScript. To include string literals in your scripts, enclose them in matching pairs of single or double
quotation marks. Double quotation marks can be contained within strings surrounded by single quotation marks, and single
quotation marks can be contained within strings surrounded by double quotation marks. The following are examples of strings:
JScript provides escape sequences that you can include in strings to create characters that you cannot type directly. Each of these
sequences begins with a backslash. The backslash is an escape character that informs the JScript interpreter that the next
character is special.
Escape sequence Meaning
\b Backspace
\f Form feed (rarely used)
\n Line feed (newline)
\r Carriage return. Use with the line feed (\r\n) to format output.
\t Horizontal tab
\v Vertical tab (rarely used)
\' Single quote (')
\" Double quote (")
\\ Backslash (\)
\n ASCII character represented by the octal number n. The value of n must be in the range 0 to
377 (octal).
\xhh ASCII character represented by the two-digit hexadecimal number hh.
\uhhhh Unicode character represented by the four-digit hexadecimal number hhhh.
Any escape sequence not included in this table simply codes for the character that follows the backslash in the escape sequence.
For example, "\a" is interpreted as "a".
Since the backslash itself represents the start of an escape sequence, you cannot directly type one in your script. If you want to
include a backslash, you must type two sequential characters (\\).
The single quote and double quote escape sequences can be used to include quotes in string literals. This example shows
embedded quotes.
'The caption reads, \"After the snow of \'97. Grandma\'s house is covered.\"'
JScript uses the intrinsic char data type to represent a single character. A string containing one character or one escape sequence
can be assigned to a variable of type char, although the string is not itself of type char.
A string that contains zero characters ("") is an empty (zero-length) string.
See Also
Data in JScript | JScript Expressions | String Data Type | String Object
JScript .NET
Vea también
Tipos de datos | Tipos de datos definidos por el usuario | Objetos | import (Instrucción) | package (Instrucción) | class (Instrucción)
| Objetos de JScript | Copiar, pasar y comparar datos
JScript .NET
See Also
Data Types | class Statement | package Statement | JScript Objects | Type Annotation
JScript .NET
Typed Arrays
A typed array is a data type that can annotate variables, constants, functions, and parameters as if it were an intrinsic data type.
Every typed array has a base data type, and each element of the array is of that base type. The base type can itself be an array
type, allowing for arrays of arrays.
A data type that is followed by a set of square brackets defines a one-dimensional typed array. To define an n-dimensional array,
the base data type is followed by a set of square brackets with n-1 commas between the brackets.
No storage is initially allocated for a variable of a typed array type, and the initial value is undefined. To initialize an array
variable, use the new operator, an array literal, an array constructor, or another array. The initialization can occur when the typed
array variable is declared or later, as with variables of other types. A type mismatch error will result if the dimensionality of a
variable or parameter does not match the dimensionality (or type) of the array assigned to the variable or passed to the
parameter.
Using an array constructor, you can create an array of a given native type with a specified (fixed) size. Each argument must be an
expression that evaluates to a non-negative integer. The value of each argument determines the size of the array in each
dimension; the number of arguments determines the dimensionality of the array.
The following shows some simple array declarations:
// A three-dimensional array
var multidim : double[,,] = new double[5,4,3];
// Put some values into the matirx.
multidim[1,3,0] = Math.PI*5.;
See Also
var Statement | new Operator | function Statement | Type Annotation | Data Types
JScript .NET
Type Conversion
Type conversion is the process of changing a value from one type to another. For example, you can convert the string, "1234" to a
number. Furthermore, you can convert data of any type to the String type. Some type conversions will never succeed. For
example, a Date object cannot be converted to an ActiveXObject object.
Type conversions may either be widening or narrowing: widening conversions never overflow and always succeed, whereas
narrowing conversions entail the possible loss of information and may fail.
Both types of conversion may be explicit (using the data type identifier) or implicit (without the data type identifier). Valid explicit
conversions always succeed, even if it results in a loss of information. Implicit conversions succeed only when the process loses
no data; otherwise they fail and generate a compile or run-time error.
Lossy conversions happen when the original data type does not have an obvious analogue in the target conversion type. For
example, the string, "Fred", cannot be converted to a number. In these cases, a default value is returned from the type conversion
function. For the Number type, the default is NaN; for the int type the default is the number zero.
Some types of conversions, such as from a string to a number, are time-consuming. The fewer conversions your program uses,
the more efficient it will be.
Implicit Conversions
Most type conversions, such as assigning a value to a variable, occur automatically. The data type of the variable determines the
target data type of the expression conversion.
This example demonstrates how data can be implicitly converted between an int value, a String value, and a double value.
var i : int;
var d : double;
var s : String;
i = 5;
s = i; // Widening: the int value 5 coverted to the String "5".
d = i; // Widening: the int value 5 coverted to the double 5.
s = d; // Widening: the double value 5 coverted to the String "5".
i = d; // Narrowing: the double value 5 coverted to the int 5.
i = s; // Narrowing: the String value "5" coverted to the int 5.
d = s; // Narrowing: the String value "5" coverted to the double 5.
When this code is compiled, compile-time warnings may state that the narrowing conversions may fail or are slow.
Implicit narrowing conversions may not work if the conversion requires a loss of information. For example, the following lines will
not work.
var i : int;
var f : float;
var s : String;
f = 3.14;
i = f; // Run-time error. The number 3.14 cannot be represented with an int.
s = "apple";
i = s; // Run-time error. The string "apple" cannot be converted to an int.
Explicit Conversions
To explicitly convert an expression to a particular data type, use the data type identifier followed by the expression to convert in
parentheses. Explicit conversions require more typing than implicit conversions, but you can be more certain of the result.
Furthermore, explicit conversions can handle lossy conversions.
This example demonstrates how data can be explicitly converted between an int value, a String value, and a double value.
var i : int;
var d : double;
var s : String;
i = 5;
s = String(i); // Widening: the int value 5 coverted to the String "5".
d = double(i); // Widening: the int value 5 coverted to the double 5.
s = String(d); // Widening: the double value 5 coverted to the String "5".
i = int(d); // Narrowing: the double value 5 coverted to the int 5.
i = int(s); // Narrowing: the String value "5" coverted to the int 5.
d = double(s); // Narrowing: the String value "5" coverted to the double 5.
Explicit narrowing conversions will usually work, even if the conversion requires a loss of information. Explicit conversion cannot
be used to convert between incompatible data types. For example, you cannot convert Date data to or from RegExp data. In
addition, conversions are not possible for some values because there is no sensible value to which to convert. For example, an
error is thrown when attempting to explicitly convert the double value NaN to a decimal. This occurs because there is no natural
decimal value that could be identified with NaN.
In this example, a number with a decimal part is converted to an integer, and a string is converted to an integer.
var i : int;
var d : double;
var s : String;
d = 3.14;
i = int(d);
print(i);
s = "apple";
i = int(s);
print(i);
The output is
3
0
The behavior of the explicit conversion depends on both the original data type and the target data type.
See Also
undefined Property | JScript Data Types | Type Annotation
JScript .NET
Variables and constants store data that scripts can easily reference by using the name of the variable or constant. Data stored by a
variable may change as a program runs, while data stored by a constant cannot change. A script that uses a variable actually
accesses the data that the variable represents. Here is an example in which the variable named NumberOfDaysLeft is assigned the
value derived from the difference between EndDate and TodaysDate.
In a mechanical sense, a script uses variables to store, retrieve, and manipulate the values that appear in scripts. Constants
reference data that that does not change. Always create a meaningful variable name to help you remember the variable's purpose
and to help others determine the script's functionality.
In This Section
Types of JScript Variables and Constants
Discusses how to choose an appropriate data type for a variable and the benefits of proper variable data type selection.
Declaring JScript Variables and Constants
Explains how to declare typed and untyped variables and constants and how to initialize them.
Scope of Variables and Constants
Illustrates the difference between global and local scopes in JScript and how the local scope shadows the global scope.
Undefined Values
Explains the concept of undefined values, how to determine if a variable or property is undefined, and how to undefine variables
and properties.
Related Sections
JScript Identifiers
Explains how to create valid names for identifiers in JScript.
JScript Data Types
Includes links to topics that explain how to use primitive data types, reference data types, and .NET Framework data types in
JScript.
JScript Assignments and Equality
Explains how JScript assigns values to variables, array elements, and property elements and explains the equality syntax used by
JScript.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
JScript .NET
Constants, which are declared in much the same way as variables, must be initialized. Once a constant value is defined, its value
cannot be changed. For example:
Of course, when you declare a variable of a specific type, the assigned value must make sense for that type. For example, it does
not make sense to assign a character string value to an integer variable. When you do this, the program throws a TypeError
exception that indicates a type mismatch in your code. A TypeError is one kind of exception or error that can occur in a running
script. A catch block can catch exceptions thrown by a JScript program. For more information, see try...catch...finally Statement.
You can concurrently declare the type and initial value of multiple variables, although it is easier to read code when each
declaration is on a separate line. For example, this code segment is hard to read:
Something else to keep in mind when declaring several variables on a single line is that a type annotation applies only to the
variable that immediately precedes it. In the following code, x is an Object because that is the default type and x does not specify
a type, while y is an int.
var x, y : int;
Without a specified data type, the default type for a variable or constant is Object. Without an assigned value, the default value of
the variable is undefined. The following code demonstrates these defaults for a command-line program:
var count; // Declare a single declaration using default type and value.
print(count); //Print the value of count.
print(typeof(count)); // Prints undefined.
You can give a variable an initial value without declaring its type:
The following example declares several variables using a single var statement:
var count, amount, level; // multiple declarations with a single var keyword.
To declare a variable and initialize it without assigning it a particular value, assign it the JScript value null. Here is an example.
A declared variable without an assigned a value exists but has the JScript value undefined. Here is an example.
var currentCount;
var finalCount = 1 * currentCount; // finalCount has the value NaN since currentCount is unde
fined.
In JScript, the main difference between null and undefined is that null converts to zero (although it is not zero), while
undefined converts to the special value NaN (Not a Number). Ironically, a null value and an undefined value always compare
as equal when using the equality operator (==).
The process of declaring untyped constants is similar to the process of declaring variables, but you must provide an initial value
for untyped constants. For example:
const daysInWeek = 7;
const favoriteDay = "Friday";
const maxDaysInMonth = 31, maxMonthsInYear = 12
var volume = length * width; // Error - length and width do not yet exist.
Note Declaring variables without the var keyword generates a compile-time error when running in fast mode, the
default mode for JScript .NET. To compile a program from the command line that does not use the var keyword, you
must turn off the fast option by using /fast-. It is not safe to turn off the fast option in ASP.NET because of threading
issues.
See Also
JScript Identifiers | JScript Variables and Constants | JScript Data Types | Compiling JScript code from the Command Line
JScript .NET
function georgeNameAge() {
var name : String; // Define a local variable.
name = "George"; // Modify the local variable.
age = 42; // Modify the global variable.
print(name + " is " + age + " years old.");
}
The output of this program shows that a local variable can be modified without changing the value of the global variable.
Changes to the global variable from inside the function do affect the value in the global scope.
Since JScript processes variable and constant declarations before executing any code, it does not matter whether the declaration
is inside a conditional block or some other construct. Once JScript has found all the variables and constants, it executes the code
in the function. This means that the value of a local constant is undefined until the constant declaration statement is reached and
that a local variable is undefined until the variable is assigned to in the function.
Sometimes this results in unexpected behaviors. Consider the following program.
print(tweak());
Undefined Values
In JScript, you can declare a variable without assigning a value to it. A type-annotated variable assumes the default value for that
type. For example, the default value for a numeric type is zero, and the default for the String data type is the empty string.
However, a variable without a specified data type has an initial value of undefined and a data type of undefined. Likewise, code
that accesses an expando object property or an array element that does not exist returns a value of undefined.
To determine if a variable or object property exists, compare it to the keyword undefined (which will work only for a declared
variable or property), or check if its type is "undefined" (which will work even for an undeclared variable or property). In the
following code example, assume that the programmer is trying to test if the variable x has been declared:
Another way to check if a variable or object property is undefined is to compare the value to null. A variable that contains null
contains "no value" or "no object." In other words, it holds no valid number, string, Boolean, array, or object. You can erase the
contents of a variable (without deleting the variable) by assigning it the null value. Note that the value undefined and null
compare as equal using the equality (==) operator.
Note In JScript, null does not compare as equal to 0 using the equality operator. This behavior is different from
other languages, such as C and C++.
In this example, the object obj is tested to see if it has the property prop.
if ("prop" in someObject)
// someObject has the property 'prop'
Objetos de JScript
Un objeto de JScript es una encapsulación de datos y funcionalidad. Los objetos se componen de propiedades (valores) y
métodos (funciones). Las propiedades son el componente de datos del objeto, mientras que los métodos proporcionan la
funcionalidad para manipular los datos o el objeto. JScript admite cinco tipos de objeto: objetos intrínsecos, objetos basados en
prototipos, objetos basados en clases, objetos host, que proporciona un host (como Response en ASP .NET), y clases de .NET
Framework (componentes externos).
El operador new, junto con la función constructora del objeto seleccionado, crea e inicializa una instancia de un objeto. A
continuación figuran algunos ejemplos en los que se utilizan constructores.
JScript admite dos tipos de objetos definidos por el usuario: basados en clases y basados en prototipos. Los dos tipos tienen
ventajas e inconvenientes. Los objetos basados en prototipos se pueden extender dinámicamente, pero son lentos y no
interactúan eficazmente con objetos de otros lenguajes de .NET Framework. Los objetos basados en clases, por su parte, pueden
extender las clases existentes de .NET Framework, proporcionan seguridad de tipos y garantizan un funcionamiento eficaz. Los
objetos basados en clases se pueden extender dinámicamente, al igual que los basados en prototipos, si se define la clase con el
modificador expando.
En esta sección
Objetos intrínsecos
Muestra algunos de los objetos comunes que se utilizan en secuencias de comandos de JScript, así como vínculos a
información sobre cómo utilizarlos.
Objetos basados en clases
Proporciona una guía de uso del modelo de objetos basados en clases de JScript y describe cómo definir clases (con métodos,
campos y propiedades), cómo definir una clase que hereda de otra y cómo definir clases expando.
Objetos basados en prototipos
Proporciona una guía de uso del modelo de objetos basados en prototipos de JScript y vínculos a información que describe las
funciones personalizadas del constructor y la herencia de los objetos basados en prototipos.
Secciones relacionadas
Tipos de datos de JScript
Contiene vínculos a temas que explican cómo utilizar los tipos de datos primitivos, los tipos de datos de referencia y los tipos de
datos de .NET Framework en JScript.
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Introducción a ASP.NET
Presenta ASP.NET, explica cómo se puede utilizar con cualquier lenguaje compatible con .NET, incluido JScript .NET, para crear
aplicaciones Web empresariales e incluye vínculos a información de referencia.
Introducción a la biblioteca de clases de .NET Framework
Presenta la biblioteca de clases de .NET Framework, explica las convenciones de nomenclatura y los espacios de nombres del
sistema y ofrece vínculos a información de referencia.
JScript .NET
Intrinsic Objects
JScript provides 16 intrinsic objects as part of the language specification. Each intrinsic object has associated methods and
properties, which are described in detail in the language reference. Several commonly used objects are discussed in this section to
illustrate the basic syntax and use of intrinsic objects.
In This Section
JScript Array Object
Describes how to use array objects, how to take advantage of their expando properties, and how they compare to typed arrays.
JScript Date Object
Describes the range of acceptable dates and how to create an object with either the current date and time or an arbitrary date
and time.
JScript Math Object
Illustrates how to use methods and properties to manipulate numerical data.
JScript Number Object
Explains the purpose of the number object and the meaning of its properties.
JScript Object Object
Describes how to add expando properties and methods to objects and explains the difference between using the dot operator
and the index operator to access object members.
JScript String Object
Explains the purpose of the string object and how string literals can use the methods of the String object.
Related Sections
JScript Objects
Links to topics that explain the syntax and uses of the intrinsic objects in JScript.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Objects
Lists all the objects provided by the JScript language and links to language reference information that explains the proper use
and syntax for each object.
JScript .NET
When you create an array using the Array keyword, JScript includes a length property, which records the number of entries. If
you do not specify a number, the length is set to zero, and the array has no entries. If you specify a number, the length is set to
that number. If you specify more than one parameter, the parameters are used as entries in the array. In addition, the number of
parameters is assigned to the length property, as in the following example, which is equivalent to the preceding example.
Array literals provide another technique for entering data in an array. For more information, see Array Data.
The Array object stores sparse arrays. That is, if an array has three elements that are numbered 0, 1, and 2, element 50 can exist
without the presence of elements 3 through 49. JScript automatically changes the value of the length property when you add
elements to an Array object. Array indices in JScript always start at 0, not 1, so the length property is always one greater than the
largest index in the array.
Using expando properties of arrays
Array objects, just as any other object based on the JScript Object object, support expando properties. Expando properties are
new properties that you dynamically add and delete from an array, like array indices. Unlike array indices, which must be whole
numbers, expando properties are strings. In addition, adding or deleting expando properties does not change the length
property.
For example:
Typed Arrays
Another faster way to create the theMonths array shown above is to create a typed (native) array, in this case, an array of strings:
var theMonths : String[] = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "O
ct", "Nov", "Dec"];
Elements of typed arrays can be accessed faster than elements in JScript array objects. Typed arrays are compatible with arrays in
other .NET Framework languages and provide type safety.
JScript Arrays objects are very flexible and great to use for lists, queues, stacks, and so on, but native arrays are much better for
storing fixed-size items of the same type. In general, unless the special features of the Array object are needed (dynamic resizing
and so on), typed arrays should be used.
All non-destructive JScript Array methods (methods that do not change the length) can be called on typed arrays.
See Also
Intrinsic Objects | Array Object
JScript .NET
// Create two new dates, one for January first of the current year,
// and one for January first of next year. The months are numbered
// starting with zero.
var firstOfYear : Date = new Date(thisYear,0,1);
var firstOfNextYear : Date = new Date(thisYear+1,0,1);
See Also
Intrinsic Objects | Date Object
JScript .NET
One built-in method of the Math object is the exponentiation method, or pow, which raises a number to a specified power. The
following example uses both pi and exponentiation.
// This formula calculates the volume of a sphere with the given radius.
var volume = (4/3)*(Math.PI*Math.pow(radius,3));
Another
The Math object cannot be explicitly constructed; it is always available to the program.
See Also
Intrinsic Objects | Math Object
JScript .NET
You can also access an object's properties using the index operator, []. This is required if the name of the property is not a simple
identifier, or if the name of the property is not known when you write the script. An arbitrary expression, including a simple
identifier, inside square brackets can index the property. The names of all expando properties in JScript are converted to strings
before being added to the object.
When using the index operator, the object is treated as an associative array. An associative array is a data structure that
dynamically associates arbitrary data values with arbitrary strings. In this example, expando properties are added that do not have
simple identifiers.
Although the index operator is more commonly associated with accessing array elements, the index is always the property name
expressed as a string literal when used with objects.
Array objects have a special length property that changes when new elements are added; in general, objects do not have a
length property even when the index operator is used to add properties.
Notice the important difference between the two ways of accessing object properties.
Operator The property name is treated a Meaning the property name
s
Period (.) An identifier Cannot be manipulated as data
Index ([]) A string literal Can be manipulated as data
This difference becomes useful when you do not know the property names until runtime (for example, when you are constructing
objects based on user input). To extract all the properties from an associative array, you must use the for ... in loop.
See Also
Intrinsic Objects | Object Object
JScript .NET
The String object also has a length property. This property contains the number of characters in the string (0 for an empty
string). This a numeric value and can be used directly in calculations. This example obtains the length of a string literal.
var howLong : int = "Hello World".length // Sets the howLong variable to 11.
See Also
Intrinsic Objects | String Object | String Data
JScript .NET
Class-based Objects
Since JScript .NET is a class-based, object-oriented programming language, it is possible to define classes that can inherit from
other classes. Defined classes can have methods, fields, properties, and subclasses. Inheritance enables classes to build upon
existing classes and override selected base-class methods and properties. The classes in JScript .NET, which are similar to the
classes in C++ and C#, are quite different from the prototype-based objects.
In This Section
Creating Your Own Classes
Describes how to define a class with fields, methods, and constructors.
Advanced Class Creation
Describes how to define a class with properties, how to inherit from a class, and how to create a class that supports expando
properties.
Related Sections
JScript Objects
Includes links to topics that explain the syntax and uses of the intrinsic JScript objects.
JScript Modifiers
Describes the modifiers that can be used to control the visibility of class members, how classes inherit, and how classes behave.
Prototype-based Objects
Provides a guide to using the JScript prototype-based object model and links to information that describes custom constructor
functions and inheritance for prototype-based objects.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
JScript .NET
class myClass {
const answer : int = 42; // Constant field.
var distance : double; // Variable field.
}
The answer is 42
The distance is 5.2
class myClass {
const answer : int = 42; // Constant field.
var distance : double; // Variable field.
function sayHello() :String { // Method.
return "Hello";
}
}
var c : myClass = new myClass;
c.distance = 5.2;
print(c.sayHello() + ", the answer is " + c.answer);
class myClass {
const answer : int = 42; // Constant field.
var distance : double; // Variable field.
function sayHello() :String { // Method.
return "Hello";
}
// This is the constructor.
function myClass(distance : double) {
this.distance = distance;
}
}
See Also
Class-based Objects | JScript Objects | Advanced Class Creation
JScript .NET
class Person {
// The name of a person.
// It is protected so derived classes can access it.
protected var name : String;
Redefining a method in a derived class does not change the corresponding method in the base class.
Expando Objects
If you just want a generic object to be expando, use the Object constructor.
If you want one of your classes to be expando, define the class with the expando modifier. Expando members can only be
accessed using the index ([]) notation; they cannot be accessed using the dot (.) notation.
// An expando class.
expando class MyExpandoClass {
function dump() {
// print all the expando properties
for (var x : String in this)
print(x + " = " + this[x]);
}
}
// Create an instance of the object and add some expando properties.
var e : MyExpandoClass = new MyExpandoClass();
e["answer"] = 42;
e["greeting"] = "hello";
e["new year"] = new Date(2000,0,1);
print("The contents of e are...");
// Display all the expando properites.
e.dump();
See Also
Class-based Objects | JScript Objects | JScript Modifiers | Creating Your Own Classes
JScript .NET
Prototype-based Objects
Since JScript is an object-oriented programming language, it supports the definition of custom constructor functions and
inheritance. Constructor functions (also called constructors) provide the ability to design and implement your own prototype-
based objects. Inheritance allows prototype-based objects to share a common set of properties and methods that can be
dynamically added or removed.
In many cases, the class-based objects should be used instead of prototype-based objects. Class-based objects can be passed to
methods written in other .NET Framework languages. Furthermore, class-based objects provide type safety and produce efficient
code.
In This Section
Creating Your Own Objects with Constructor Functions
Explains how to use constructor functions to create objects with properties and methods.
Advanced Object Creation
Illustrates how to use inheritance to add a common set of properties and methods to objects created with a given constructor
function.
Related Sections
JScript Objects
Includes links to topics that explain the syntax and uses of the intrinsic JScript objects.
Class-based Objects
Provides a guide to using the JScript class-based object model and describes how to define classes (with methods, fields, and
properties), how to define a class that inherits from another class, and how to define expando classes.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
JScript .NET
After defining an object constructor, you create instances of the object with the new operator. Here the pasta constructor is used
to create spaghetti and linguine objects.
You can dynamically add properties to an instance of an object, but those changes only affect that one instance.
If you want to add an extra property to all instances of the object without modifying the constructor function, you can add the
property to the constructor's prototype object. For more information, see Advanced Object Creation.
Grain: wheat
Width: 0.2 cm
Shape: circle
Egg?: true
Grain: wheat
Width: 0.2 cm
Shape: circle
Egg?: true
See Also
Prototype-based Objects | JScript Objects
JScript .NET
Siguiendo este principio, se pueden definir propiedades adicionales para las funciones constructoras existentes (todas tienen
objetos prototipo). Esto sólo funciona cuando el modo rápido está desactivado. Para obtener más información, vea /fast.
Por ejemplo, si desea eliminar los espacios iniciales y finales de las cadenas (de forma similar a la función Trim de Visual Basic),
puede crear un método propio en el objeto prototipo String y todas las cadenas de la secuencia de comandos heredarán
automáticamente el método. En este ejemplo se utiliza un literal de expresión regular para quitar los espacios. Para obtener más
información, vea Regular Expression (Objeto).
Después de compilar este programa con el indicador /fast-, el resultado de este programa será:
leading and trailing spaces (35)
leading and trailing spaces (27)
Vea también
Objetos basados en prototipos | Objetos de JScript
JScript .NET
JScript Modifiers
JScript modifiers change the behavior and visibility of classes, interfaces, or members of classes or interfaces. You may use
modifiers when defining classes and interfaces, but they are usually not required.
Visibility Modifiers
Visibility modifiers restrict how outside code accesses classes, interfaces, and their members. You can use restrictions to
encourage good object-oriented programming practices by preventing calls to specialized internal methods and fields.
By default, any code that can access a class can access any of the members of that class. Using the visibility modifiers, you can
selectively prevent outside code from accessing particular class members, allow only classes from the same package to access
members, or allow only derived classes to access class members.
Visibility modifiers cannot be applied to global functions or variables. The only visibility modifiers that can be used together are
protected and internal.
Visibility Modifier Valid for Meaning
public class, class member, interface, o Member is visible to any code that has access to the class with no restriction
r interface member, enumeratio s on visibility. By default in JScript .NET, classes, interfaces, and their membe
ns rs are public.
private class member Member is visible only within the class in which it is declared. It is not visible
to derived classes. Code outside the current class cannot access private me
mbers.
protected class member Member is visible only within the class in which it is declared and to any der
ived classes of that class. The protected modifier cannot be used for classes
at package scope, but it can be used for nested classes.
internal class, class member, enumerati Class, class member, or enumeration is visible everywhere within the packa
on ge in which it is declared. It is not visible outside the package.
Inheritance Modifiers
Inheritance modifiers control how methods and properties from derived classes override methods and properties in a base class.
By using this control, you can manage whether methods from derived classes will override a class you create.
By default, methods from a derived class will override base class methods unless the version-safe hide attribute is used in the
derived class. This attribute prevents overriding. Using inheritance modifiers enables you to control whether particular methods
are overridden always or never.
In some situations, you may need to ensure that a base class method is not overridden. For example, if you define a class in a
package, you can use the final modifier to ensure that derived classes will not change the methods and properties of the class.
On the other hand, you may want to require your class to have certain methods overridden. For example, you can create a class
that provides some basic functionality but use the abstract modifier for some methods. The implementations of the abstract
methods are up to the writer of the derived class.
Version-safe modifiers, which also manage overriding, manage it from the derived-class side rather than the base-class side.
Version-safe modifiers have an effect only if the base-class method they are overriding does not have inheritance modifiers.
You cannot combine two inheritance modifiers or combine an inheritance modifier with the static modifier.
Inheritance Modif Valid for Meaning
ier
abstract Class, method, or property For methods or properties, this modifier indicates that the member does no
t have an implementation. For classes, this modifier indicates that there are
one or more unimplemented methods. An abstract class or a class that cont
ains an abstract member cannot be instantiated using the new keyword, bu
t it can be used as a base class.
final Class, method, or property For classes that cannot be extended or methods that cannot be overridden.
Using final prevents derived classes from changing the behavior of the clas
s by overriding important functions. Methods with the final modifier can be
hidden or overloaded, but not overridden.
Version-Safe Modifiers
Version-safe modifiers control the methods from a derived class that override methods in a base class. By using this control, you
can manage whether a class you create will override methods in the base class.
By default, methods from a derived class will override methods in a base class, although inheritance modifiers in the definition of
the derived class can prevent overriding as well. Using version-safe modifiers enables you to control whether particular methods
are overridden or not.
In some situations, you may need to ensure that base-class methods are not overridden. For example, you may extend a class to
change the behavior of the base-class methods. If you do not want those methods to be overridden in the base class, you can use
the hide modifier for your method declarations.
On the other hand, you may want to override certain base-class methods. For example, you may want to change the methods of a
class without modifying the class. By extending the class and using the override modifier for your method declarations, you can
cause the new methods to override the base class.
Successful use of version-safe modifiers depends on whether or not the declaration of the base class methods used inheritance
modifiers. Base-class methods marked with the final modifier cannot be overridden, and base-class methods marked with the
abstract modifier cannot be hidden unless an explicit implementation for the abstract base-class method is given.
You cannot combine two version-safe modifiers or combine a version-safe modifier with the static modifier. When running in
version-safe mode, only one version-safe modifier may be used for each method that overrides a base-class method.
Version-Safe Modi Valid for Meaning
fier
hide Method or property Member does not override a member with the same name in the base class.
override Method or property By default, members override members with the same name in the base cla
ss.
expando Modifier
The expando modifier causes a class-based object to behave as if it were a JScript object. Methods and properties can be
dynamically added to an expando object. For more information, see Prototype-based Objects.
You can use the expando modifier independently of the other modifiers.
Modifier Valid for Meaning
expando Class or method For a class, the class is given a default, indexed property that is capable of st
oring and retrieving dynamic properties (expandos). For a method, indicates
that it is a constructor for an expando object.
static Modifier
The static modifier signifies that a member of a class belongs to the class itself rather than to instances of the class.
Consequently, class-specific data and methods may not be associated with any particular instance.
You cannot combine the static modifier with any of the version-safe or inheritance modifiers.
Modifier Valid for Meaning
static Method, property, field, or class For methods, indicates that it can be called without an instance of the class.
For properties and fields, designates that one copy is shared by all instances
. The static modifier should not be confused with the static statement, whic
h denotes code that initializes the class.
See Also
Modifiers | class Statement | interface Statement | function Statement | function get Statement | function set Statement |
var Statement | const Statement | static Statement
JScript .NET
Operadores de JScript
JScript tiene un amplio conjunto de operadores, entre los que se incluyen operadores de cálculo, lógicos, bit a bit y de asignación,
así como algunos operadores variados. Los operadores combinan expresiones simples para formar expresiones más complejas.
En esta sección
Resumen de operadores
Incluye tablas con los operadores de JScript agrupados por tipo.
Precedencia de operadores
Proporciona una tabla que contiene los operadores y su prioridad y un ejemplo de cómo funciona la prioridad de los
operadores.
Conversión realizada por operadores bit a bit
Describe las reglas que rigen la conversión de operandos de operadores bit a bit. La conversión es necesaria para que los
formatos binarios de los operandos sean compatibles entre sí y con el operador bit a bit.
Secciones relacionadas
Asignaciones e igualdad en JScript
Explica cómo utilizar los operadores de asignación, igualdad e igualdad estricta.
La conversión en JScript
Explica el concepto de conversión, cómo se utiliza y sus limitaciones.
Operadores
Incluye vínculos a temas de referencia sobre los operadores de JScript.
JScript .NET
Resumen de operadores
Las tablas que aparecen a continuación muestran los operadores de JScript. Cada uno de los nombres de la columna de
descripción ofrece un vínculo al tema correspondiente, que explica la sintaxis y el uso correctos.
Operadores de cálculo
Descripción Símbolo
Suma +
Decremento --
División /
Incremento ++
Módulo aritmético %
Multiplicación *
Resta -
Negación unaria -
Todos los operadores computacionales realizan cálculos con datos numéricos. Los operadores de suma también concatenan
cadenas cuando uno de los operandos es una cadena.
Operadores lógicos
Descripción Símbolo
Igualdad ==
Mayor o igual que >=
Mayor que >
Identidad ===
In in
Desigualdad !=
Menor o igual que <=
Menor que <
AND lógico &&
NOT lógico !
OR lógico ||
No identidad !==
Un operador lógico devuelve un valor Boolean. Dependiendo del operador, el valor puede representar el resultado de la
comparación, de la prueba o de la combinación.
Operadores bit a bit
Descripción Símbolo
AND bit a bit &
Desplazamiento a la izquierda bit a bit <<
NOT bit a bit ~
OR bit a bit |
Desplazamiento a la derecha bit a bit >>
XOR bit a bit ^
Desplazamiento a la derecha sin signo >>>
Los operadores bit a bit operan en la representación binaria de los operandos. Si los operandos no son compatibles entre sí, se
convertirán al tipo adecuado. Para obtener más información, vea Conversión realizada por operadores bit a bit.
Operadores de asignación
Descripción Símbolo
Asignación =
Asignación de adición compuesta +=
Asignación AND bit a bit compuesta &=
Asignación Or bit a bit compuesta |=
Asignación XOR bit a bit compuesta ^=
Asignación de división compuesta /=
Asignación de desplazamiento a la izquierda compuesta <<=
Asignación de módulo compuesta %=
Asignación de multiplicación compuesta *=
Asignación de desplazamiento a la derecha compuesta >>=
Asignación de resta compuesta -=
Asignación de desplazamiento a la derecha sin signo compuesta >>>=
Todos los operadores de asignación devuelven el valor asignado al operando izquierdo.
Operadores varios
Descripción Símbolo
Coma ,
Operador ternario condicional ?:
Delete delete
Instanceof instanceof
New new
Typeof typeof
Void void
Vea también
Operadores de JScript | Precedencia de operadores
JScript .NET
Operator Precedence
Operator precedence is a set of rules in JScript that controls the order in which the compiler performs operations when evaluating
an expression. Operations with a higher precedence are performed before those with a lower one. For example, multiplication is
performed before addition.
The following table lists the JScript operators, ordered from highest to lowest precedence.
Precedence Evaluation Order Operator Description
15 left to right ., [], () Field access, array indexing, function calls, and exp
ression grouping
14 right to left ++, --, -, ~, !, delete, new, type Unary operators, return data type, object creation,
of, void undefined values
13 left to right *, /, % Multiplication, division, modulo division
12 left to right +, - Addition and string concatenation, subtraction
11 left to right <<, >>, >>> Bit shifting
10 left to right <, <=, >, >=, instanceof Less than, less than or equal, greater than, greater
than or equal, instanceof
9 left to right ==, !=, ===, !== Equality, inequality, strict equality, and strict inequ
ality
8 left to right & Bitwise AND
7 left to right ^ Bitwise XOR
6 left to right | Bitwise OR
5 left to right && Logical AND
4 left to right || Logical OR
3 right to left ?: Conditional
2 right to left =, OP= Assignment, compound assignment
1 left to right , (comma) Multiple evaluation
Parentheses in an expression alter the order of evaluation determined by operator precedence. This means an expression within
parentheses is fully evaluated before its value is used in the remainder of the expression.
For example:
z = 78 * (96 - 3 + 45)
There are five operators in the preceding expression: =, *, (), -, and +. According to the rules of operator precedence, they are
evaluated in the following order: (), -, +, *, =.
1. 5Evaluation of the expression within the parentheses occurs first. Within the parentheses, there is an addition operator and
a subtraction operator. The operators both have the same precedence, and they are evaluated from left to right. The number
3 is subtracted from 96 first, resulting in 93. Then the number 45 is added to 93, resulting in a value of 139.
2. Multiplication occurs next. The number 78 is multiplied by the number 139, resulting in a value of 10764.
3. Assignment occurs last. The number 10764 is assigned to z.
See Also
JScript Operators | Operator Summary
JScript .NET
Funciones de JScript
Las funciones de JScript pueden realizar acciones, devolver valores o ambas cosas. Por ejemplo, una función podría mostrar la
hora actual y devolver una cadena que represente la hora. Las funciones también se denominan métodos globales.
Las funciones combinan varias operaciones bajo un único nombre, con lo que se optimiza el código y se permite su reutilización.
Puede escribir un conjunto de instrucciones, asignarle un nombre y, a continuación, ejecutarlo llamándolo por su nombre y
pasándole la información necesaria.
Para pasar información a una función, la información debe incluirse entre paréntesis detrás del nombre de la función. Los
elementos de información que se pasan a una función se denominan argumentos o parámetros. Algunas funciones no aceptan
argumentos, mientras que otras utilizan uno o varios. En algunas funciones, el número de argumentos depende de cómo se
utilice la función.
JScript admite dos tipos de funciones: las que están integradas en el lenguaje y las creadas por el propio usuario.
En esta sección
Anotaciones de tipo
Describe el concepto de anotación de tipo y de cómo utilizarlo en una definición de función para controlar los tipos de datos de
entrada y salida.
Funciones de JScript definidas por el usuario
Muestra cómo definir nuevas funciones en JScript y cómo utilizarlas.
Recursividad
Explica el concepto de recursividad y muestra cómo escribir funciones recursivas.
Secciones relacionadas
Operadores de JScript
Enumera los operadores de cálculo, lógicos, bit a bit y de asignación, así como operadores varios, y proporciona vínculos a la
información que explica cómo utilizarlos de forma eficaz.
Tipos de datos de JScript
Contiene vínculos a temas que explican cómo utilizar los tipos de datos primitivos, los tipos de datos de referencia y los tipos de
datos de .NET Framework en JScript.
La conversión en JScript
Explica el concepto de conversión, cómo se utiliza y sus limitaciones.
function (Instrucción)
Describe la sintaxis para declarar funciones.
JScript .NET
Type Annotation
Type annotation in a function specifies a required type for function arguments, a required type for returned data, or a required
type for both. If you do not type annotate the parameters of a function, the parameters will be of type Object. Likewise, if the
return type for a function is not specified, the compiler will infer the appropriate return type.
Using type annotation for function parameters helps ensure that a function will only accept data that it can process. Declaring a
return type explicitly for a function improves code readability since the type of data that the function will return is immediately
clear.
The following example illustrates the use of type annotations for both the parameters and return type of the function.
42nd
1st
A type mismatch error would be generated if an argument were passed to the Ordinal function that could not be coerced to an
integer. For example, Ordinal(3.14159) would fail.
See Also
JScript Functions | function Statement | Data Types
JScript .NET
Notice the use of a very small number (epsilon) as a testing variable in the floating-point version of the test. Because of
uncertainties and round-off errors in floating-point calculations, it is not practical to make a direct test of whether the three
numbers constitute a Pythagorean triplet unless all three values in question are known to be integers. Because a direct test is
more accurate, the code in this example determines whether it is appropriate and, if it is, uses it.
Type annotation is not used when defining these functions. For this application, it is useful for the checkTriplet function to take
both integer and floating-point data types.
// Test the function with several triplets and print the results.
// Call with a Pythagorean triplet of integers.
print(checkTriplet(3,4,5));
// Call with a Pythagorean triplet of floating-point numbers.
print(checkTriplet(5.0,Math.sqrt(50.0),5.0));
// Call with three integers that do not form a Pythagorean triplet.
print(checkTriplet(5,5,5));
true
true
false
See Also
JScript Functions | JScript Data Types | function Statement
JScript .NET
Recursion
Recursion is an important programming technique that causes a function to call itself. One example is the calculation of factorials.
The factorial of 0 is defined specifically to be 1. The factorial of n, an integer greater than 0, is the product of all the integers in the
range from 1 to n.
The following paragraph is a function, defined in words, that calculates a factorial.
"If the number is less than zero, reject it. If it is not an integer, reject it. If the number is zero, its factorial is one. If the
number is larger than zero, multiply it by the factorial of the next lesser number."
To calculate the factorial of any number that is larger than zero, you must calculate the factorial of at least one other number. The
function must call itself for the next smaller number before it can execute on the current number. This is an example of recursion.
Recursion and iteration (looping) are strongly related — a function can return the same results either with recursion or iteration.
Usually a particular computation will lend itself to one technique or the other, and you simply choose the most natural or
preferable approach.
Despite the usefulness of recursion, you can easily create a recursive function that never returns a result and cannot reach an
endpoint. Such a recursion causes the computer to execute an infinite loop. Here is an example: omit the first rule (the one about
negative numbers) from the verbal description of calculating a factorial, and try to calculate the factorial of any negative number.
This fails because to calculate the factorial of, for example, -24, you must calculate the factorial of -25. In order to calculate the
factorial of -25, you must first calculate the factorial of -26, and so on. Obviously, this never reaches a conclusion.
Another problem that can occur with recursion is a recursive function can use all the available resources (such as system memory,
stack space, and so on). Each time a recursive function calls itself (or calls another function that calls the original function), it uses
some resources. These resources are freed when the recursive function exits, but a function that has too many levels of recursion
may use all the available resources. When this happens, an exception is thrown.
Thus, it is important to design recursive functions with care. If you suspect any chance of an excessive (or infinite) recursion,
design the function to count the number of times it calls itself and set a limit on the number of calls. If the function calls itself
more times than the threshold, the function can quit automatically. The optimum maximum number of iterations depends on the
recursive function.
Here is the factorial function again, this time written in JScript code. Type annotation is used so the function accepts only integers.
If an invalid number is passed in (that is, a number less than zero), the throw statement generates an error. Otherwise, a recursive
function is used to calculate the factorial. The recursive function takes two arguments, one for the factorial argument and one for
the counter that keeps track of the current recursion level. If the counter does not reach the maximum recursion level, the factorial
of the original number is returned.
120
7.156945704626378e+118
See Also
JScript Functions | Type Annotation
JScript .NET
La conversión en JScript
JScript puede realizar operaciones en valores de tipos diferentes sin que el compilador inicie una excepción. El compilador de
JScript cambia (convierte) automáticamente uno de los tipos de datos al otro y realiza después la operación. Otros lenguajes
tienen reglas mucho más estrictas que rigen la conversión.
El compilador permite todo tipo de conversiones a menos que compruebe que la conversión siempre producirá un error. Las
conversiones que pueden producir errores generan una advertencia en tiempo de compilación, y muchas de ellas producen un
error en tiempo de ejecución. Por ejemplo:
Operación Resultado
Sumar un número y una cadena El número se convierte en cadena
Sumar un tipo booleano y una cadena El tipo booleano se convierte en cadena
Sumar un número y un tipo booleano El tipo booleano se convierte en número
Considere el ejemplo siguiente.
Para convertir de forma explícita una cadena en un entero, utilice el método parseInt. Para obtener más información, vea el
método parseInt. Para convertir de forma explícita una cadena en un número, utilice el método parseFloat. Para obtener más
información, vea el método parseFloat. Tenga en cuenta que las cadenas se convierten automáticamente en números
equivalentes al realizar una comparación, pero no se modifican durante una suma (o concatenación).
Dado que JScript .NET es un lenguaje con establecimiento inflexible de tipos, existe otro mecanismo de conversión. El nuevo
mecanismo utiliza, para realizar la conversión, el nombre de tipo de destino como si se tratara de una función, como lo haría con
un argumento. Este mecanismo funciona para todos los tipos primitivos de JScript, los tipos de referencia de JScript y los tipos de
.NET Framework.
Por ejemplo, en el siguiente código, se convierte un valor entero en un tipo Boolean:
class myClass {
var i : int = 42;
}
class yourClass {
var s : String = "Hello";
var f : float = 3.142;
var d : Date = new Date();
}
// Define a variable of each user-defined type.
var mine : myClass = new myClass();
var yours : yourClass;
// This fails because there is no obvious way to convert
// from myClass to yourClass
yours = yourClass(mine);
Vea también
Funciones de JScript | Conversión de tipos | Conversión realizada por operadores bit a bit
JScript .NET
Conditional Statements
Instructions in JScript code execute sequentially by default. It might be useful, however, to alter the logical sequence and transfer
control to a non-sequential part of the code depending on specific conditions. A control structure transfers program control to
one of two places depending on whether a conditional statement tests true or false. Any expression coercible to a Boolean value
can be used as a conditional statement. Some common condition statements are mentioned here.
Equality and Strict Equality
The equality operator (==) in a condition statement checks whether the two arguments passed to it have the same value,
performing type conversion if necessary to make a comparison. The strict equality operator (===) compares both the value and
type of two expressions; true is returned only if the value and data type are the same for the two operands. Note that the strict
equality operator does not distinguish between the different numeric data types.
The following JScript code combines an equality operator with an if statement that uses it. For more information, see
Control Structures.
var counter = 1;
// Loop over the print statement while counter is not equal to 5.
while (counter != 5) {
print(counter++);
}
Comparison
The equality and inequality operators are useful if a piece of data has a particular value. However, in some situations code may
need to check if a value is within a particular range. The relational operators, less than (<), greater than (>), less than or equal to
(<=), and greater than or equal to (>=), are appropriate for these cases.
if(tempInCelsius < 0)
print("Water is frozen.")
else if(tempInCelsius > 100)
print("Water is vapor.");
else
print("Water is liquid.);
Short-Circuit
If you want to test several conditions together and you know that one is more likely to pass or fail than the others, you can use a
feature called short circuit evaluation to speed the execution of your script and avoid side effects that might cause errors. When
JScript evaluates a logical expression, it only evaluates as many sub-expressions as required to get a result.
The logical AND (&&) operator evaluates the left expression passed to it first. If that expression converts to false, then the result
of the logical AND operator cannot be true regardless of the value of the right expression. Therefore, the right expression is not
evaluated.
For example, in the expression ((x == 123) && (y == 42)), JScript first checks if x is 123. If it is not, the test for y is never made,
and JScript returns the value false.
Similarly, the logical OR operator (||) evaluates the left expression first and if it converts to true, the right expression is not
evaluated.
Short-circuiting is useful when the conditions to be tested involve the execution of function calls or other complex expressions. To
make a script run most efficiently, place the conditions most likely to be true first for the logical OR operator. For the logical AND
operator, place the conditions most likely to be false first.
An example of the a benefit of designing your script in this manner is that runsecond() will not be executed in the following
example if the return value of runfirst() converts to false.
Another example of the a benefit of designing your script in this manner is that runsecond() will not be executed in the following
example if the return value of runfirst() converts to false.
Other
Any expression that can be converted to a Boolean value can be used as a condition statement. For example, you could use an
expression such as:
Note that the above code does not check if x is equal to y + z, since the syntax uses only a single equal sign (assignment). Instead,
the code above assigns the value of y + z to the variable x, and then checks if the result of the entire expression (the value of x)
can be converted to the value true. To check if x is equal to y + z, use the following code.
if (x == y + z) // This is different from the code above!
See Also
JScript Conditional Structures | JScript Data Types | JScript Reference | Boolean Data | Operators
JScript .NET
Control Structures
For all control structures except the switch statement, transfer of program control is based upon a decision, the result of which is
a truth statement (returning a Boolean true or false). You create an expression and then test whether its result is true. There are
two main kinds of program control structures.
See Also
JScript Conditional Structures | JScript Reference
JScript .NET
if (newUser)
registerUser();
In this example, the test fails unless both conditions are true.
In this example, the code in the body of the do...while loop is executed until the variable quit is true.
var quit;
do {
// ...
quit = getResponse()
}
while (!quit)
See Also
JScript Conditional Structures | JScript Reference | if...else Statement
JScript .NET
Conditional Operator
JScript supports an implicit conditional form, the conditional operator. It takes three operands. A question mark separates the first
two operands, and a colon separates the second and third operands. The first operand is a conditional expression. The second
operand is a statement that is executed if the conditional expression evaluates to true. The third operand is executed if the
conditional is false. For more information, see Conditional (Ternary) Operator (?:). The conditional operator is similar to the
if...else statement.
In this example, the conditional operator determines if an hour in 24-hour time is before noon ("AM") or after noon ("PM").
var hours : String = (the24Hour >= 12) ? " PM" : " AM";
In general, an if ... then ... else structure is appropriate when choosing between statements to be executed, whereas the
conditional operator (?:) is appropriate when choosing between two expressions. Do not try to use the conditional operator to
choose between more than two alternatives or to execute blocks of statements. In those cases, use the if...then...else construct.
See Also
JScript Conditional Structures | JScript Reference
JScript .NET
Loops in JScript
JScript includes several ways to execute a statement or block of statements repeatedly. In general, repetitive execution is called
looping or iteration. An iteration is simply a single execution of a loop. It is typically controlled by a test of a variable, where the
value is changed each time the loop is executed. JScript supports four types of loops: for loops, for...in loops, while loops, and
do...while loops.
In This Section
for Loops
Discusses how JScript uses for loops and provides some practical examples.
for...in Loops
Describes the concept of for...in loops and explains how to use them in JScript.
while Loops
Discusses the two types of while loops and explains how they differs from for loops.
break and continue Statements
Describes how to use the break and continue statements to override the behavior of a loop.
Related Sections
JScript Conditional Structures
Describes how JScript normally handles program flow and provides links to information that explains how to regulate the flow
of a program's execution.
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
JScript .NET
Bucles for
La instrucción for especifica una variable de contador, una condición de prueba y una acción que actualiza el contador. La
condición se comprueba antes de cada iteración del bucle. Si la comprobación es correcta, se ejecuta el código interior del bucle.
En caso contrario, el código interior del bucle no se ejecuta y el programa continúa por la primera línea de código
inmediatamente posterior al bucle. Después de ejecutar el bucle, la variable de contador se actualiza antes de comenzar la
siguiente iteración.
Si nunca se cumple la condición del bucle, éste nunca se ejecuta. Si la condición del bucle se cumple siempre, el bucle se convierte
en un proceso infinito. Aunque es posible que lo primero sea necesario en algunos casos, lo segundo raramente lo es, por lo que
debe tener cuidado al escribir las condiciones de los bucles. En este ejemplo, se utiliza el bucle for para inicializar los elementos
de una matriz con la suma de los elementos anteriores.
0: 0
1: 1
2: 3
3: 6
4: 10
5: 15
6: 21
7: 28
8: 36
9: 45
En el siguiente ejemplo hay dos bucles. El bloque de código del primer bloque no se ejecuta nunca, mientras que el segundo bucle
es un bucle infinito.
var iCount;
var sum = 0;
for(iCount = 0; iCount > 10; iCount++) {
// The code in this block is never executed, since iCount is
// initially less than 10, but the condition checks if iCount
// is greater than 10.
sum += iCount;
}
// This is an infinite loop, since iCount is always greater than 0.
for(iCount = 0; iCount >= 0; iCount++) {
sum += iCount;
}
Vea también
Bucles en JScript | Estructuras condicionales de JScript | Referencia de JScript | for (Instrucción)
JScript .NET
for...in Loops
JScript provides a special kind of loop for looping through all the user-defined properties of an object, all the elements of an
array, or all the elements of a collection. The loop counter in a for...in loop is a string or object rather than a number. It contains
the name of the current property, the index of the current array element, or the current element in the collection.
The following code illustrates the use of the for...in construct.
Note that the new behavior of the for...in loop construct in JScript .NET eliminates the need to use the Enumerator object to
iterate elements of a collection.
See Also
Bucles while
Un bucle while es similar a un bucle for en que permite ejecutar varias veces un bloque de instrucciones. Sin embargo, los bucles
while no tienen integrada una variable de contador ni una expresión de actualización. Para controlar la ejecución repetitiva de
una instrucción o bloque de instrucciones con una regla más compleja que "ejecutar este código n veces", use un bucle while. En
el siguiente ejemplo se muestra la instrucción while:
var x = 1;
while (x < 100) {
print(x);
x *= 2;
}
1
2
4
8
16
32
64
Nota Debido a que los bucles while no tienen variables de contador explícitas integradas, tienen más posibilidades
de crear bucles infinitos que otros tipos de bucles. Además, debido a que no es fácil descubrir dónde y cuándo se
actualiza la condición del bucle, hay muchas posibilidades de escribir accidentalmente un bucle while en el que la
condición nunca se actualice. Por este motivo, debe tener precaución al diseñar bucles while.
Como se indicó anteriormente, existe un bucle do...while en JScript que es similar al bucle while. Los bucles do...while ofrecen
la garantía de que se ejecutarán siempre al menos una vez, ya que la condición se prueba al final del bucle y no al principio. Por
ejemplo, el bucle anterior puede volverse a escribir de la siguiente manera:
var x = 1;
do {
print(x);
x *= 2;
}
while (x < 100)
i = 0
i = 1
i = 2
i = 3
i = 4
i = 5
i = 6
i = 7
i is greater than 7.
See Also
Loops in JScript | JScript Conditional Structures | JScript Reference | break Statement | continue Statement
JScript .NET
The engine which hosts JScript .NET allows any called code to modify parts of the engine, such as global variables, local variables,
and prototype chains of any object. In addition, any function can modify the expando properties or methods of any expando
object passed to it. Consequently, if a JScript .NET application calls partially trusted code or if it is running in an application with
other code (such as from within a Visual Studio for Applications [VSA] host), the behavior of the application could be modified.
A consequence of this is that any JScript code in an application (or in an instance of an AppDomain class) should run at a trust
level no higher than the rest of the code in the application. Otherwise, the other code could manipulate the engine for the JScript
class, which could in turn modify data and affect the other code in the application. For more information, see AppDomain Class.
Assembly Access
JScript can reference assemblies using both strong names and simple text names. A strong name reference includes the version
information of the assembly as well as a cryptographic signature that confirms the integrity and identity of the assembly.
Although it is easier to use a simple name when referring to an assembly, a strong name protects your code in case another
assembly on your system has the same simple name but different functionality. For more information, see
Referencing a Strong-Named Assembly.
Threading
The JScript runtime is not designed to be thread-safe. Consequently, multithreaded JScript code may have unpredictable
behavior. If you develop an assembly in JScript .NET, keep in mind that it may be used in a multithreaded context. You should use
classes from the System.Threading namespace, such as the Mutex class, to ensure that the JScript .NET code in the assembly
runs with the proper synchronization.
Because proper synchronization code is difficult to write in any language, you should not attempt to write general-purpose
assemblies in JScript unless you have a good understanding of how to implement the necessary synchronization code. For more
information, see System.Threading Namespace.
Note You do not need to write synchronization code for ASP.NET applications written in JScript .NET because
ASP.NET manages the synchronization of all the threads it spawns. However, Web controls written in JScript must
contain synchronization code because they behave like assemblies.
Runtime Errors
Because JScript .NET is a loosely typed language, it is more tolerant of potential type-mismatches than some other languages,
such as Visual Basic .NET and C#. Because type mismatches can cause run-time errors in applications, it is important to discover
potential type-mismatches as you develop the code. You can use the /warnaserror flag with the command-line compiler or the
warninglevel attribute of the @ Page directive in ASP.NET pages. For more information, see /warnaserror and @ Page.
Compatibility Mode
Assemblies complied in compatibility mode (with the /fast- option) are less secure than those compiled in fast mode (the default
mode). The /fast- option enables language features that are not available by default, but are required for compatibility with
scripts written for JScript version 5.6 and earlier. For example, expando properties can be dynamically added to intrinsic objects,
such as the String object, in compatibility mode.
Compatibility mode is provided to help developers build standalone executables from legacy JScript code. When developing new
executables or libraries, use default mode. Not only does this help secure applications, but it also ensures better performance and
better interaction with other assemblies. For more information, see /fast.
See Also
Tipos de datos
Un tipo de datos especifica el tipo de valor que puede aceptar una variable, una constante o una función. Las anotaciones de tipo
de las variables, constantes y funciones ayudan a reducir los errores de programación limitando los tipos apropiados a los datos.
Asimismo, las anotaciones de tipo también generan código más rápido y más eficiente.
En esta sección
boolean (Tipo de datos)
byte (Tipo de datos)
char (Tipo de datos)
decimal (Tipo de datos)
double (Tipo de datos)
float (Tipo de datos)
int (Tipo de datos)
long (Tipo de datos)
Number (Tipo de datos)
sbyte (Tipo de datos)
short (Tipo de datos)
String (Tipo de datos)
uint (Tipo de datos)
ulong (Tipo de datos)
ushort (Tipo de datos)
Secciones relacionadas
Comentarios
Las propiedades y métodos del tipo de datos boolean son iguales que los de System.Boolean.
JScript define también un objeto Boolean. El tipo de datos boolean interactúa con el objeto Boolean. Por tanto, un objeto
Boolean puede llamar a los métodos y propiedades del tipo de datos boolean, y un tipo de datos boolean puede llamar a los
métodos y propiedades del objeto Boolean. Para obtener más información, vea Boolean (Propiedades y métodos del objeto).
Más aún, los objetos Boolean son aceptados por funciones que toman tipos de datos boolean y viceversa.
Se debe utilizar el tipo de datos boolean en lugar del objeto Boolean en la mayoría de las circunstancias.
Propiedades y métodos
boolean (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | Boolean (Objeto) | Boolean (Estructura) | true (Literal) | false (Literal)
JScript .NET
Propiedades y métodos
Decimal (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | Decimal (Estructura)
JScript .NET
Comentarios
Las propiedades y métodos del tipo de datos double son iguales que los de System.Double.
JScript define un objeto Number. El tipo de datos double interactúa con el objeto Number. Por tanto, un objeto Number puede
llamar a los métodos y propiedades del tipo de datos double , y un tipo de datos double puede llamar a los métodos y
propiedades del objeto Number. Para obtener más información, vea Number (Propiedades y métodos del objeto). Más aún, los
objetos Number son aceptados por funciones que toman tipos de datos double y viceversa.
Se debe utilizar el tipo de datos double en lugar del objeto Number en la mayoría de las circunstancias.
Propiedades y métodos
Double (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | Number (Tipo de datos) | decimal (Tipo de datos) | Double (Estructura)
JScript .NET
Int64 (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | Int64 (Estructura)
JScript .NET
Remarks
The properties and methods of the Number data type are the same as the System.Double properties and methods.
JScript also defines a Number object. The Number data type interoperates with Number object. Consequently, a Number
object can call the methods and properties of the Number data type, and a Number data type can call the methods and
properties of the Number object. For additional information, see Number Object Properties and Methods. Furthermore, Number
objects are accepted by functions that take Number data types, and vice versa.
The Number data type should be used instead of the Number object in most circumstances.
Properties and Methods
Double Members
Requirements
Version .NET
See Also
Data Types | Data Type Summary | double Data Type | decimal Data Type | Number Object | Double Structure
JScript .NET
Comentarios
Las propiedades y métodos del tipo de datos String son iguales que los de System.String.
JScript define también un objeto String, que proporciona propiedades y métodos diferentes del tipo de datos String. No puede
crear propiedades ni agregar métodos a variables del tipo de datos String, pero sí puede hacerlo para las instancias del objeto
String.
El objeto String interactúa con los datos String. Por tanto, un objeto String puede llamar a los métodos y propiedades del tipo
de datos String, y un tipo de datos String puede llamar a los métodos y propiedades del objeto String. Para obtener más
información, vea String (Propiedades y métodos del objeto). Más aún, los objetos String son aceptados por funciones que toman
tipos de datos String y viceversa.
Se pueden utilizar secuencias de escape en literales de cadena para representar caracteres especiales que no se pueden utilizar
directamente en una cadena, como el carácter de nueva línea o los caracteres Unicode. Cuando se compila una secuencia de
comandos, cada secuencia de escape de un literal de cadena se convierte en los caracteres que representa. Para obtener más
información, vea Datos de cadena.
JScript no interpreta secuencias Unicode especiales (como los pares suplentes) ni tampoco normaliza cadenas cuando las
compara.
Nota Los pares de caracteres Unicode que representan un único carácter y sólo tienen significado cuando se
combinan se conocen como pares suplentes.
Algunos caracteres se pueden representar con más de una secuencia de caracteres Unicode. Las secuencias normalizadas por
separado se interpretan de manera idéntica si representan el mismo carácter.
Propiedades y métodos
String (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | String (Objeto) | String (Clase) | char (Tipo de datos) | Datos de cadena
JScript .NET
UInt64 (Miembros)
Requisitos
Versión .NET
Vea también
Tipos de datos | Resumen de tipos de datos | UInt64 (Estructura)
JScript .NET
Directivas
Las directivas de JScript controlan las opciones específicas del compilador, del depurador y de los mensajes de error.
En esta sección
@debug (Directiva)
Activa o desactiva la emisión de símbolos de depuración.
@position (Directiva)
Proporciona información de posición útil en los mensajes de error.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Referencia de .NET Framework
Muestra vínculos a temas que explican la sintaxis y estructura de la biblioteca de clases de .NET Framework y otros elementos
esenciales.
JScript .NET
@debug Directive
Turns the emission of debug symbols on or off.
Arguments
on
Default. Keyword that turns debug on.
off
Optional. Keyword that turns debug off.
Remarks
Program code that a JScript author writes sometimes differs from the actual code being compiled and run. Host environments,
such as ASP.NET, or development tools may generate their own code and add it into the program. This code is generally of no
interest to the author during debugging. Consequently, when debugging their code, code authors generally only want to see the
parts of the program that they wrote without the parts generated by their development tools. Package authors may want to turn
off debugging for similar reasons.
The compiler emits debugging symbols only when compiling from the command line with the /debug option or when compiling
an ASP.NET page with the debug flag set in the @page directive. In those circumstances, the debug directive is on by default.
When the debug directive appears, it remains in effect until the end of the file is encountered or until the next debug directive is
found.
When the debug directive is off, the compiler does not emit debugging information for local variables (variables defined within
functions or methods). However, the debug directive does not prevent emission of the debugging information for global
variables.
Example
The following code emits debug symbols for the local variable debugOnVar, but not for debugOffVar, when compiled from the
command line with the /debug option:
function debugDemo() {
// Turn debugging information off for debugOffVar.
@set @debug(off)
var debugOffVar = 42;
// Turn debugging information on.
@set @debug(on)
Requirements
Version .NET
See Also
@set Statement | @position Directive | /debug | debugger Statement | Writing, Compiling, and Debugging JScript Code
JScript .NET
@position Directive
Provides meaningful position information in error messages.
Arguments
fname
Required if file is used. A string literal that represents a filename, with or without drive or path information.
lnum
Required if line is used. Any non-negative integer that represents a line of authored code.
cnum
Required if column is used. Any non-negative integer that represents a column in authored code.
Remarks
Program code that a JScript author writes sometimes differs from the actual code being compiled and run. Host environments,
such as ASP.NET, or development tools may generate their own code and add it into the program. This code is generally of no
interest to the author, but it has the potential to cause confusion for the author when errors occur.
Instead of correctly identifying the line of the author's code where an error occurred, the compiler may incorrectly identify an
error line that doesn't even exist in the original authored code. This is because the additional generated code has changed the
relative position of the author's original code.
Example
In the following example, the line number in a file is changed to accommodate code inserted into the author's code by a JScript
host. The line numbers in the left column represent the original source as seen by the user.
Requirements
Version .NET
See Also
@set Statement | @debug Directive
JScript .NET
Errors
Error messages help you troubleshoot unexpected results or behaviors in scripts. The following sections explain how to resolve
errors that occur during runtime or as the result of syntax inconsistencies.
In This Section
JScript Run-time Errors
JScript Syntax Errors
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Error Messages
Provides a list of links to error messages that pertain to the Visual Studio Integrated Development Environment (IDE) and other
development languages.
JScript .NET
See Also
JScript Syntax Errors | Error Object | try...catch...finally Statement | throw Statement
JScript .NET
See Also
this Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
Function Object | prototype Property | Objects
JScript .NET
Alternatively, you can assign the function itself (and not its return value) to a variable.
myFunction = new Function("return 42;");
See Also
Function Object | JScript Language Features | JScript Functions | Methods
JScript .NET
See Also
See Also
See Also
See Also
See Also
JScript Variables and Constants | Scope of Variables and Constants | var Statement | with Statement | JScript Reference
JScript .NET
See Also
See Also
VBArray Object | Using Arrays
JScript .NET
See Also
Enumerator Object | atEnd Method | item Method | moveFirst Method | moveNext Method | prototype Property | Objects
JScript .NET
See Also
Regular Expression Object | Regular Expression Syntax | toString Method | valueOf Method | prototype Property | Objects
JScript .NET
See Also
Regular Expression Object | Regular Expression Syntax | compile Method
JScript .NET
Vea también
Error (Objeto) | throw (Instrucción) | try...catch...finally (Instrucción)
JScript .NET
See Also
Function Object | prototype Property | Objects
JScript .NET
<Scheme>:<first>/<second>;<third>?<fourth>
The names in angle brackets represent components, and the ":", "/", ";" and "?" are reserved characters used as separators.
See Also
encodeURI Method | encodeURIComponent Method
JScript .NET
<Scheme>:<first>/<second>;<third>?<fourth>
Los nombres que van entre corchetes angulares representan componentes y los signos ":", "/", ";" y "?" son caracteres reservados
utilizados como separadores.
Para corregir este error
Compruebe que el código sólo intenta descodificar identificadores URI válidos. Por ejemplo, una cadena de JScript normal
puede no ser un identificador URI válido porque puede contener caracteres no válidos.
Vea también
decodeURI (Método) | decodeURIComponent (Método)
JScript .NET
Vea también
Number (Objeto) | toExponential (Método) | prototype (Propiedad) | Objetos
JScript .NET
See Also
No hay límite superior para el tamaño de una matriz más que el valor entero máximo (aproximadamente cuatro mil
millones).
Vea también
Utilizar matrices | Referencia de JScript
JScript .NET
No hay límite superior para el tamaño de una matriz más que el valor entero máximo (aproximadamente cuatro mil
millones).
Vea también
Utilizar matrices | Referencia de JScript
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Array Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Creating Your Own Objects with Constructor Functions |
Creating Your Own Classes
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Writing, Compiling, and Debugging JScript Code
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | const Statement | function get Statement |
function set Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | function get Statement | function set Statement
JScript .NET
See Also
Typed Arrays | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Writing, Compiling, and Debugging JScript Code
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | CodeAccessPermission Class
JScript .NET
import System;
import System.IO;
import System.Security;
import System.Security.Permissions;
class Alpha{
function Bravo() {
var fileioperm : FileIOPermission;
fileioperm = new FileIOPermission(FileIOPermissionAccess.AllAccess, 'd:\\temp\\myfile.t
xt');
fileioperm.Deny();
// Any additional code in this method will be
// denied access to d:\temp\myfile.txt.
}
}
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | CodeAccessSecurityAttribute (Clase) |
FileIOPermission (Clase)
JScript .NET
See Also
JScript Run-time Errors
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | Recursion
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Object Object | ActiveXObject Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | ActiveXObject Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | ActiveXObject Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | ActiveXObject Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Enumerator Object
JScript .NET
See Also
Error Object | JScript Reference
JScript .NET
See Also
See Also
JScript Language Features | JScript Reference | for Statement
JScript .NET
See Also
JScript Reference
JScript .NET
See Also
JScript Reference
JScript .NET
See Also
See Also
Function Object | function Statement | class Statement | interface Statement | enum Statement | JScript Reference
JScript .NET
See Also
Function Object | function Statement | class Statement | interface Statement | enum Statement | Controlling JScript Program Flow
| JScript Reference
JScript .NET
See Also
JScript Reference | Using Arrays
JScript .NET
See Also
Conditional Compilation | Conditional Compilation Variables
JScript .NET
See Also
See Also
String Object | toString Method
JScript .NET
/* This is a comment
This is another part of the same comment.*/
See Also
Comment Statements
JScript .NET
See Also
See Also
break Statement | Controlling JScript Program Flow | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
continue Statement | Controlling JScript Program Flow | Troubleshooting Your Scripts | JScript Reference
JScript .NET
z = "\u1A5F";
k = 0x3E8;
See Also
JScript Reference | Data Types
JScript .NET
See Also
See Also
Labeled Statement | switch Statement | break Statement | continue Statement
JScript .NET
See Also
Labeled Statement | switch Statement | break Statement | continue Statement
JScript .NET
Vea también
switch (Instrucción) | Controlar el flujo del programa JScript | Palabras reservadas de JScript
JScript .NET
See Also
Comma Operator (,)
JScript .NET
See Also
/*@cc_on @*/
See Also
Conditional Compilation | Conditional Compilation Variables | @cc_on Statement | @if Statement | @set Statement
JScript .NET
See Also
Conditional Compilation | Conditional Compilation Variables | @cc_on Statement | @if Statement | @set Statement
JScript .NET
See Also
@set Statement | Conditional Compilation | Conditional Compilation Variables
JScript .NET
See Also
try...catch...finally Statement | Error Object
JScript .NET
See Also
if...else Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | function Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
switch Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
@if...@elif...@else...@end Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
@if...@elif...@else...@end Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Modificadores de JScript |
Objetos basados en clases
JScript .NET
See Also
Vea también
See Also
JScript Variables and Constants | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Directives
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Directives
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Directives
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | @position Directive
JScript .NET
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
JS1121: No se admite
[JS1121: Deprecated]
El código contiene una expresión obsoleta. Existe otra expresión que realiza la misma tarea. Utilice la nueva alternativa, ya que la
compatibilidad con expresiones obsoletas puede desaparecer en versiones futuras del lenguaje.
Para corregir este error
Utilice el método encodeURI en lugar del método escape.
Utilice el método getFullYear en lugar del método getYear.
Utilice el método setFullYear en lugar del método setYear.
Utilice el método substring en lugar del método substr.
Utilice el método toUTCString en lugar del método toGMTString.
Utilice el método decodeURI en lugar del método unescape.
Vea también
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Class-based Objects | JScript Modifiers | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Class-based Objects | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
try...catch...finally Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Class-based Objects | JScript Modifiers | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
JScript Variables and Constants | Troubleshooting Your Scripts | JScript Reference | /fast
JScript .NET
See Also
JScript Variables and Constants | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
JScript Reserved Words | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | function get Statement | function set Statement | Class-based Objects
JScript .NET
JS1142: The get and set methods of this property do not match
each other
The code defines get and set accessors for a property. However, the return data type of the get accessor is not the same as the
parameter type of the set accessor.
To correct this error
Make sure that the return type of the get accessor matches the argument type of the set accessor.
See Also
function get Statement | function set Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Writing Custom Attributes | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Writing Custom Attributes | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
function Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
JS1149: The with statement has made the use of this name
ambiguous
An expression uses the with statement to access a class that has a member with the same name as an identifier in the current
scope. The compiler cannot distinguish which identifier to access.
To correct this error
Rename the member of the class or the identifier in the current scope.
Avoid using the with statement.
See Also
with Statement | Troubleshooting Your Scripts | JScript Reference
JScript .NET
JS1150: The presence of eval has made the use of this name
ambiguous
The program uses an eval statement and is compiled with fast mode turned off.
When fast mode is turned off, the eval statement allows new variables to be declared at runtime with local scope. These new
variables can shadow the global variables, which makes any reference to a variable not explicitly defined in the local scope
potentially ambiguous.
To correct this error
Compile with the fast option on.
Avoid using the eval statement.
Use only the variables available in the current local scope.
See Also
Troubleshooting Your Scripts | JScript Reference | eval Method | /fast
JScript .NET
<script runat="server">
expando function Person(name) {
// If the expando modifier was not applied to the definition of Person,
// the this statment in the following line of code would generate error
// JS1151
this.name = name;
}
</script>
<%
var fred = new Person("Fred");
Response.Write(fred.name);
%>
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | this Statement | expando Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | expando Modifier
JScript .NET
See Also
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | expando Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | abstract Modifier | private Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Objects | Typed Arrays
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | static Statement | JScript Modifiers | function Statement |
function get Statement | function set Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | package Statement | JScript Objects
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | expando Modifier | Class-based Objects | IEnumerable Interface
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | CLSCompliantAttribute Class | Writing CLS-Compliant Code |
What is the Common Language Specification?
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | delete Operator | JScript Object Object | expando Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | import Statement | package Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Expressions
JScript .NET
See Also
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | /versionsafe | JScript Modifiers | hide Modifier | override Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | /versionsafe | JScript Modifiers | hide Modifier | override Modifier |
final Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | hide Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | function set Statement | function get Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers | hide Modifier | override Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | override Modifier | Class-based Objects
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | function Statement | return Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript Referencia de JScript
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Datos numéricos
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | var Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | super Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference super Statement | static Modifier
JScript .NET
function test() {
try {
return(5); // Attempt to return 5.
} catch(e) {
print(e);
} finally {
return(10); // This gets run first, returning 10 instead of 5.
}
}
print(test()); // Prints 10, not 5.
See Also
Troubleshooting Your Scripts | JScript Reference | try...catch...finally Statement
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | function (Instrucción) | Funciones de JScript
JScript .NET
See Also
class Statement | interface Statement | JScript Modifiers | Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Functions | JScript Objects
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Arrays
JScript .NET
See Also
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Instrucciones de JScript
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | var Statement | Class-based Objects
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | function (Instrucción) | Objetos basados en clases
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | function get Statement | function set Statement | Class-based Objects
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | Advanced Class Creation | JScript Object Object
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Conditional Structures
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | if...else Statement
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | enum Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Matrices de JScript | Conversión de tipos
JScript .NET
See Also
See Also
See Also
Vea también
Vea también
See Also
Troubleshooting Your Scripts | JScript Reference | function Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers | interface Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | interface Statement
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | enum Statement | var Statement
JScript .NET
See Also
See Also
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | /target:library | class (Instrucción) |
interface (Instrucción) | package (Instrucción)
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Class-based Objects | static Modifier
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | function set Statement | function get Statement
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | try...catch...finally Statement | throw Statement
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | import Statement | /reference | /autoref
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | Numeric Data
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | static Modifier | Class-based Objects
JScript .NET
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | static Modifier | Class-based Objects
JScript .NET
See Also
See Also
[assembly: attribute]
The attribute should be a valid global attribute for an assembly, which are provided by the System.Reflection namespace. For
more information, see System.Reflection Namespace.
To correct this error
Make sure to use the correct syntax to declare global attributes.
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Ámbito de variables y constantes
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Modifiers
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Objetos basados en clases
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | expando (Modificador) | new (Operador)
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | AssemblyVersionAttribute Class
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | AssemblyCultureAttribute Class
JScript .NET
var b : System.Text.StringBuilder;
b = new System.Text.StringBuilder();
for(var i=0; i<10; i++)
b.Append(i);
print(b);
See Also
See Also
Troubleshooting Your Scripts | JScript Reference | Writing, Compiling, and Debugging JScript Code
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Modificadores de JScript
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | JScript Functions
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | import Statement | /reference
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Conversión de tipos
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | Conversión de tipos
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | /resource
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference
JScript .NET
Vea también
Solución de problemas en las secuencias de comandos | Referencia de JScript | CLSCompliantAttribute (Clase) |
Escribir código compatible con CLS | ¿Qué es Common Language Specification?
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | CLSCompliantAttribute Class | Writing CLS-Compliant Code |
What is the Common Language Specification?
JScript .NET
See Also
Troubleshooting Your Scripts | JScript Reference | CLSCompliantAttribute Class | Writing CLS-Compliant Code |
What is the Common Language Specification?
JScript .NET
Funciones
Estas funciones están integradas en los valores devueltos de JScript y otras funciones pueden utilizarlas en operaciones
posteriores.
En esta sección
GetObject (Función)
Devuelve una referencia a un objeto de Automatización desde un archivo.
ScriptEngine (Función)
Devuelve una cadena que representa el lenguaje de secuencias de comandos que se está utilizando.
ScriptEngineBuildVersion (Función)
Devuelve el número de versión de compilación del motor de secuencias de comandos que se está utilizando.
ScriptEngineMajorVersion (Función)
Devuelve el número de versión principal del motor de secuencias de comandos que se está utilizando.
ScriptEngineMinorVersion (Función)
Devuelve el número de versión secundaria del motor de secuencias de comandos que se está utilizando.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Referencia de .NET Framework
Muestra vínculos a temas que explican la sintaxis y estructura de la biblioteca de clases de .NET Framework y otros elementos
esenciales.
JScript .NET
GetObject (Función)
Devuelve una referencia a un objeto de Automatización desde un archivo. La función puede presentar dos formas:
Argumentos
class
Requerido. Cadena de tipo "nombreAplic.tipoObj", donde nombreAplic es el nombre de la aplicación que proporciona el objeto
y tipoObj es el tipo o la clase de objeto que se va a crear.
pathname
Requerido. Ruta completa y nombre del archivo que contiene el objeto que se va a recuperar. Si se omite el argumento
pathname, es necesario el argumento class.
Comentarios
Use la función GetObject para tener acceso a un objeto de Automatización desde un archivo. Asigne el objeto devuelto por la
función GetObject a la variable de objeto. Por ejemplo:
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
Cuando se ejecuta este código, se inicia la aplicación asociada al argumento pathname especificado y se activa el objeto del
archivo especificado. Si el argumento pathname es una cadena de longitud cero (""), la función GetObject devuelve una nueva
instancia de objeto del tipo especificado. Si se omite el argumento pathname, la función GetObject devuelve un objeto
actualmente activo del tipo especificado. Si no existe ningún objeto del tipo especificado, se produce un error.
Algunas aplicaciones permiten activar parte de un archivo. Para ello, añada un signo de exclamación (!) al final del nombre de
archivo, seguido de una cadena que especifique la parte del archivo que desea activar. Para obtener información sobre cómo
crear esta cadena, consulte la documentación de la aplicación que ha creado el objeto.
Por ejemplo, en una aplicación de dibujo, quizá tenga muchas capas para un dibujo almacenado en un archivo. Puede utilizar el
código siguiente para activar una capa dentro de un dibujo denominado SCHEMA.CAD:
Si no especifica la clase del objeto, el objeto de Automatización determina la aplicación que se va a iniciar y el objeto que se va a
activar, basándose en el nombre de archivo que se proporcione. Sin embargo, algunos archivos pueden admitir más de una clase
de objeto. Por ejemplo, un dibujo puede ser compatible con tres tipos diferentes de objetos: un objeto Application, un objeto
Drawing y un objeto Toolbar, que forman parte todos ellos del mismo archivo. Para especificar el objeto que desea activar en un
archivo, utilice el argumento opcional class. Por ejemplo:
var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");
En el ejemplo anterior, FIGMENT es el nombre de una aplicación de dibujo y DRAWING es uno de los tipos de objeto que admite. Una
vez que se activa un objeto, se hace referencia a él en el código mediante la variable de objeto que haya definido. En el ejemplo
anterior, se tiene acceso a las propiedades y métodos del nuevo objeto mediante la variable de objeto MyObject. Por ejemplo:
MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");
Nota Utilice la función GetObject cuando exista una instancia actual del objeto o cuando desee crear el objeto con
un archivo cargado. Si no existe ninguna instancia actual y no desea que el objeto se inicie con un archivo cargado,
utilice el objeto ActiveXObject.
Si un objeto se registró como objeto de una única instancia, sólo se creará una instancia del objeto, con independencia del
número de veces que se ejecute el objeto ActiveXObject. Con un objeto de una sola instancia, la función GetObject devuelve
siempre la misma instancia cuando se llama con sintaxis de cadena de longitud cero (""), y origina un error si se omite el
argumento pathname.
Requisitos
Versión 5
Vea también
ActiveXObject (Objeto)
JScript .NET
ScriptEngine (Función)
Devuelve una cadena que representa el lenguaje de secuencias de comandos que se está utilizando.
Comentarios
La función ScriptEngine puede devolver cualquiera de las siguientes cadenas:
Cadena Descripción
Jscript Indica que Microsoft JScript es el motor de secuencias de comandos actual.
VBA Indica que Microsoft Visual Basic para Aplicaciones es el motor de secuencias de comandos actual.
VBScript Indica que Microsoft Visual Basic Scripting es el motor de secuencias de comandos actual.
Ejemplo
El siguiente ejemplo muestra el uso de la función ScriptEngine:
function GetScriptEngineInfo(){
var s;
s = ""; // Build string with necessary info.
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}
Requisitos
Versión 2
Vea también
ScriptEngineBuildVersion (Función)
Devuelve el número de versión de compilación del motor de secuencias de comandos que se está utilizando.
Comentarios
El valor devuelto corresponde directamente a la información de versión contenida en la biblioteca de vínculos dinámicos (DLL) del
lenguaje de secuencias de comandos que se utiliza.
Ejemplo
El siguiente ejemplo muestra el uso de la función ScriptEngineBuildVersion:
function GetScriptEngineInfo(){
var s;
s = ""; // Build string with necessary info.
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}
Requisitos
Versión 2
Vea también
ScriptEngine (Función) | ScriptEngineMajorVersion (Función) | ScriptEngineMinorVersion (Función)
JScript .NET
ScriptEngineMajorVersion (Función)
Devuelve el número de versión principal del motor de secuencias de comandos que se está utilizando.
Comentarios
El valor devuelto corresponde directamente a la información de versión contenida en la biblioteca de vínculos dinámicos (DLL) del
lenguaje de secuencias de comandos que se está utilizando.
Ejemplo
El siguiente ejemplo muestra el uso de la función ScriptEngineMajorVersion:
function GetScriptEngineInfo(){
var s;
s = ""; // Build string with necessary info.
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}
Requisitos
Versión 2
Vea también
ScriptEngine (Función) | ScriptEngineBuildVersion (Función) | ScriptEngineMinorVersion (Función)
JScript .NET
ScriptEngineMinorVersion (Función)
Devuelve el número de versión secundaria del motor de secuencias de comandos que se está utilizando.
Comentarios
El valor devuelto corresponde directamente a la información de versión contenida en la biblioteca de vínculos dinámicos (DLL) del
lenguaje de secuencias de comandos que se está utilizando.
Ejemplo
El siguiente ejemplo muestra el uso de la función ScriptEngineMinorVersion.
function GetScriptEngineInfo(){
var s;
s = ""; // Build string with necessary info.
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}
Requisitos
Versión 2
Vea también
ScriptEngine (Función) | ScriptEngineBuildVersion (Función) | ScriptEngineMajorVersion (Función)
JScript .NET
Literals
Literals are invariant program elements that have special meaning within the context of JScript code.
In This Section
false Literal
null Literal
true Literal
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
.NET Framework Reference
Lists links to topics that explain the syntax and structure of the .NET Framework class library and other essential elements.
JScript .NET
false Literal
A Boolean value that represents false.
Remarks
A Boolean value is either true or false. The opposite of false, or not false, is true.
Requirements
Version 1
See Also
boolean Data Type | Boolean Object | true Literal | JScript Data Types
JScript .NET
null Literal
An object that represents "no object".
Remarks
You can erase the contents of a variable (without deleting the variable) by assigning it the null value.
Note In JScript, null is not the same as 0 (as it is in C and C++). Also the typeof operator in JScript reports null
values as being of type Object, not of type null. This potentially confusing behavior is maintained for backwards
compatibility.
Requirements
Version 1
See Also
Object Object | JScript Data Types
JScript .NET
true Literal
A Boolean value that represents true.
Remarks
A Boolean value is either true or false. The opposite of true, or not true, is false.
Requirements
Version 1
See Also
boolean Data Type | Boolean Object | false Literal | JScript Data Types
JScript .NET
Métodos
Un método es una función que es miembro de un objeto. Los distintos métodos de JScript se encuentran ordenados
alfabéticamente según el nombre del método.
En esta sección
Métodos (A-E)
Métodos (F-I)
Métodos (J-R)
Métodos (S)
Métodos (T-Z)
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Objetos
Detalla el concepto de objeto en JScript, explica cómo los objetos están relacionados con las propiedades y los métodos, e
incluye vínculos a temas que proporcionan más detalles sobre los objetos que JScript admite.
Referencia de .NET Framework
Muestra vínculos a temas que explican la sintaxis y estructura de la biblioteca de clases de .NET Framework y otros elementos
esenciales.
JScript .NET
Methods (A-E)
A method is a function that is a member of an object. Following are methods whose names begin with letters a through e.
In This Section
abs Method
Returns the absolute value of a number.
acos Method
Returns the arccosine of a number.
anchor Method
Places an HTML anchor with a NAME attribute around specified text in the object.
apply Method
Returns a method of an object, substituting another object for the current object.
asin Method
Returns the arcsine of a number.
atan Method
Returns the arctangent of a number.
atan2 Method
Returns the angle (in radians) from the X-axis to a point (x,y).
atEnd Method
Returns a Boolean value indicating if the enumerator is at the end of the collection.
big Method
Places HTML <BIG> tags around text in a String object.
blink Method
Places HTML <BLINK> tags around text in a String object.
bold Method
Places HTML <B> tags around text in a String object.
call Method
Calls a method of an object, substituting another object for the current object.
ceil Method
Returns the smallest integer greater than or equal to its numeric argument.
charAt Method
Returns the character at the specified index.
charCodeAt Method
Returns the Unicode encoding of the specified character.
compile Method
Compiles a regular expression into an internal format.
concat Method (Array)
Returns a new array consisting of a combination of two arrays.
concat Method (String)
Returns a String object containing the concatenation of two supplied strings.
cos Method
Returns the cosine of a number.
decodeURI Method
Returns the unencoded version of an encoded Uniform Resource Identifier (URI).
decodeURIComponent Method
Returns the unencoded version of an encoded component of a Uniform Resource Identifier (URI).
dimensions Method
Returns the number of dimensions in a VBArray.
encodeURI Method
Encodes a text string as a valid Uniform Resource Identifier (URI).
encodeURIComponent Method
Encodes a text string as a valid component of a Uniform Resource Identifier (URI).
escape Method
Encodes String objects so they can be read on all computers.
eval Method
Evaluates JScript code and executes it.
exec Method
Executes a search for a match in a specified string.
exp Method
Returns e (the base of natural logarithms) raised to a power.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Methods
Lists the methods, classified alphabetically, available in JScript, and links to each category of methods.
Objects
Explains the concept of objects in JScript, how objects are related to properties and methods, and links to topics that provide
more detail about the objects that JScript supports.
JScript .NET
abs Method
Returns the absolute value of a number.
Arguments
number
Required. A numeric expression.
Remarks
The return value is the absolute value of the number argument.
Example
The following example illustrates the use of the abs method.
function ComparePosNegVal(n) {
var s = "";
var v1 = Math.abs(n);
var v2 = Math.abs(-n);
if (v1 == v2) {
s = "The absolute values of " + n + " and "
s += -n + " are identical.";
}
return(s);
}
Requirements
Version 1
See Also
Methods
Applies To: Math Object
JScript .NET
acos Method
Returns the arccosine of a number.
Arguments
number
Required. A numeric expression.
Remarks
The return value is between 0 and pi, representing the arccosine of the number argument. If number is less than -1 or number is
greater than +1, the return value is NaN.
Requirements
Version 1
See Also
asin Method | atan Method | cos Method | sin Method | tan Method | PI Property
Applies To: Math Object
JScript .NET
anchor Method
Returns a string with an HTML anchor with a NAME attribute around specified text in the object.
Arguments
anchorString
Required. Text you want to place in the NAME attribute of an HTML anchor.
Remarks
Call the anchor method to create a named anchor out of a String object.
No checking is done to see if the tag has already been applied to the string.
Example
The following example demonstrates how the anchor method accomplishes this:
Requirements
Version 1
See Also
link Method
Applies To: String Object
JScript .NET
apply Method
Returns a method of an object, substituting another object for the current object.
Arguments
thisObj
Optional. The object to be used as the current object.
argArray
Optional. Array of arguments or an arguments object to be passed to the function.
Remarks
If argArray is not a valid array or is not the arguments object, then a TypeError results.
If neither argArray nor thisObj are supplied, the global object is used as thisObj and is passed no arguments.
Requirements
Version 5.5
See Also
Methods
Applies To: Function Object
JScript .NET
asin Method
Returns the arcsine of a number.
Arguments
number
Required. A numeric expression.
Remarks
The return value is between -pi/2 and pi/2, representing the arcsine of the number argument. If number is less than -1 or number
is greater than +1, the return value is NaN.
Requirements
Version 1
See Also
acos Method | atan Method | cos Method | sin Method | tan Method | PI Property
Applies To: Math Object
JScript .NET
atan Method
Returns the arctangent of a number.
Arguments
number
Required. A numeric expression.
Remarks
The return value is between -pi/2 and pi/2, representing the arctangent of the number argument.
Requirements
Version 1
See Also
acos Method | asin Method | atan2 Method | cos Method | sin Method | tan Method | PI Property
Applies To: Math Object
JScript .NET
atan2 Method
Returns the angle (in radians) from the X axis to a point (x,y).
Arguments
x
Required. A numeric expression representing the Cartesian x-coordinate of a point.
y
Required. A numeric expression representing the Cartesian y-coordinate of a point.
Remarks
The return value is between -pi and pi, representing the angle of the supplied (x,y) point.
Requirements
Version 1
See Also
atan Method | tan Method | PI Property
Applies To: Math Object
JScript .NET
atEnd Method
Returns a Boolean value indicating if the enumerator is at the end of the collection.
Remarks
The atEnd method returns true if the current item is the last one in the collection, the collection is empty, or the current item is
undefined. Otherwise, it returns false.
Example
In following code, the atEnd method is used to determine if the end of a list of drives has been reached:
function ShowDriveList(){
var fso, s, n, e, x;
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives);
s = "";
for (; !e.atEnd(); e.moveNext())
{
x = e.item();
s = s + x.DriveLetter;
s += " - ";
if (x.DriveType == 3)
n = x.ShareName;
else if (x.IsReady)
n = x.VolumeName;
else
n = "[Drive not ready]";
s += n + "<br>";
}
return(s);
}
Requirements
Version 2
See Also
item Method | moveFirst Method | moveNext Method
Applies To: Enumerator Object
JScript .NET
big Method
Returns a string with HTML <BIG> tags around the text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
The example that follows shows how the big method works:
Requirements
Version 1
See Also
small Method
Applies To: String Object
JScript .NET
blink Method
Returns a string with HTML <BLINK> tags around the text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
The <BLINK> tag is not supported in Microsoft Internet Explorer.
Example
The following example demonstrates how the blink method works:
Requirements
Version 1
See Also
Methods
Applies To: String Object
JScript .NET
bold Method
Returns a string with HTML <B> tags around the text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
Requirements
Version 1
See Also
italics Method
Applies To: String Object
JScript .NET
call Method
Calls a method of an object, substituting another object for the current object.
Arguments
thisObj
Optional. The object to be used as the current object.
arg1, arg2, ..., argN
Optional. List of arguments to be passed to the method.
Remarks
The call method is used to call a method on behalf of another object. The call method allows you to change the object context of
a function from the original context to the new object specified by thisObj.
If thisObj is not supplied, the global object is used as thisObj.
Requirements
Version 5.5
See Also
Methods
Applies To: Function Object
JScript .NET
ceil Method
Returns the smallest integer greater than or equal to its numeric argument.
Arguments
number
Required. A numeric expression.
Remarks
The return value is an integer value equal to the smallest integer greater than or equal to its numeric argument.
Requirements
Version 1
See Also
floor Method
Applies To: Math Object
JScript .NET
charAt Method
Returns the character at the specified index of a String object.
Arguments
index
Required. Zero-based index of the desired character. Valid values are between 0 and the length of the string minus 1.
Remarks
The charAt method returns a character value equal to the character at the specified index. The first character in a string is at index
0, the second is at index 1, and so forth. Values of index out of valid range return an empty string.
Example
The following example illustrates the use of the charAt method:
function charAtTest(n){
var str = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"; // Initialize variable.
var s; // Declare variable.
s = str.charAt(n - 1); // Get correct character
// from position n – 1.
return(s); // Return character.
}
Requirements
Version 1
See Also
Methods
Applies To: String Object
JScript .NET
charCodeAt Method
Returns an integer representing the Unicode encoding of the character at the specified location in a String object.
Arguments
index
Required. Zero-based index of the desired character. Valid values are between 0 and the length of the string minus 1.
Remarks
The first character in a string is at index 0, the second is at index 1, and so forth.
If there is no character at the specified index, NaN is returned.
Example
The following example illustrates the use of the charCodeAt method.
function charCodeAtTest(n){
var str = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"; //Initialize variable.
var n; //Declare variable.
n = str.charCodeAt(n - 1); //Get the Unicode value of the
// character at position n.
return(n); //Return the value.
}
Requirements
Version 5.5
See Also
fromCharCode Method
Applies To: String Object
JScript .NET
compile (Método)
Compila una expresión regular y la convierte a un formato interno para una ejecución más rápida.
Argumentos
pattern
Necesario. Expresión de cadena que contiene un modelo de expresión regular que se va a compilar.
flags
Opcional. Los indicadores disponibles que se pueden combinar son:
g (búsqueda global para todas las repeticiones del argumento pattern)
i (pasar por alto mayúsculas y minúsculas)
m (búsqueda en varias líneas)
Comentarios
El método compile convierte el argumento pattern a un formato interno para que la ejecución sea más rápida. Esto permite un
uso más eficiente de expresiones regulares en, por ejemplo, bucles. Una expresión regular compilada aumenta la velocidad
cuando se vuelve a utilizar la misma expresión repetidamente. Sin embargo, no se obtienen ventajas si la expresión regular
cambia.
Ejemplo
El siguiente ejemplo muestra el uso del método compile:
function CompileDemo(){
var rs;
var s = "AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPp"
// Create regular expression for uppercase only.
var r = new RegExp("[A-Z]", "g");
var a1 = s.match(r) // Find matches.
// Compile the regular expression for lowercase only.
r.compile("[a-z]", "g");
var a2 = s.match(r) // Find matches.
return(a1 + "\n" + a2);
}
Requisitos
Versión 3
Vea también
Sintaxis de expresiones regulares
Se aplica a: Regular Expression (Objeto)
JScript .NET
function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array
Arguments
item1, item2, ..., itemN
Optional. Additional items to add to the end of the current array.
Remarks
The concat method returns an Array object containing the concatenation of the current array and any other supplied items.
The items to be added (item1 ... itemN) to the array are added, in order, from left to right. If one of the items is an array, its
contents are added to the end of the current array. If the item is anything other than an array, it is added to the end of the array as
a single array element.
Elements of source arrays are copied to the resulting array as follows:
For an object reference copied from any of the arrays being concatenated to the new array, the object reference continues to
point to the same object. A change in either the new array or the original array will result in a change to the other.
For a numeric or string value being concatenated to the new array, only the value is copied. Changes in a value in one array
do not affect the value in the other.
Example
The following example illustrates the use of the concat method when used with an array:
function ConcatArrayDemo(){
var a, b, c, d;
a = new Array(1,2,3);
b = "JScript";
c = new Array(42, "VBScript");
d = a.concat(b, c);
//Returns the array [1, 2, 3, "JScript", 42, "VBScript"]
return(d);
}
Requirements
Version 3
See Also
concat Method (String) | join Method | String Object
Applies To: Array Object
JScript .NET
Arguments
string1, ... , stringN
Optional. String objects or literals to concatenate to the end of the current string.
Remarks
The result of the concat method is equivalent to: result = curstring + string1 + ... + stringN. The curstring refers the string stored
in the object that supplies the concat method. A change of value in either a source or result string does not affect the value in the
other string. If any of the arguments are not strings, they are first converted to strings before being concatenated to curstring.
Example
The following example illustrates the use of the concat method when used with a string:
function concatDemo(){
var str1 = "ABCDEFGHIJKLM"
var str2 = "NOPQRSTUVWXYZ";
var s = str1.concat(str2);
// Return concatenated string.
return(s);
}
Requirements
Version 3
See Also
cos Method
Returns the cosine of a number.
Arguments
number
Required. A numeric expression.
Remarks
The return value is the cosine of its numeric argument.
Requirements
Version 1
See Also
acos Method | asin Method | atan Method | sin Method | tan Method
Applies To: Math Object
JScript .NET
decodeURI Method
Returns the unencoded version of an encoded Uniform Resource Identifier (URI).
Arguments
URIstring
Required. A string representing an encoded URI.
Remarks
Use the decodeURI method instead of the obsolete unescape method.
The decodeURI method returns a string value.
If the URIString is not valid, a URIError occurs.
Requirements
Version 5.5
See Also
decodeURIComponent Method
Returns the unencoded version of an encoded component of a Uniform Resource Identifier (URI).
dimensions Method
Returns the number of dimensions in a VBArray.
Remarks
The dimensions method provides a way to retrieve the number of dimensions in a specified VBArray.
The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is
JScript code that determines the number of dimensions in the safe array and the upper bound of each dimension. Both of these
parts go into the <HEAD> section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the
other two parts.
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
k = k + 1
Next
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vba)
{
var i, s;
var a = new VBArray(vba);
for (i = 1; i <= a.dimensions(); i++)
{
s = "The upper bound of dimension ";
s += i + " is ";
s += a.ubound(i)+ ".<BR>";
}
return(s);
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT language="jscript">
document.write(VBArrayTest(CreateVBArray()));
</SCRIPT>
</BODY>
Requirements
Version 3
See Also
getItem Method | lbound Method | toArray Method | ubound Method
Applies To: VBArray Object
JScript .NET
encodeURI Method
Returns a string encoded as a valid Uniform Resource Identifier (URI)
Arguments
URIString
Required. A string representing an encoded URI.
Remarks
The encodeURI method returns an encoded URI. If you pass the result to decodeURI, the original string is returned. The
encodeURI method does not encode the following characters: ":", "/", ";", and "?". Use encodeURIComponent to encode these
characters.
Requirements
Version 5.5
See Also
decodeURI Method | decodeURIComponent Method
Applies To: Global Object
JScript .NET
encodeURIComponent Method
Returns as string encoded as a valid component of a Uniform Resource Identifier (URI).
Arguments
encodedURIString
Required. A string representing an encoded URI component.
Remarks
The encodeURIComponent method returns an encoded URI. If you pass the result to decodeURIComponent, the original
string is returned. Because the encodeURIComponent method encodes all characters, be careful if the string represents a path
such as /folder1/folder2/default.html. The slash characters will be encoded and will not be valid if sent as a request to a Web
server. Use the encodeURI method if the string contains more than a single URI component.
Requirements
Version 5.5
See Also
decodeURI Method | decodeURIComponent Method
Applies To: Global Object
JScript .NET
escape Method
Returns an encoded String object that can be read on all computers.
Arguments
charString
Required. Any String object or literal to be encoded.
Remarks
The escape method returns a string value (in Unicode format) that contains the contents of charstring. All spaces, punctuation,
accented characters, and any other non-ASCII characters are replaced with %xx encoding, where xx is equivalent to the
hexadecimal number representing the character. For example, a space is returned as "%20."
Characters with a value greater than 255 are stored using the %uxxxx format.
Note The escape method should not be used to encode Uniform Resource Identifiers (URI). Use encodeURI and
encodeURIComponent methods instead.
Requirements
Version 1
See Also
encodeURI Method | encodeURIComponent Method | String Object | unescape Method
Applies To: Global Object
JScript .NET
eval (Método)
Evalúa código JScript y lo ejecuta.
Argumentos
codeString
Necesario. Cadena que contiene código de JScript válido.
override
Opcional. Cadena que determina qué permiso de seguridad se le debe aplicar al código de codeString.
Comentarios
La función eval permite la ejecución dinámica del código de origen de JScript.
El código pasado al método eval se ejecuta en el mismo contexto que la llamada al método eval. Tenga en cuenta que las
variables o tipos nuevos definidos en la instrucción eval no son visibles para el programa de inclusión.
El código que se pasa al método eval se ejecuta en un contexto de seguridad restringido, a menos que la cadena "unsafe" se pase
como segundo parámetro. El contexto de seguridad restringido prohíbe el acceso a los recursos del sistema, como el sistema de
archivos, la red o la interfaz de usuario. Si el código intenta obtener acceso a estos recursos, se genera una excepción de
seguridad.
Si el segundo parámetro de eval es la cadena "unsafe", el código que se pasa al método eval se ejecuta en el mismo contexto de
seguridad que el código de llamada. El segundo parámetro distingue entre mayúsculas y minúsculas, por lo tanto, las cadenas
"Unsafe" o "UnSAfE" no reemplazarán el contexto de seguridad restringido.
Nota de seguridad Utilice eval en modo no seguro (unsafe) únicamente para ejecutar cadenas de código
procedentes de orígenes de confianza.
Ejemplo
Por ejemplo, el siguiente fragmento de código inicializa la variable mydate a una fecha de prueba o a la fecha actual, dependiendo
del valor de la variable doTest:
Requisitos
Versión 1
Vea también
String (Objeto)
Se aplica a: Global (Objeto)
JScript .NET
exec Method
Executes a search on a string using a regular expression pattern, and returns an array containing the results of that search.
Arguments
str
Required. The String object or string literal on which to perform the search.
Remarks
If the exec method does not find a match, it returns null. If it finds a match, exec returns an array, and the properties of the
global RegExp object are updated to reflect the results of the match. Element zero of the array contains the entire match, while
elements 1 – n contain any submatches that have occurred within the match. This behavior is identical to the behavior of the
match method without the global flag (g) set.
If the global flag is set for a regular expression, exec searches the string beginning at the position indicated by the value of
lastIndex. If the global flag is not set, exec ignores the value of lastIndex and searches from the beginning of the string.
The array returned by the exec method has three properties, input, index and lastIndex. The input property contains the entire
searched string. The index property contains the position of the matched substring within the complete searched string. The
lastIndex property contains the position following the last character in the match.
Example
The following example illustrates the use of the exec method:
function RegExpTest() {
var s = "";
var src = "The rain in Spain falls mainly in the plain.";
// Create regular expression pattern for matching a word.
var re = /\w+/g;
var arr;
// Loop over all the regular expression matches in the string.
while ((arr = re.exec(src)) != null)
s += arr.index + "-" + arr.lastIndex + "\t" + arr + "\n";
return s;
}
Requirements
Version 3
See Also
match Method | RegExp Object | Regular Expression Syntax | search method | test Method
Applies To: Regular Expression Object
JScript .NET
exp Method
Returns e (the base of natural logarithms) raised to a power.
Arguments
number
Required. A numeric expression.
Remarks
The return value is enumber. The constant e is the base of natural logarithms, approximately equal to 2.178 and number is the
supplied argument.
Requirements
Version 1
See Also
E Property
Applies To: Math Object
JScript .NET
Methods (F-I)
A method is a function that is a member of an object. Following are methods whose names begin with letters f through i.
In This Section
fixed Method
Places HTML <TT> tags around text in a String object.
floor Method
Returns the greatest integer less than or equal to its numeric argument.
fontcolor Method
Places an HTML <FONT> tag with the COLOR attribute around the text in a String object.
fontsize Method
Places an HTML <FONT> tag with the SIZE attribute around the text in a String object.
fromCharCode Method
Returns a string from a number of Unicode character values.
getDate Method
Returns the day of the month value in a Date object using local time.
getDay Method
Returns the day of the week value in a Date object using local time.
getFullYear Method
Returns the year value in the Date object using local time.
getHours Method
Returns the hours value in a Date object using local time.
getItem Method
Returns the item at the specified location.
getMilliseconds Method
Returns the milliseconds value in a Date object using local time.
getMinutes Method
Returns the minutes value stored in a Date object using local time.
getMonth Method
Returns the month value in the Date object using local time.
getSeconds Method
Returns seconds value stored in a Date object using local time.
getTime Method
Returns the time value in a Date object.
getTimezoneOffset Method
Returns the difference in minutes between the time on the host computer and Coordinated Universal Time (UTC).
getUTCDate Method
Returns the date value in a Date object using Coordinated Universal Time (UTC).
getUTCDay Method
Returns the day of the week value in a Date object using Coordinated Universal Time (UTC).
getUTCFullYear Method
Returns the year value in a Date object using Coordinated Universal Time (UTC).
getUTCHours Method
Returns the hours value in a Date object using Coordinated Universal Time (UTC).
getUTCMilliseconds Method
Returns the milliseconds value in a Date object using Coordinated Universal Time (UTC).
getUTCMinutes Method
Returns the minutes value in a Date object using Coordinated Universal Time (UTC).
getUTCMonth Method
Returns the month value in a Date object using Coordinated Universal Time (UTC).
getUTCSeconds Method
Returns the seconds value in a Date object using Coordinated Universal Time (UTC).
getVarDate Method
Returns the VT_DATE value in a Date object.
getYear Method
Returns the year value in a Date object. (This method is obsolete; use the getFullYear method instead.)
hasOwnProperty Method
Returns a Boolean value indicating whether an object has a property with the specified name.
indexOf Method
Returns the character position where the first occurrence of a substring occurs within a String object.
isFinite Method
Returns a Boolean value that indicates if a supplied number is finite.
isNaN Method
Returns a Boolean value that indicates whether a value is the reserved value NaN (not a number).
isPrototypeOf Method
Returns a Boolean value indicating whether an object exists in another object's prototype chain.
italics Method
Places HTML <I> tags around text in a String object.
item Method
Returns the current item in the collection.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Methods
Lists the methods, classified alphabetically, available in JScript, and links to each category of methods.
Objects
Explains the concept of objects in JScript, how objects are related to properties and methods, and links to topics that provide
more detail about the objects that JScript supports.
JScript .NET
fixed Method
Returns a string with HTML <TT> tags around text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
Requirements
Version 1
See Also
Methods
Applies To: String Object
JScript .NET
floor Method
Returns the greatest integer less than or equal to its numeric argument.
Arguments
number
Required. A numeric expression.
Remarks
The return value is an integer value equal to the greatest integer less than or equal to its numeric argument.
Requirements
Version 1
See Also
ceil Method
Applies To: Math Object
JScript .NET
fontcolor Method
Returns a string with an HTML <FONT> tag with the COLOR attribute around the text in a String object.
Arguments
colorVal
Required. String value containing a color value. This can either be the hexadecimal value for a color, or the predefined name for
a color.
Remarks
Valid predefined color names depend on your JScript host (browser, server, and so forth). They may also vary from version to
version of your host. Check your host documentation for more information.
No checking is done to see if the tag has already been applied to the string.
Example
The following example demonstrates the fontcolor method:
Requirements
Version 1
See Also
fontsize Method
Applies To: String Object
JScript .NET
fontsize Method
Returns a string with an HTML <FONT> tag with the SIZE attribute around the text in a String object.
Arguments
intSize
Required. Integer value that specifies the size of the text.
Remarks
Valid integer values depend on your Microsoft JScript host. See your host documentation for more information.
No checking is done to see if the tag has already been applied to the string.
Example
The following example demonstrates the fontsize method:
Requirements
Version 1
See Also
fontcolor Method
Applies To: String Object
JScript .NET
fromCharCode Method
Returns a string from a number of Unicode character values.
Arguments
code1, ... , codeN
Optional. A series of Unicode character values to convert to a string. If no arguments are supplied, the result is the empty string.
Remarks
The fromCharCode method is called from the global String object.
Example
In the following example, test is assigned the string "plain":
Requirements
Version 3
See Also
charCodeAt Method
Applies To: String Object
JScript .NET
getDate Method
Returns the day of the month value in a Date object using local time.
Remarks
To get the date value using Coordinated Universal Time (UTC), use the getUTCDate method.
The return value is an integer between 1 and 31 that represents the date value in the Date object.
Example
The following example illustrates the use of the getDate method.
function DateDemo(){
var d, s = "Today's date is: ";
d = new Date();
s += (d.getMonth() + 1) + "/";
s += d.getDate() + "/";
s += d.getYear();
return(s);
}
Requirements
Version 1
See Also
getUTCDate Method | setDate Method | setUTCDate Method
Applies To: Date Object
JScript .NET
getDay Method
Returns the day of the week value in a Date object using local time.
Remarks
To get the day using Coordinated Universal Time (UTC), use the getUTCDay method.
The value returned from the getDay method is an integer between 0 and 6 representing the day of the week and corresponds to
a day of the week as follows:
Value Day of the Week
0 Sunday
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday
The following example illustrates the use of the getDay method.
function DateDemo(){
var d, day, x, s = "Today is: ";
var x = new Array("Sunday", "Monday", "Tuesday");
var x = x.concat("Wednesday","Thursday", "Friday");
var x = x.concat("Saturday");
d = new Date();
day = d.getDay();
return(s += x[day]);
}
Requirements
Version 1
See Also
getUTCDay Method
Applies To: Date Object
JScript .NET
getFullYear Method
Returns the year value in the Date object using local time.
Remarks
To get the year using Coordinated Universal Time (UTC), use the getUTCFullYear method.
The getFullYear method returns the year as an absolute number. For example, the year 1976 is returned as 1976. This avoids the
year 2000 problem where dates beginning with January 1, 2000 are confused with those beginning with January 1, 1900.
The following example illustrates the use of the getFullYear method.
function DateDemo(){
var d, s = "Today's date is: ";
d = new Date();
s += (d.getMonth() + 1) + "/";
s += d.getDate() + "/";
s += d.getFullYear();
return(s);
}
Requirements
Version 3
See Also
getUTCFullYear Method | setFullYear Method | setUTCFullYear Method
Applies To: Date Object
JScript .NET
getHours Method
Returns the hours value in a Date object using local time.
Remarks
To get the hours value using Coordinated Universal Time (UTC), use the getUTCHours method.
The getHours method returns an integer between 0 and 23, indicating the number of hours since midnight. A zero occurs in two
situations: the time is before 1:00:00 am, or the time was not stored in the Date object when the object was created. The only way
to determine which situation you have is to also check the minutes and seconds for zero values. If they are all zeroes, it is nearly
certain that the time was not stored in the Date object.
The following example illustrates the use of the getHours method.
function TimeDemo(){
var d, s = "The current local time is: ";
var c = ":";
d = new Date();
s += d.getHours() + c;
s += d.getMinutes() + c;
s += d.getSeconds() + c;
s += d.getMilliseconds();
return(s);
}
Requirements
Version 1
See Also
getUTCHours Method | setHours Method | setUTCHours Method
Applies To: Date Object
JScript .NET
getItem Method
Returns the item at the specified location in a VBArray object.
Arguments
dimension1, ..., dimensionN
Specifies the exact location of the desired element of the VBArray. The number of arguments must match the number of
dimensions in the VBArray.
Example
The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is
JScript code that iterates the Visual Basic safe array and prints out the contents of each element. Both of these parts go into the
<HEAD> section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the other two parts.
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(i, j) = k
document.writeln(k)
k = k + 1
Next
document.writeln("<BR>")
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function GetItemTest(vbarray)
{
var i, j;
var a = new VBArray(vbarray);
for (i = 0; i <= 2; i++)
{
for (j =0; j <= 2; j++)
{
document.writeln(a.getItem(i, j));
}
}
}-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT LANGUAGE="JScript">
<!--
GetItemTest(CreateVBArray());
-->
</SCRIPT>
</BODY>
Requirements
Version 1
See Also
getMilliseconds Method
Returns the milliseconds value in a Date object using local time.
Remarks
To get the number of milliseconds in Coordinated Universal Time (UTC), use the getUTCMilliseconds method.
The millisecond value returned can range from 0-999.
Example
The following example illustrates the use of the getMilliseconds method.
function TimeDemo(){
var d, s = "The current local time is: ";
var c = ":";
d = new Date();
s += d.getHours() + c;
s += d.getMinutes() + c;
s += d.getSeconds() + c;
s += d.getMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getUTCMilliseconds Method | setMilliseconds Method | setUTCMilliseconds Method
Applies To: Date Object
JScript .NET
getMinutes Method
Returns the minutes value in a Date object using local time.
Remarks
To get the minutes value using Coordinated Universal Time (UTC), use the getUTCMinutes method.
The getMinutes method returns an integer between 0 and 59 equal to the minute's value stored in the Date object. A zero is
returned in two situations: when the time is less than one minute after the hour, or when the time was not stored in the Date
object when the object was created. The only way to determine which situation you have is to also check the hours and seconds
for zero values. If they are all zeroes, it is nearly certain that the time was not stored in the Date object.
Example
The following example illustrates the use of the getMinutes method.
function TimeDemo(){
var d, s = "The current local time is: ";
var c = ":";
d = new Date();
s += d.getHours() + c;
s += d.getMinutes() + c;
s += d.getSeconds() + c;
s += d.getMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getUTCMinutes Method | setMinutes Method | setUTCMinutes Method
Applies To: Date Object
JScript .NET
getMonth Method
Returns the month value in the Date object using local time.
Remarks
To get the month value using Coordinated Universal Time (UTC), use the getUTCMonth method.
The getMonth method returns an integer between 0 and 11 indicating the month value in the Date object. The integer returned
is not the traditional number used to indicate the month. It is one less. If "Jan 5, 1996 08:47:00" is stored in a Date object,
getMonth returns 0.
Example
The following example illustrates the use of the getMonth method.
function DateDemo(){
var d, s = "Today's date is: ";
d = new Date();
s += (d.getMonth() + 1) + "/";
s += d.getDate() + "/";
s += d.getYear();
return(s);
}
Requirements
Version 1
See Also
getUTCMonth Method | setMonth Method | setUTCMonth Method
Applies To: Date Object
JScript .NET
getSeconds Method
Returns the seconds value in a Date object using local time.
Remarks
To get the seconds value using Coordinated Universal Time (UTC), use the getUTCSeconds method.
The getSeconds method returns an integer between 0 and 59 indicating the second's value of the indicated Date object. A zero
is returned in two situations. One occurs when the time is less than one second into the current minute. The other occurs when
the time was not stored in the Date object when the object was created. The only way to determine which situation you have is to
also check the hours and minutes for zero values. If they are all zeroes, it is nearly certain that the time was not stored in the Date
object.
Example
The following example illustrates the use of the getSeconds method.
function TimeDemo(){
var d, s = "The current local time is: ";
var c = ":";
d = new Date();
s += d.getHours() + c;
s += d.getMinutes() + c;
s += d.getSeconds() + c;
s += d.getMilliseconds();
return(s);
}
Requirements
Version 1
See Also
getTime Method
Returns the time value in a Date object.
Remarks
The getTime method returns an integer value representing the number of milliseconds between midnight, January 1, 1970 and
the time value in the Date object. The range of dates is approximately 285,616 years from either side of midnight, January 1,
1970. Negative numbers indicate dates prior to 1970.
When doing multiple date and time calculations, it is frequently useful to define variables equal to the number of milliseconds in a
day, hour, or minute. For example:
Example
The following example illustrates the use of the getTime method.
function GetTimeTest(){
var d, s, t;
var MinMilli = 1000 * 60;
var HrMilli = MinMilli * 60;
var DyMilli = HrMilli * 24;
d = new Date();
t = d.getTime();
s = "It's been "
s += Math.round(t / DyMilli) + " days since 1/1/70";
return(s);
}
Requirements
Version 1
See Also
setTime Method
Applies To: Date Object
JScript .NET
getTimezoneOffset Method
Returns the difference in minutes between the time on the host computer and Coordinated Universal Time (UTC).
Remarks
The getTimezoneOffset method returns an integer value representing the number of minutes between the time on the current
machine and UTC. These values are appropriate to the computer the script is executed on. If it is called from a server script, the
return value is appropriate to the server. If it is called from a client script, the return value is appropriate to the client.
This number will be positive if you are behind UTC (for example, Pacific Daylight Time), and negative if you are ahead of UTC (for
example, Japan).
For example, suppose a client in Los Angeles contacts a server in New York City on December 1. getTimezoneOffset returns 480
if executed on the client, or 300 if executed on the server.
Example
The following example illustrates the use of the getTimezoneOffset method.
function TZDemo(){
var d, tz, s = "The current local time is ";
d = new Date();
tz = d.getTimezoneOffset();
if (tz < 0)
s += tz / 60 + " hours before UTC";
else if (tz == 0)
s += "UTC";
else
s += tz / 60 + " hours after UTC";
return(s);
}
Requirements
Version 1
See Also
Methods
Applies To: Date Object
JScript .NET
getUTCDate Method
Returns the date in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the date using local time, use the getDate method.
The return value is an integer between 1 and 31 that represents the date value in the Date object.
Example
The following example illustrates the use of the getUTCDate method.
function UTCDateDemo(){
var d, s = "Today's UTC date is: ";
d = new Date();
s += (d.getUTCMonth() + 1) + "/";
s += d.getUTCDate() + "/";
s += d.getUTCFullYear();
return(s);
}
Requirements
Version 3
See Also
getDate Method | setDate Method | setUTCDate Method
Applies To: Date Object
JScript .NET
getUTCDay Method
Returns the day of the week value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the day of the week using local time, use the getDate method.
The value returned by the getUTCDay method is an integer between 0 and 6 representing the day of the week and corresponds
to a day of the week as follows:
Value Day of the Week
0 Sunday
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday
Example
The following example illustrates the use of the getUTCDay method.
function DateDemo(){
var d, day, x, s = "Today is ";
var x = new Array("Sunday", "Monday", "Tuesday");
x = x.concat("Wednesday","Thursday", "Friday");
x = x.concat("Saturday");
d = new Date();
day = d.getUTCDay();
return(s += x[day] + " in UTC");
}
Requirements
Version 3
See Also
getDay Method
Applies To: Date Object
JScript .NET
getUTCFullYear Method
Returns the year value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the year using local time, use the getFullYear method.
The getUTCFullYear method returns the year as an absolute number. This avoids the year 2000 problem where dates beginning
with January 1, 2000 are confused with those beginning with January 1, 1900.
Example
The following example illustrates the use of the getUTCFullYear method.
function UTCDateDemo(){
var d, s = "Today's UTC date is: ";
d = new Date();
s += (d.getUTCMonth() + 1) + "/";
s += d.getUTCDate() + "/";
s += d.getUTCFullYear();
return(s);
}
Requirements
Version 3
See Also
getFullYear Method | setFullYear Method | setUTCFullYear Method
Applies To: Date Object
JScript .NET
getUTCHours Method
Returns the hours value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the number of hours elapsed since midnight using local time, use the getHours method.
The getUTCHours method returns an integer between 0 and 23 indicating the number of hours since midnight. A zero occurs in
two situations: the time is before 1:00:00 A.M., or a time was not stored in the Date object when the object was created. The only
way to determine which situation you have is to also check the minutes and seconds for zero values. If they are all zeroes, it is
nearly certain that the time was not stored in the Date object.
Example
The following example illustrates the use of the getUTCHours method.
function UTCTimeDemo(){
var d, s = "Current Coordinated Universal Time (UTC) is: ";
var c = ":";
d = new Date();
s += d.getUTCHours() + c;
s += d.getUTCMinutes() + c;
s += d.getUTCSeconds() + c;
s += d.getUTCMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getHours Method | setHours Method | setUTCHours Method
Applies To: Date Object
JScript .NET
getUTCMilliseconds Method
Returns the milliseconds value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the number of milliseconds in local time, use the getMilliseconds method.
The millisecond value returned can range from 0-999.
Example
The following example illustrates the use of the getUTCMilliseconds method.
function UTCTimeDemo(){
var d, s = "Current Coordinated Universal Time (UTC) is: ";
var c = ":";
d = new Date();
s += d.getUTCHours() + c;
s += d.getUTCMinutes() + c;
s += d.getUTCSeconds() + c;
s += d.getUTCMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getMilliseconds Method | setMilliseconds Method | setUTCMilliseconds Method
Applies To: Date Object
JScript .NET
getUTCMinutes Method
Returns the minutes value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the number of minutes stored using local time, use the getMinutes method.
The getUTCMinutes method returns an integer between 0 and 59 equal to the number of minute's value in the Date object. A
zero occurs in two situations: the time is less than one minute after the hour, or a time was not stored in the Date object when the
object was created. The only way to determine which situation you have is to also check the hours and seconds for zero values. If
they are all zeroes, it is nearly certain that the time was not stored in the Date object.
Example
The following example illustrates the use of the getUTCMinutes method.
function UTCTimeDemo()
{
var d, s = "Current Coordinated Universal Time (UTC) is: ";
var c = ":";
d = new Date();
s += d.getUTCHours() + c;
s += d.getUTCMinutes() + c;
s += d.getUTCSeconds() + c;
s += d.getUTCMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getMinutes Method | setMinutes Method | setUTCMinutes Method
Applies To: Date Object
JScript .NET
getUTCMonth Method
Returns the month value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the month in local time, use the getMonth method.
The getUTCMonth method returns an integer between 0 and 11 indicating the month value in the Date object. The integer
returned is not the traditional number used to indicate the month. It is one less. If "Jan 5, 1996 08:47:00.0" is stored in a Date
object, getUTCMonth returns 0.
Example
The following example illustrates the use of the getUTCMonth method.
function UTCDateDemo(){
var d, s = "Today's UTC date is: ";
d = new Date();
s += (d.getUTCMonth() + 1) + "/";
s += d.getUTCDate() + "/";
s += d.getUTCFullYear();
return(s);
}
Requirements
Version 3
See Also
getMonth Method | setMonth Method | setUTCMonth Method
Applies To: Date Object
JScript .NET
getUTCSeconds Method
Returns the seconds value in a Date object using Coordinated Universal Time (UTC).
Remarks
To get the number of seconds in local time, use the getSeconds method.
The getUTCSeconds method returns an integer between 0 and 59 indicating the second's value of the indicated Date object. A
zero occurs in two situations: the time is less than one second into the current minute, or a time was not stored in the Date object
when the object was created. The only way to determine which situation you have is to also check the minutes and hours for zero
values. If they are all zeroes, it is nearly certain that the time was not stored in the Date object.
Example
The following example illustrates the use of the getUTCSeconds method.
function UTCTimeDemo(){
var d, s = "Current Coordinated Universal Time (UTC) is: ";
var c = ":";
d = new Date();
s += d.getUTCHours() + c;
s += d.getUTCMinutes() + c;
s += d.getUTCSeconds() + c;
s += d.getUTCMilliseconds();
return(s);
}
Requirements
Version 3
See Also
getSeconds Method | setSeconds Method | setUTCSeconds Method
Applies To: Date Object
JScript .NET
getVarDate Method
Returns the VT_DATE value in a Date object.
Remarks
The getVarDate method is used when interacting with COM objects, ActiveX® objects or other objects that accept and return
date values in VT_DATE format, such as Visual Basic and VBScript. The actual format is dependent on regional settings and should
not be relied upon within JScript.
Requirements
Version 3
See Also
getDate Method | parse Method
Applies To: Date Object
JScript .NET
getYear Method
Returns the year value in a Date object.
Remarks
This method is obsolete, and is provided for backwards compatibility only. Use the getFullYear method instead.
For the years 1900 though 1999, the year is a 2-digit integer value returned as the difference between the stored year and 1900.
For dates outside that period, the 4-digit year is returned. For example, 1996 is returned as 96, but 1825 and 2025 are returned
as-is.
Note For JScript version 1.0, getYear returns a value that is the result of the subtraction of 1900 from the year value
in the provided Date object, regardless of the value of the year. For example, the year 1899 is returned as -1 and the
year 2000 is returned as 100.
Example
The following example illustrates the use of the getYear method:
function DateDemo(){
var d, s = "Today's date is: ";
d = new Date();
s += (d.getMonth() + 1) + "/";
s += d.getDate() + "/";
s += d.getYear();
return(s);
}
Requirements
Version 1
See Also
getFullYear Method | getUTCFullYear Method | setFullYear Method | setUTCFullYear Method | setYear Method
Applies To: Date Object
JScript .NET
hasOwnProperty Method
Returns a Boolean value indicating whether an object has a property with the specified name.
Arguments
proName
Required. String value of a property name.
Remarks
The hasOwnProperty method returns true if the object has a property of the specified name, false if it does not. This method
does not check if the property exists in the object's prototype chain; the property must be a member of the object itself.
Example
In the following example, all String objects share a common split method.
false
true
Requirements
Version 5.5
See Also
in Operator
Applies To: Object Object
JScript .NET
indexOf Method
Returns the character position where the first occurrence of a substring occurs within a String object.
Arguments
subString
Required. Substring to search for within the String object.
startIndex
Optional. Integer value specifying the index to begin searching within the String object. If omitted, searching starts at the
beginning of the string.
Remarks
The indexOf method returns an integer value indicating the beginning of the substring within the String object. If the substring
is not found, a -1 is returned.
If startIndex is negative, startIndex is treated as zero. If it is larger than the greatest character position index, it is treated as the
largest possible index.
Searching is performed from left to right. Otherwise, this method is identical to lastIndexOf.
Example
function IndexDemo(str2){
var str1 = "BABEBIBOBUBABEBIBOBU"
var s = str1.indexOf(str2);
return(s);
}
Requirements
Version 1
See Also
lastIndexOf Method
Applies To: String Object
JScript .NET
isFinite Method
Returns a Boolean value that indicates if a supplied number is finite.
Arguments
number
Required. A numeric value.
Remarks
The isFinite method returns true if number is any value other than NaN, negative infinity, or positive infinity. In those three
cases, it returns false.
Requirements
Version 3
See Also
isNaN Method
Applies To: Global Object
JScript .NET
isNaN Method
Returns a Boolean value that indicates whether a value is the reserved value NaN (not a number).
Arguments
number
Required. A numeric value.
Remarks
The isNaN function returns true if the value is NaN, and false otherwise. You typically use this function to test return values
from the parseInt and parseFloat methods.
Alternatively, a variable could be compared to itself. If it compares as unequal, it is NaN. This is because NaN is the only value
that is not equal to itself.
Requirements
Version 1
See Also
isFinite Method | NaN Property (Global) | parseFloat Method | parseInt Method
Applies To: Global Object
JScript .NET
isPrototypeOf Method
Returns a Boolean value indicating whether an object exists in the prototype chain of another object.
Arguments
obj
Required. An object whose prototype chain is to be checked.
Remarks
The isPrototypeOf method returns true if obj has the current object in its prototype chain. The prototype chain is used to share
functionality between instances of the same object type. The isPrototypeOf method returns false when obj is not an object or
when the current object does not appear in the prototype chain of the obj.
Example
The following example illustrates the use of the isPrototypeof method.
function test(){
var re = new RegExp(); //Initialize variable.
return (RegExp.prototype.isPrototypeOf(re)); //Return true.
}
Requirements
Version 5.5
See Also
Methods
Applies To: Object Object
JScript .NET
italics Method
Returns a string with HTML <I> tags around text in a string object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
<I>This is a string</I>
Requirements
Version 1
See Also
bold Method
Applies To: String Object
JScript .NET
item (Método)
Devuelve el elemento actual de la colección.
Comentarios
El método item devuelve el elemento actual de un objeto Enumerator. Si la colección está vacía o el elemento actual no está
definido, se devuelve undefined.
Ejemplo
En el siguiente código, el método item se utiliza para devolver un miembro de la colección Drives.
function ShowDriveList(){
var fso, s, n, e, x;
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives);
s = "";
for (; !e.atEnd(); e.moveNext())
{
x = e.item();
s = s + x.DriveLetter;
s += " - ";
if (x.DriveType == 3)
n = x.ShareName;
else if (x.IsReady)
n = x.VolumeName;
else
n = "[Drive not ready]";
s += n + "<br>";
}
return(s);
}
Requisitos
Versión 3
Vea también
atEnd (Método) | moveFirst (Método) | moveNext (Método)
Se aplica a: Enumerator (Objeto)
JScript .NET
Methods (J-R)
A method is a function that is a member of an object. Following are methods whose names begin with letters j through r.
In This Section
join Method
Returns a String object consisting of all the concatenated elements of an array.
lastIndexOf Method
Returns the last occurrence of a substring within a String object.
lbound Method
Returns the lowest index value used in the specified dimension of a VBArray.
link Method
Places an HTML anchor with an HREF attribute around the text in a String object.
localeCompare Method
Returns a value indicating whether two strings are equivalent in the current locale.
log Method
Returns the natural logarithm of a number.
match Method
Returns, as an array, the results of a search on a string using a supplied Regular Expression object.
max Method
Returns the greater of two supplied numeric expressions
min Method
Returns the lesser of two supplied numbers.
moveFirst Method
Resets the current item in the collection to the first item.
moveNext Method
Moves the current item to the next item in the collection.
parse Method
Parses a string containing a date, and returns the number of milliseconds between that date and midnight, January 1, 1970.
parseFloat Method
Returns a floating-point number converted from a string.
parseInt Method
Returns an integer converted from a string.
pop Method
Removes the last element from an array and returns it.
pow Method
Returns the value of a base expression raised to a specified power.
push Method
Appends new elements to an array and returns the new length of the array.
random Method
Returns a pseudorandom number between 0 and 1.
replace Method
Returns a copy of a string with text replaced using a regular expression.
reverse Method
Returns an Array object with the elements reversed.
round Method
Returns a specified numeric expression rounded to the nearest integer.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Methods
Lists the methods, classified alphabetically, available in JScript, and links to each category of methods.
Objects
Explains the concept of objects in JScript, how objects are related to properties and methods, and links to topics that provide
more detail about the objects that JScript supports.
JScript .NET
join Method
Returns a string value consisting of all the elements of an array concatenated together and separated by the specified separator
character.
Arguments
separator
Required. A string that is used to separate one element of an array from the next in the resulting String object. If omitted, the
array elements are separated with a comma.
Remarks
If any element of the array is undefined or null, it is treated as an empty string.
Example
The following example illustrates the use of the join method.
function JoinDemo(){
var a, b;
a = new Array(0,1,2,3,4);
b = a.join("-");
return(b);
}
Requirements
Version 2
See Also
String Object
Applies To: Array Object
JScript .NET
lastIndexOf Method
Returns the index of the last occurrence of a substring within a String object.
Arguments
substring
Required. The substring to search for within the String object.
startindex
Optional. Integer value specifying the index to begin searching within the String object. If omitted, searching begins at the end
of the string.
Remarks
The lastIndexOf method returns an integer value indicating the beginning of the substring within the String object. If the
substring is not found, a -1 is returned.
If startindex is negative, startindex is treated as zero. If it is larger than the greatest character position index, it is treated as the
largest possible index.
Searching is performed right to left. Otherwise, this method is identical to indexOf.
Example
function lastIndexDemo(str2) {
var str1 = "BABEBIBOBUBABEBIBOBU"
var s = str1.lastIndexOf(str2);
return(s);
}
Requirements
Version 1
See Also
indexOf Method
Applies To: String Object
JScript .NET
lbound Method
Returns the lowest index value used in the specified dimension of a VBArray.
Arguments
dimension
Optional. The dimension of the VBArray for which the lower bound index is wanted. If omitted, lbound behaves as if a 1 was
passed.
Remarks
If the VBArray is empty, the lbound method returns undefined. If dimension is greater than the number of dimensions in the
VBArray, or is negative, the method generates a "Subscript out of range" error.
Example
The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is
JScript code that determines the number of dimensions in the safe array and the lower bound of each dimension. Since the safe
array is created in VBScript rather than Visual Basic, the lower bound will always be zero. Both of these parts go into the <HEAD>
section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the other two parts.
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
k = k + 1
Next
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vba){
var i, s;
var a = new VBArray(vba);
for (i = 1; i <= a.dimensions(); i++)
{
s = "The lower bound of dimension ";
s += i + " is ";
s += a.lbound(i)+ ".<BR>";
return(s);
}
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT language="jscript">
document.write(VBArrayTest(CreateVBArray()));
</SCRIPT>
</BODY>
Requirements
Version 3
See Also
dimensions Method | getItem Method | toArray Method | ubound Method
Applies To: VBArray Object
JScript .NET
link Method
Returns as string with an HTML anchor and an HREF attribute around the text in a String object.
Remarks
Call the link method to create a hyperlink out of a String object.
No checking is done to see if the tag has already been applied to the string.
Example
The following is an example of how the method accomplishes this:
Requirements
Version 1
See Also
anchor Method
Applies To: String Object
JScript .NET
localeCompare Method
Returns a value indicating whether two strings are equivalent in the current locale.
Arguments
stringExp
Required. String to compare against the current string object.
Remarks
The localeCompare performs a locale-sensitive string comparison of the current string object and the stringExp and returns -1,
0, or +1, depending on the sort order of the system default locale.
If the current string object sorts before stringExp, localeCompare returns –1; if the current string sorts after stringExp, +1 is
returned. A return value of zero means that the two strings are equivalent.
Requirements
Version 5.5
See Also
ToLocaleString Method
Applies To: String Object
JScript .NET
log Method
Returns the natural logarithm of a number.
Arguments
number
Required. A numeric value.
Remarks
The return value is the natural logarithm of number. The base is e.
Requirements
Version 1
See Also
Methods
Applies To: Math Object
JScript .NET
match Method
Executes a search on a string using a regular expression pattern, and returns an array containing the results of that search.
Arguments
rgExp
Required. An instance of a Regular Expression object containing the regular expression pattern and applicable flags. Can also
be a variable name or string literal containing the regular expression pattern and flags.
Remarks
If the match method does not find a match, it returns null. If it finds a match, match returns an array, and the properties of the
global RegExp object are updated to reflect the results of the match.
The array returned by the match method has three properties, input, index and lastIndex. The input property contains the
entire searched string. The index property contains the position of the matched substring within the complete searched string.
The lastIndex property contains the position following the last character in the last match.
If the global flag (g) is not set, Element zero of the array contains the entire match, while elements 1 – n contain any submatches
that have occurred within the match. This behavior is identical to the behavior of the exec method without the global flag set. If
the global flag is set, elements 0 - n contain all matches that occurred.
Example
The following example illustrates the use of the match method.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return first occurrence of "ain".
}
This example illustrates the use of the match method with the g flag set.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return array containing all four
// occurrences of "ain".
}
The following lines of code illustrate the use of a string literal with the match method.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");
Requirements
Version 3
See Also
exec Method | RegExp Object | replace Method | search Method | test Method
Applies To: String Object
JScript .NET
max Method
Returns the greater of zero or more supplied numeric expressions.
Arguments
number1, ... , numberN
Required. Numeric expressions.
Remarks
If no arguments are provided, the return value is equal to NEGATIVE_INFINITY. If any argument is NaN, the return value is also
NaN.
Requirements
Version 1
See Also
min Method| NEGATIVE_INFINITY Property
Applies To: Math Object
JScript .NET
min Method
Returns the lesser of zero or more supplied numeric expressions.
Arguments
number1, ... , numberN
Required. Numeric expressions.
Remarks
If no arguments are provided, the return value is equal to POSITIVE_INFINITY. If any argument is NaN, the return value is also
NaN.
Requirements
Version 1
See Also
max Method | POSITIVE_INFINITY Property
Applies To: Math Object
JScript .NET
moveFirst Method
Resets the current item in an Enumerator object to the first item.
function moveFirst()
Remarks
If there are no items in the collection, the current item is set to undefined.
Example
In following example, the moveFirst method is used to evaluate members of the Drives collection from the beginning of the list:
function ShowFirstAvailableDrive(){
var fso, s, e, x; //Declare variables.
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives); //Create Enumerator object.
e.moveFirst(); //Move to first drive.
s = ""; //Initialize s.
do
{
x = e.item(); //Test for existence of drive.
if (x.IsReady) //See if it's ready.
{
s = x.DriveLetter + ":"; //Assign 1st drive letter to s.
break;
}
else
if (e.atEnd()) //See if at the end of the collection.
{
s = "No drives are available";
break;
}
e.moveNext(); //Move to the next drive.
}
while (!e.atEnd()); //Do while not at collection end.
return(s); //Return list of available drives.
}
Requirements
Version 3
See Also
atEnd Method | item Method | moveNext Method
Applies To: Enumerator Object
JScript .NET
moveNext Method
Moves the current item to the next item in the Enumerator object.
function moveNext()
Remarks
If the enumerator is at the end of the collection or the collection is empty, the current item is set to undefined.
In following example, the moveNext method is used to move to the next drive in the Drives collection:
function ShowDriveList(){
var fso, s, n, e, x; //Declare variables.
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives); //Create Enumerator object.
s = ""; //Initialize s.
for (; !e.atEnd(); e.moveNext())
{
x = e.item();
s = s + x.DriveLetter; //Add drive letter
s += " - "; //Add "-" character.
if (x.DriveType == 3)
n = x.ShareName; //Add share name.
else if (x.IsReady)
n = x.VolumeName; //Add volume name.
else
n = "[Drive not ready]"; //Indicate drive not ready.
s += n + "\n";
}
return(s); //Return drive status.
}
Requirements
Version 3
See Also
atEnd Method | item Method | moveFirst Method
Applies To: Enumerator Object
JScript .NET
parse Method
Parses a string containing a date, and returns the number of milliseconds between that date and midnight, January 1, 1970.
Arguments
dateVal
Required. Either a string containing a date in a format such as "Jan 5, 1996 08:47:00" or a VT_DATE value retrieved from an
ActiveX® object or other object.
Remarks
The parse method returns an integer value representing the number of milliseconds between midnight, January 1, 1970 and the
date supplied in dateVal.
The parse method is a static method of the Date object. Because it is a static method, it is invoked as shown in the following
example, rather than invoked as a method of a created Date object.
The following rules govern what the parse method can successfully parse:
Short dates can use either a "/" or "-" date separator, but must follow the month/day/year format, for example "7/20/96".
Long dates of the form "July 10 1995" can be given with the year, month, and day in any order, and the year in 2-digit or 4-
digit form. If you use the 2-digit form, the year must be greater than or equal to 70.
Any text inside parentheses is treated as a comment. These parentheses may be nested.
Both commas and spaces are treated as delimiters. Multiple delimiters are permitted.
Month and day names must have two or more characters. Two character names that are not unique are resolved as the last
match. For example, "Ju" is resolved as July, not June.
The stated day of the week is ignored if it is incorrect given the remainder of the supplied date. For example, "Tuesday
November 9 1996" is accepted and parsed even though that date actually falls on a Friday. The resulting Date object
contains "Friday November 9 1996".
JScript handles all standard time zones, as well as Universal Coordinated Time (UTC) and Greenwich Mean Time (GMT).
Colons separate hours, minutes, and seconds, although all need not be specified. "10:", "10:11", and "10:11:12" are all valid.
If the 24-hour clock is used, it is an error to specify "PM" for times later than 12 noon. For example, "23:15 PM" is an error.
A string containing an invalid date is an error. For example, a string containing two years or two months is an error.
Example
The following example illustrates the use of the parse method. Provide the function with a date and the function will return the
difference between the date provided and 1/1/1970:
function GetTimeTest(testdate){
var s, t; //Declare variables.
var MinMilli = 1000 * 60; //Initialize variables.
var HrMilli = MinMilli * 60;
var DyMilli = HrMilli * 24;
t = Date.parse(testdate); //Parse testdate.
s = "There are " //Create return string.
s += Math.round(Math.abs(t / DyMilli)) + " days "
s += "between " + testdate + " and 1/1/70";
return(s); //Return results.
}
Requirements
Version 1
See Also
Methods
Applies To: Date Object
JScript .NET
parseFloat Method
Returns a floating-point number converted from a string.
Arguments
numString
Required. A string that represents a floating-point number.
Remarks
The parseFloat method returns a numerical value equal to the number contained in numString. If no prefix of numString can be
successfully parsed into a floating-point number, NaN (not a number) is returned.
You can test for NaN using the isNaN method.
Example
In following example, the parseFloat method is used to convert two strings to numbers.
Requirements
Version 1
See Also
isNaN Method | parseInt Method | String Object
Applies To: Global Object
JScript .NET
parseInt Method
Returns an integer converted from a string.
Arguments
numString
Required. A string to convert into a number.
radix
Optional. A value between 2 and 36 indicating the base of the number contained in numString. If not supplied, strings with a
prefix of '0x' are considered hexadecimal and strings with a prefix of '0' are considered octal. All other strings are considered
decimal.
Remarks
The parseInt method returns a whole number value equal to the number contained in numString. If no prefix of numString can
be successfully parsed into an integer, NaN (not a number) is returned.
You can test for NaN using the isNaN method.
Example
In following example, the parseInt method is used to convert two strings to numbers.
Requirements
Version 1
See Also
isNaN Method | parseFloat Method | String Object | valueOf Method
Applies To: Global Object
JScript .NET
pop Method
Removes the last element from an array and returns it.
Remarks
If the array is empty, undefined is returned.
Requirements
Version 5.5
See Also
push Method
Applies To: Array Object
JScript .NET
pow Method
Returns the value of a base expression taken to a specified power.
Arguments
base
Required. The base value of the expression.
exponent
Required. The exponent value of the expression.
Remarks
Requirements
Version 1
See Also
Methods
Applies To: Math Object
JScript .NET
push Method
Appends new elements to an array, and returns the new length of the array.
Arguments
item1, ... , itemN
Optional. New elements of the Array.
Remarks
The push method appends elements in the order in which they appear. If one of the arguments is an array, it is added as a single
element. Use the concat method to join the elements from two or more arrays.
Requirements
Version 5.5
See Also
concat Method (Array) | pop Method
Applies To: Array Object
JScript .NET
random Method
Returns a pseudorandom number between 0 and 1.
Remarks
The pseudorandom number generated is from 0 (inclusive) to 1 (exclusive), that is, the returned number can be zero, but it will
always be less than one. The random number generator is seeded automatically when JScript is first loaded.
Requirements
Version 1
See Also
Methods
Applies To: Math Object
JScript .NET
replace Method
Returns a copy of a string with text replaced using a regular expression or search string.
Arguments
rgExp
Required. An instance of a Regular Expression object containing the regular expression pattern and applicable flags. Can also
be a String object or literal. If rgExp is not an instance of a Regular Expression object, it is converted to a string, and an exact
search is made for the results; no attempt is made to convert the string into a regular expression.
replaceText
Required. A String object or string literal containing the text to replace for every successful match of rgExp in the current string
object. In JScript 5.5 or later, the replaceText argument can also be a function that returns the replacement text.
Remarks
The result of the replace method is a copy of the current string object after the specified replacements have been made.
Any of the following match variables can be used to identify the most recent match and the string from which it came. The match
variables can be used in text replacement where the replacement string has to be determined dynamically.
Characters Meaning
$$ $ (JScript 5.5 or later)
$& Specifies that portion of the current string object that the entire pattern matched. (JScript 5.5 or later)
$` Specifies that portion of the current string object that precedes the match described by $&. (JScript 5.5
or later)
$' Specifies that portion of the current string object that follows the match described by $&. (JScript 5.5 o
r later)
$n The nth captured submatch, where n is a single decimal digit from 1 through 9. (JScript 5.5 or later)
$nn The nnth captured submatch, where nn is a two-digit decimal number from 01 through 99. (JScript 5.5
or later)
If replaceText is a function, for each matched substring the function is called with the following m + 3 arguments where m is the
number of left capturing parentheses in the rgExp. The first argument is the substring that matched. The next m arguments are all
of the captures that resulted from the search. Argument m + 2 is the offset within the current string object where the match
occurred, and argument m + 3 is the current string object. The result is the string value that results from replacing each matched
substring with the corresponding return value of the function call.
The replace method updates the properties of the global RegExp object.
Example
The following example illustrates the use of the replace method to replace the first instance of the word "The" with the word "A."
Note that it replaces only the first instance of "The" because the pattern is case-sensitive.
function ReplaceDemo(){
var r, re; //Declare variables.
var ss = "The man hit the ball with the bat.\n";
ss += "while the fielder caught the ball with the glove.";
re = /The/g; //Create regular expression pattern.
r = ss.replace(re, "A"); //Replace "The" with "A".
return(r); //Return string with replacement made.
}
In addition, the replace method can also replace subexpressions in the pattern. The following example swaps each pair of words
in the string.
function ReplaceDemo(){
var r, re; //Declare variables.
var ss = "The rain in Spain falls mainly in the plain.";
re = /(\S+)(\s+)(\S+)/g; //Create regular expression pattern.
r = ss.replace(re, "$3$2$1"); //Swap each pair of words.
return(r); //Return resulting string.
}
The following example, which works in JScript 5.5 and later, performs a Fahrenheit to Celsius conversion, illustrates using a
function as replaceText. To see how this function works, pass in a string containing a number followed immediately by an "F" (for
example, "Water boils at 212").
function f2c(s) {
var test = /(\d+(\.\d*)?)F\b/g; //Initialize pattern.
return(s.replace
(test,
function($0,$1,$2) {
return((($1-32) * 5/9) + "C");
}
)
);
}
document.write(f2c("Water freezes at 32F and boils at 212F."));
Requirements
Version 1
See Also
exec Method | match Method | RegExp Object | search Method | test Method
Applies To: String Object
JScript .NET
reverse Method
Returns an Array object with the elements reversed.
Remarks
The reverse method reverses the elements of an Array object in place. It does not create a new Array object during execution.
If the array is not contiguous, the reverse method creates elements in the array that fill the gaps in the array. Each of these
created elements has the value undefined.
Example
The following example illustrates the use of the reverse method.
function ReverseDemo(){
var a, l; //Declare variables.
a = new Array(0,1,2,3,4); //Create an array and populate it.
l = a.reverse(); //Reverse the contents of the array.
return(l); //Return the resulting array.
}
Requirements
Version 2
See Also
Methods
Applies To: Array Object
JScript .NET
round Method
Returns a supplied numeric expression rounded to the nearest integer.
Arguments
number
Required. A numeric expression.
Remarks
If the decimal portion of number is 0.5 or greater, the return value is equal to the smallest integer greater than number.
Otherwise, round returns the largest integer less than or equal to number.
Requirements
Version 1
See Also
Methods
Applies To: Math Object
JScript .NET
Methods (S)
A method is a function that is a member of an object. Following are methods whose names begin with the letter s.
In This Section
search Method
Returns the position of the first substring match in a regular expression search.
setDate Method
Sets the numeric date of the Date object using local time.
setFullYear Method
Sets the year value in the Date object using local time.
setHours Method
Sets the hour value in the Date object using local time.
setMilliseconds Method
Sets the milliseconds value in the Date object using local time.
setMinutes Method
Sets the minutes value in the Date object using local time.
setMonth Method
Sets the month value in the Date object using local time.
setSeconds Method
Sets the seconds value in the Date object using local time.
setTime Method
Sets the date and time value in the Date object.
setUTCDate Method
Sets the numeric date in the Date object using Coordinated Universal Time (UTC).
setUTCFullYear Method
Sets the year value in the Date object using Coordinated Universal Time (UTC).
setUTCHours Method
Sets the hours value in the Date object using Coordinated Universal Time (UTC).
setUTCMilliseconds Method
Sets the milliseconds value in the Date object using Coordinated Universal Time (UTC).
setUTCMinutes Method
Sets the minutes value in the Date object using Coordinated Universal Time (UTC).
setUTCMonth Method
Sets the month value in the Date object using Coordinated Universal Time (UTC).
setUTCSeconds Method
Sets the seconds value in the Date object using Coordinated Universal Time (UTC).
setYear Method
Sets the year value in the Date object.
shift Method
Removes the first element from an array and returns it.
sin Method
Returns the sine of a number.
slice Method (Array)
Returns a section of an array.
slice Method (String)
Returns a section of a string.
small Method
Places HTML <SMALL> tags around text in a String object.
sort Method
Returns an Array object with the elements sorted.
splice Method
Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements.
split Method
Returns the array of strings that results when a string is separated into substrings.
sqrt Method
Returns the square root of a number.
strike Method
Places HTML <STRIKE> tags around text in a String object.
sub Method
Places HTML <SUB> tags around text in a String object.
substr Method
Returns a substring beginning at a specified location and having a specified length.
substring Method
Returns the substring at a specified location within a String object.
sup Method
Places HTML <SUP> tags around text in a String object.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Methods
Lists the methods, classified alphabetically, available in JScript, and links to each category of methods.
Objects
Explains the concept of objects in JScript, how objects are related to properties and methods, and links to topics that provide
more detail about the objects that JScript supports.
JScript .NET
search Method
Returns the position of the first substring match in a regular expression search.
Arguments
rgExp
Required. An instance of a Regular Expression object containing the regular expression pattern and applicable flags.
Remarks
The search method indicates whether a match is found. If a match is found, the search method returns an integer value that
specifies the offset from the beginning of the string where the match occurred. If no match is found, it returns -1.
Example
The following example illustrates the use of the search method.
function SearchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain.";
re = /falls/i; //Create regular expression pattern.
r = s.search(re); //Search the string.
return(r); //Return the position of the string.
}
Requirements
Version 3
See Also
exec Method | match Method | Regular Expression Object | Regular Expression Syntax | replace Method | test Method
Applies To: String Object
JScript .NET
setDate Method
Sets the date of a Date object in the local time zone.
Arguments
numDate
Required. A numeric value equal to the numeric date.
Remarks
To set the date value using Coordinated Universal Time (UTC), use the setUTCDate method.
If the value of numDate is greater than the number of days in the month stored in the Date object or is a negative number, the
date is set to a date equal to numDate minus the number of days in the stored month. For example, if the stored date is January 5,
1996, and setDate(32) is called, the date changes to February 1, 1996. Negative numbers behave similarly.
Example
The following example illustrates the use of the setDate method.
function SetDateDemo(newdate){
var d, s; //Declare variables.
d = new Date(); //Create date object.
d.setDate(newdate); //Set date to newdate.
s = "Current setting is ";
s += d.toLocaleString();
return(s); //Return newly set date.
}
Requirements
Version 3
See Also
getDate Method | getUTCDate Method | setUTCDate Method
Applies To: Date Object
JScript .NET
setFullYear Method
Sets the year value in the Date object using local time.
Arguments
numYear
Required. A numeric value equal to the year.
numMonth
Optional. A numeric value equal to the month. Must be supplied if numDate is supplied.
numDate
Optional. A numeric value equal to the date.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify the
optional argument. For example, if the numMonth argument is optional, but not specified, JScript uses the value returned from
the getMonth method.
In addition, if the value of an argument is greater than its range or is a negative number, other stored values are modified
accordingly.
To set the year using Coordinated Universal Time (UTC), use the setUTCFullYear method.
The range of years supported in the date object is approximately 285,616 years from either side of 1970.
Example
The following example illustrates the use of the setFullYear method:
function SetFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setFullYear(newyear); //Set year.
s = "Current setting is ";
s += d.toLocaleString();
return(s); //Return new date setting.
}
Requirements
Version 3
See Also
getFullYear Method | getUTCFullYear Method | setUTCFullYear Method
Applies To: Date Object
JScript .NET
setHours Method
Sets the hour value in the Date object using local time.
Arguments
numHours
Required. A numeric value equal to the hour's value.
numMin
Optional. A numeric value equal to the minute's value.
numSec
Optional. A numeric value equal to the second's value.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numMinutes argument is optional, but not specified, JScript uses the value returned from
the getMinutes method.
To set the hours value using Coordinated Universal Time (UTC), use the setUTCHours method.
If the value of an argument is greater than its range or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00", and setHours(30) is called, the date is changed to "Jan 6, 1996 06:00:00."
Negative numbers have a similar behavior.
Example
The following example illustrates the use of the setHours method.
Requirements
Version 3
See Also
getHours Method | getUTCHours Method | setUTCHours Method
Applies To: Date Object
JScript .NET
setMilliseconds Method
Sets the milliseconds value in the Date object using local time.
Arguments
numMilli
Required. A numeric value equal to the millisecond value.
Remarks
To set the milliseconds value using Coordinated Universal Time (UTC), use the setUTCMilliseconds method.
If the value of numMilli is greater than 999 or is a negative number, the stored number of seconds (and minutes, hours, and so
forth if necessary) is incremented an appropriate amount.
Example
The following example illustrates the use of the setMilliseconds method.
function SetMSecDemo(nmsec){
var d, s; //Declare variables.
var sep = ":"; //Initialize separator.
d = new Date(); //Create Date object.
d.setMilliseconds(nmsec); //Set milliseconds.
s = "Current setting is ";
s += d.toLocaleString() + sep + d.getMilliseconds();
return(s); //Return new date setting.
}
Requirements
Version 3
See Also
getMilliseconds Method | getUTCMilliseconds Method | setUTCMilliseconds Method
Applies To: Date Object
JScript .NET
setMinutes Method
Sets the minutes value in the Date object using local time.
Arguments
numMinutes
Required. A numeric value equal to the minute's value.
numSeconds
Optional. A numeric value equal to the seconds value. Must be supplied if the numMilli argument is used.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numSeconds argument is optional, but not specified, JScript uses the value returned from
the getSeconds method.
To set the minutes value using Coordinated Universal Time (UTC), use the setUTCMinutes method.
If the value of an argument is greater than its range or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00" and setMinutes(90) is called, the date is changed to "Jan 5, 1996 01:30:00."
Negative numbers have a similar behavior.
Example
The following example illustrates the use of the setMinutes method.
Requirements
Version 1
See Also
getMinutes Method | getUTCMinutes Method | setUTCMinutes Method
Applies To: Date Object
JScript .NET
setMonth Method
Sets the month value in the Date object using local time.
Arguments
numMonth
Required. A numeric value equal to the month.
dateVal
Optional. A numeric value representing the date. If not supplied, the value from a call to the getDate method is used.
Remarks
To set the month value using Coordinated Universal Time (UTC), use the setUTCMonth method.
If the value of numMonth is greater than 11 (January is month 0) or is a negative number, the stored year is modified accordingly.
For example, if the stored date is "Jan 5, 1996" and setMonth(14) is called, the date is changed to "Mar 5, 1997."
Example
The following example illustrates the use of the setMonth method.
function SetMonthDemo(newmonth){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setMonth(newmonth); //Set month.
s = "Current setting is ";
s += d.toLocaleString();
return(s); //Return new setting.
}
Requirements
Version 1
See Also
getMonth Method | getUTCMonth Method | setUTCMonth Method
Applies To: Date Object
JScript .NET
setSeconds Method
Sets the seconds value in the Date object using local time.
Arguments
numSeconds
Required. A numeric value equal to the seconds value.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numMilli argument is optional, but not specified, JScript uses the value returned from the
getMilliseconds method.
To set the seconds value using Coordinated Universal Time (UTC), use the setUTCSeconds method.
If the value of an argument is greater than its range or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00" and setSeconds(150) is called, the date is changed to "Jan 5, 1996 00:02:30."
Example
Requirements
Version 1
See Also
getSeconds Method | getUTCSeconds Method | setUTCSeconds Method
Applies To: Date Object
JScript .NET
setTime Method
Sets the date and time value in the Date object.
Arguments
milliseconds
Required. A numeric value representing the number of elapsed milliseconds since midnight, January 1, 1970 UTC.
Remarks
If milliseconds is negative, it indicates a date before 1970. The range of available dates is approximately 285,616 years from either
side of 1970.
Setting the date and time with the setTime method is independent of the time zone.
Example
The following example illustrates the use of the setTime method.
function SetTimeTest(newtime){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setTime(newtime); //Set time.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}
Requirements
Version 1
See Also
getTime Method
Applies To: Date Object
JScript .NET
setUTCDate Method
Sets the numeric date in the Date object using Coordinated Universal Time (UTC).
Arguments
numDate
Required. A numeric value equal to the numeric date.
Remarks
To set the date using local time, use the setDate method.
If the value of numDate is greater than the number of days in the month stored in the Date object or is a negative number, the
date is set to a date equal to numDate minus the number of days in the stored month. For example, if the stored date is January 5,
1996, and setUTCDate(32) is called, the date changes to February 1, 1996. Negative numbers have a similar behavior.
Example
The following example illustrates the use of the setUTCDate method.
function SetUTCDateDemo(newdate){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCDate(newdate); //Set UTC date.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}
Requirements
Version 3
See Also
getDate Method | getUTCDate Method | setDate Method
Applies To: Date Object
JScript .NET
setUTCFullYear Method
Sets the year value in the Date object using Coordinated Universal Time (UTC).
Arguments
numYear
Required. A numeric value equal to the year.
numMonth
Optional. A numeric value equal to the month.
numDate
Optional. A numeric value equal to the date.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numMonth argument is optional, but not specified, JScript uses the value returned from
the getUTCMonth method.
In addition, if the value of an argument is greater that its range or is a negative number, other stored values are modified
accordingly.
To set the year using local time, use the setFullYear method.
The range of years supported in the Date object is approximately 285,616 years from either side of 1970.
Example
The following example illustrates the use of the setUTCFullYear method.
function SetUTCFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCFullYear(newyear); //Set UTC full year.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}
Requirements
Version 3
See Also
getFullYear Method | getUTCFullYear Method | setFullYear Method
Applies To: Date Object
JScript .NET
setUTCHours Method
Sets the hours value in the Date object using Coordinated Universal Time (UTC).
Arguments
numHours
Required. A numeric value equal to the hours value.
numMin
Optional. A numeric value equal to the minutes value.
numSec
Optional. A numeric value equal to the seconds value.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numMin argument is optional, but not specified, JScript uses the value returned from the
getUTCMinutes method.
To set the hours value using local time, use the setHours method.
If the value of an argument is greater than its range, or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00.00", and setUTCHours(30) is called, the date is changed to "Jan 6, 1996
06:00:00.00."
Example
The following example illustrates the use of the setUTCHours method.
Requirements
Version 3
See Also
getHours Method | getUTCHours Method | setHours Method
Applies To: Date Object
JScript .NET
setUTCMilliseconds (Método)
Establece, utilizando el horario universal coordinado (UTC), el valor "milisegundos" (Milliseconds) del objeto Date.
Argumentos
numMilli
Necesario. Valor numérico igual al valor de milisegundos.
Comentarios
Para establecer el valor de los milisegundos mediante la hora local, utilice el método setMilliseconds.
Si el valor de numMilli es mayor que 999 o es un número negativo, el número almacenado de segundos (y minutos, horas, etc.
según sea necesario) se incrementa en la cantidad apropiada.
Ejemplo
El siguiente ejemplo muestra el uso del método setUTCMilliSeconds.
function SetUTCMSecDemo(nmsec){
var d, s; //Declare variables.
var sep = ":"; //Initialize separator.
d = new Date(); //Create Date object.
d.setUTCMilliseconds(nmsec); //Set UTC milliseconds.
s = "Current setting is ";
s += d.toUTCString() + sep + d.getUTCMilliseconds();
return(s); //Return new setting.
}
Requisitos
Versión 3
Vea también
getMilliseconds (Método) | getUTCMilliseconds (Método) | setMilliseconds (Método)
Se aplica a: Date (Objeto)
JScript .NET
setUTCMinutes Method
Sets the minutes value in the Date object using Coordinated Universal Time (UTC).
Arguments
numMinutes
Required. A numeric value equal to the minutes value.
numSeconds
Optional. A numeric value equal to the seconds value. Must be supplied if numMilli is used.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numSeconds argument is optional, but not specified, JScript uses the value returned from
the getUTCSeconds method.
To modify the minutes value using local time, use the setMinutes method.
If the value of an argument is greater than its range, or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00.00", and setUTCMinutes(70) is called, the date is changed to "Jan 5, 1996
01:10:00.00."
Example
The following example illustrates the use of the setUTCMinutes method:
Requirements
Version 3
See Also
getMinutes Method | getUTCMinutes Method | setMinutes Method
Applies To: Date Object
JScript .NET
setUTCMonth Method
Sets the month value in the Date object using Coordinated Universal Time (UTC).
Arguments
numMonth
Required. A numeric value equal to the month.
dateVal
Optional. A numeric value representing the date. If not supplied, the value from a call to the getUTCDate method is used.
Remarks
To set the month value using local time, use the setMonth method.
If the value of numMonth is greater than 11 (January is month 0), or is a negative number, the stored year is incremented or
decremented appropriately. For example, if the stored date is "Jan 5, 1996 00:00:00.00", and setUTCMonth(14) is called, the date
is changed to "Mar 5, 1997 00:00:00.00."
Example
The following example illustrates the use of the setUTCMonth method.
function SetUTCMonthDemo(newmonth){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCMonth(newmonth); //Set UTC month.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}
Requirements
Version 3
See Also
getMonth Method | getUTCMonth Method | setMonth Method
Applies To: Date Object
JScript .NET
setUTCSeconds Method
Sets the seconds value in the Date object using Coordinated Universal Time (UTC).
Arguments
numSeconds
Required. A numeric value equal to the seconds value.
numMilli
Optional. A numeric value equal to the milliseconds value.
Remarks
All set methods taking optional arguments use the value returned from corresponding get methods, if you do not specify an
optional argument. For example, if the numMilli argument is optional, but not specified, JScript uses the value returned from the
getUTCMilliseconds method.
To set the seconds value using local time, use the setSeconds method.
If the value of an argument is greater than its range or is a negative number, other stored values are modified accordingly. For
example, if the stored date is "Jan 5, 1996 00:00:00.00" and setSeconds(150) is called, the date is changed to "Jan 5, 1996
00:02:30.00."
Example
The following example illustrates the use of the setSeconds method.
Requirements
Version 3
See Also
getSeconds Method | getUTCSeconds Method | setSeconds Method
Applies To: Date Object
JScript .NET
setYear Method
Sets the year value in the Date object.
Arguments
numYear
Required. A numeric value equal to the year minus 1900.
Remarks
This method is obsolete, and is maintained for backwards compatibility only. Use the setFullYear method instead.
To set the year of a Date object to 1997, call setYear(97). To set the year to 2010, call setYear(2010). Finally, to set the year to a
year in the range 0-99, use the setFullYear method.
Note For JScript version 1.0, setYear uses a value that is the result of the addition of 1900 to the year value
provided by numYear, regardless of the value of the year. For example, to set the year to 1899 numYear is -1 and to
set the year 2000 numYear is 100.
Requirements
Version 1
See Also
getFullYear Method | getUTCFullYear Method | getYear Method | setFullYear Method | setUTCFullYear Method
Applies To: Date Object
JScript .NET
shift Method
Removes the first element from an array and returns that element.
Remarks
The shift method removes the first element from an array and returns it.
Requirements
Version 5.5
See Also
unshift Method
Applies To: Array Object
JScript .NET
sin Method
Returns the sine of a number.
Arguments
number
Required. A numeric expression for which the sine is calculated.
Remarks
The return value is the sine of the numeric argument.
Requirements
Version 1
See Also
acos Method | asin Method | atan Method | cos Method | tan Method
Applies To: Math Object
JScript .NET
Arguments
start
Required. The index to the beginning of the specified portion of the array.
end
Optional. The index to the end of the specified portion of the array.
Remarks
The slice method returns an Array object containing the specified portion of the array.
The slice method copies up to, but not including, the element indicated by end. If start is negative, it is treated as length + start
where length is the length of the array. If end is negative, it is treated as length + end where length is the length of the array. If
end is omitted, extraction continues to the end of the array. If end occurs before start, no elements are copied to the new array.
Example
In the following example, all but the last element of myArray is copied into newArray:
Requirements
Version 3
See Also
slice Method (String) | String Object
Applies To: Array Object
JScript .NET
Arguments
start
Required. The index to the beginning of the specified portion of the string.
end
Optional. The index to the end of the specified portion of the string.
Remarks
The slice method returns a String object containing the specified portion of the string.
The slice method copies up to, but not including, the element indicated by end. If start is negative, it is treated as length + start
where length is the length of the string. If end is negative, it is treated as length + end where length is the length of the string. If
end is omitted, extraction continues to the end of the string. If end occurs before start, no characters are copied to the new string.
Example
In the following example, the first call to the slice method returns a string that contains the first five characters of str. The second
call to the slice method returns a string that contains the last five characters of str.
Requirements
Version 3
See Also
Array Object | slice Method (Array)
Applies To: String Object
JScript .NET
small Method
Returns a string with HTML <SMALL> tags around the text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
<SMALL>This is a string</SMALL>
Requirements
Version 1
See Also
big Method
Applies To: String Object
JScript .NET
sort Method
Returns an Array object with the elements sorted.
Arguments
sortFunction
Optional. Name of the function used to determine the order of the elements.
Remarks
The sort method sorts the Array object in place; no new Array object is created during execution.
If you supply a function in the sortFunction argument, it must return one of the following values:
A negative value if the first argument passed is less than the second argument.
Zero if the two arguments are equivalent.
A positive value if the first argument is greater than the second argument.
If the sortFunction argument is omitted, the elements are sorted in ascending, ASCII character order.
Example
The following example illustrates the use of the sort method.
function SortDemo(){
var a, l; //Declare variables.
a = new Array("X" ,"y" ,"d", "Z", "v","m","r");
l = a.sort(); //Sort the array.
return(l); //Return sorted array.
}
Requirements
Version 2
See Also
Objects
Applies To: Array Object
JScript .NET
splice Method
Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements. Returns
the elements removed from the array.
function splice(start : Number, deleteCount : Number [, item1 : Object [, ... [, itemN : Obje
ct]]]]) : Array
Arguments
start
Required. The zero-based location in the array from which to start removing elements.
deleteCount
Required. The number of elements to remove.
item1, ... , itemN
Optional. Elements to insert into the array in place of the deleted elements.
Remarks
The splice method modifies the array by removing the specified number of elements from position start and inserting new
elements. The deleted elements are returned as a new array object.
Requirements
Version 5.5
See Also
slice Method (Array)
Applies To: Array Object
JScript .NET
split Method
Returns the array of strings that results when a string is separated into substrings.
Arguments
separator
Optional. A string or an instance of a Regular Expression object identifying one or more characters to use in separating the
string. If omitted, a single-element array containing the entire string is returned.
limit
Optional. A value used to limit the number of elements returned in the array.
Remarks
The result of the split method is an array of strings split at each point where separator occurs in the string. The separator is not
returned as part of any array element.
Example
The following example illustrates the use of the split method.
function SplitDemo(){
var s, ss;
var s = "The rain in Spain falls mainly in the plain.";
// Split at each space character.
ss = s.split(" ");
return(ss);
}
Requirements
Version 3
See Also
concat Method (String) | RegExp Object | Regular Expression Object | Regular Expression Syntax
Applies To: String Object
JScript .NET
sqrt Method
Returns the square root of a number.
Arguments
number
Required. A numeric expression for which the square root is calculated.
Remarks
If number is negative, the return value is NaN.
Requirements
Version 1
See Also
SQRT1_2 Property | SQRT2 Property
Applies To: Math Object
JScript .NET
strike Method
Returns a string with HTML <STRIKE> tags placed around text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
Requirements
Version 1
See Also
Methods
Applies To: String Object
JScript .NET
sub Method
Returns as string with HTML <SUB> tags placed around text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
Requirements
Version 1
See Also
sup Method
Applies To: String Object
JScript .NET
substr Method
Returns a substring beginning at a specified location and having a specified length.
Arguments
start
Required. The starting position of the desired substring. The index of the first character in the string is zero.
length
Optional. The number of characters to include in the returned substring.
Remarks
If length is zero or negative, an empty string is returned. If not specified, the substring continues to the end of the string.
Example
The following example illustrates the use of the substr method.
function SubstrDemo(){
var s, ss; //Declare variables.
var s = "The rain in Spain falls mainly in the plain.";
ss = s.substr(12, 5); //Get substring.
return(ss); // Returns "Spain".
}
Requirements
Version 3
See Also
substring Method
Applies To: String Object
JScript .NET
substring Method
Returns the substring at the specified location within a String object.
Arguments
start
Required. The zero-based index integer indicating the beginning of the substring.
end
Required. The zero-based index integer indicating the end of the substring.
Remarks
The substring method returns a string containing the substring from start up to, but not including, end.
The substring method uses the lower value of start and end as the beginning point of the substring. For example,
strvar.substring(0, 3) and strvar.substring(3, 0) return the same substring.
If either start or end is NaN or negative, it is replaced with zero.
The length of the substring is equal to the absolute value of the difference between start and end. For example, the length of the
substring returned in strvar.substring(0, 3) and strvar.substring(3, 0) is three.
Example
The following example illustrates the use of the substring method.
function SubstringDemo(){
var ss; //Declare variables.
var s = "The rain in Spain falls mainly in the plain..";
ss = s.substring(12, 17); //Get substring.
return(ss); //Return substring.
}
Requirements
Version 1
See Also
substr Method
Applies To: String Object
JScript .NET
sup Method
Returns as string with HTML <SUP> tags placed around text in a String object.
Remarks
No checking is done to see if the tag has already been applied to the string.
Example
Requirements
Version 1
See Also
sub Method
Applies To: String Object
JScript .NET
Methods (T-Z)
A method is a function that is a member of an object. Following are methods whose names begin with letters t through z.
In This Section
tan Method
Returns the tangent of a number.
test Method
Returns a Boolean value that indicates whether or not a pattern exists in a searched string.
toArray Method
Returns a standard JScript array converted from a VBArray.
toDateString Method
Returns a date as a string value.
toExponential Method
Returns a string containing a number represented in exponential notation.
toFixed Method
Returns a string representing a number in fixed-point notation.
toGMTString Method
Returns a date converted to a string using Greenwich Mean Time (GMT).
toLocaleDateString Method
Returns a date as a string value appropriate to the host environment's current locale.
toLocaleLowerCase Method
Returns a string where all alphabetic characters have been converted to lowercase, taking into account the host environment's
current locale.
toLocaleString Method
Returns a date converted to a string using the current locale.
toLocaleTimeString Method
Returns a time as a string value appropriate to the host environment's current locale.
toLocaleUpperCase Method
Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's
current locale.
toLowerCase Method
Returns a string where all alphabetic characters have been converted to lowercase.
toPrecision Method
Returns a string containing a number represented either in exponential or fixed-point notation with a specified number of
digits.
toString Method
Returns a string representation of an object.
toTimeString Method
Returns a time as a string value.
toUpperCase Method
Returns a string where all alphabetic characters have been converted to uppercase.
toUTCString Method
Returns a date converted to a string using Coordinated Universal Time (UTC).
ubound Method
Returns the highest index value used in the specified dimension of the VBArray.
unescape Method
Decodes String objects encoded with the escape method.
unshift Method
Returns an array with specified elements inserted at the beginning.
UTC Method
Returns the number of milliseconds between midnight, January 1, 1970 Coordinated Universal Time (UTC) (or GMT) and the
supplied date.
valueOf Method
Returns the primitive value of the specified object.
Related Sections
JScript Reference
Lists elements that comprise JScript Language Reference and links to topics that explain the details behind the proper use of
language elements.
Methods
Lists the methods, classified alphabetically, available in JScript, and links to each category of methods.
Objects
Explains the concept of objects in JScript, how objects are related to properties and methods, and links to topics that provide
more detail about the objects that JScript supports.
JScript .NET
tan Method
Returns the tangent of a number.
Arguments
number
Required. A numeric expression for which the tangent is calculated.
Remarks
The return value is the tangent of number.
Requirements
Version 1
See Also
acos Method | asin Method | atan Method | atan2 Method | cos Method | sin Method
Applies To: Math Object
JScript .NET
test Method
Returns a Boolean value that indicates whether a regular expression pattern exists in a searched string.
Arguments
str
Required. The string on which to perform the search.
Remarks
The test method checks to see if a pattern exists within a string and returns true if so, and false otherwise. If a match is found, the
properties of the global RegExp object are updated to reflect the results of the match.
If the global flag is set for a regular expression, test searches the string beginning at the position indicated by the value of
lastIndex. If the global flag is not set, test ignores the value of lastIndex and searches from the beginning of the string.
Example
The following example illustrates the use of the test method. To use this example, pass the function a regular expression pattern
and a string. The function will test for the occurrence of the regular expression pattern in the string and return a string indicating
the results of that search:
Requirements
Version 3
See Also
RegExp Object | Regular Expression Syntax
Applies To: Regular Expression Object
JScript .NET
toArray Method
Returns a standard JScript array converted from a VBArray.
Remarks
The conversion translates the multidimensional VBArray into a single dimensional JScript array. The toArray method appends
each successive dimension to the end of the previous one. For example, a VBArray with three dimensions and three elements in
each dimension converts to a JScript array as follows:
Suppose the VBArray contains: (1, 2, 3), (4, 5, 6), (7, 8, 9). After translation, the JScript array contains: 1, 2, 3, 4, 5, 6, 7, 8, 9.
There is currently no way to convert a JScript array into a VBArray.
Example
The following example consists of three parts. The first part is VBScript code that creates a Visual Basic safe array. The second part
is JScript code that converts the Visual Basic safe array to a JScript array. Both of the first and the second parts go into the
<HEAD> section of an HTML page. The third part is the JScript code that goes into the <BODY> section to run the other two parts.
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
document.writeln(k)
k = k + 1
Next
document.writeln("<BR>")
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vbarray)
{
var a = new VBArray(vbarray);
var b = a.toArray();
var i;
for (i = 0; i < 9; i++)
{
document.writeln(b[i]);
}
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT LANGUAGE="JScript">
<!--
VBArrayTest(CreateVBArray());
-->
</SCRIPT>
</BODY>
Requirements
Version 3
See Also
dimensions Method | getItem Method | lbound Method | ubound Method
Applies To: VBArray Object
JScript .NET
toDateString Method
Returns a date as a string value.
Remarks
The toDateString method returns a string value containing the date, in the current time zone, in a convenient, easily read format.
Requirements
Version 5.5
See Also
toTimeString Method | toLocaleDateString Method
Applies To: Date Object
JScript .NET
toExponential Method
Returns a string containing a number represented in exponential notation.
Arguments
fractionDigits
Optional. Number of digits after the decimal point. Must be in the range 0 – 20, inclusive.
Remarks
The toExponential method returns a string representation of a number in exponential notation. The string contains one digit
before the significand's decimal point, and may contain fractionDigits digits after it.
If fractionDigits is not supplied, the toExponential method returns as many digits necessary to uniquely specify the number.
Requirements
Version 5.5
See Also
toFixed Method | toPrecision Method
Applies To: Number Object
JScript .NET
toFixed Method
Returns a string representing a number in fixed-point notation.
Arguments
fractionDigits
Optional. Number of digits after the decimal point. Must be in the range 0 – 20, inclusive.
Remarks
The toFixed method returns a string representation of a number in fixed-point notation. The string contains one digit before the
significand's decimal point, and must contain fractionDigits digits after it.
If fractionDigits is not supplied or undefined, the toFixed method assumes the value is zero.
Requirements
Version 5.5
See Also
toExponential Method | toPrecision Method
Applies To: Number Object
JScript .NET
toGMTString Method
Returns a date converted to a string using Greenwich Mean Time (GMT).
Remarks
The toGMTString method is obsolete, and is provided for backwards compatibility only. It is recommended that you use the
toUTCString method instead.
The toGMTString method returns a String object that contains the date formatted using GMT convention. The format of the
return value is as follows: "05 Jan 1996 00:00:00 GMT."
Requirements
Version 1
See Also
toUTCString Method
Applies To: Date Object
JScript .NET
toLocaleDateString Method
Returns a date as a string value appropriate to the host environment's current locale.
Remarks
The toLocaleDateString method returns a string value that contains a date, in the current time zone, in an easily read format.
The date is in the default format of the host environment's current locale. The return value of this method cannot be relied upon
in scripting, as it will vary from computer to computer. The toLocalDateString method should only be used to format display –
never as part of a computation.
Requirements
Version 5.5
See Also
toDateString Method | toLocaleTimeString Method
Applies To: Date Object
JScript .NET
toLocaleLowerCase Method
Returns a string where all alphabetic characters have been converted to lowercase, taking into account the host environment's
current locale.
Remarks
The toLocaleLowerCase method converts the characters in a string, taking into account the host environment's current locale. In
most cases, the results are the same as you would obtain with the toLowerCase method. Results differ if the rules for a language
conflict with the regular Unicode case mappings.
Requirements
Version 5.5
See Also
toLocaleUpperCase Method | toLowerCase Method
Applies To: String Object
JScript .NET
toLocaleString Method
Returns a value as a string value appropriate to the host environment's current locale.
Remarks
For the Array object, the elements of the array are converted to strings and these strings are concatenated and returned, each
separated by the list separator specified for the host environment's current locale.
For the Date object, the toLocaleString method returns a String object that contains the date written in the current locale's long
default format.
For dates between 1601 and 9999 A.D., the date is formatted according to the user's Control Panel Regional Settings.
For dates outside this range, the default format of the toString method is used.
For the Number object, toLocaleString produces a string value that represents the value of the Number formatted as
appropriate for the host environment's current locale.
For Object objects, ToLocaleString is provided to give all objects a generic toLocaleString capability, even though they may
not use it.
Note toLocaleString should only be used to display results to a user; it should never be used as the basis for
computation within a script as the returned result is machine-specific.
Example
The following client-side example illustrates the use of the toLocaleString method using an Array, a Date, and a Number
object.
function toLocaleStringArray() {
// Declare variables.
var myArray = new Array(6);
var i;
// Initialize string.
var s = "The array contains: ";
// Populate array with values.
for(i = 0;i < 7; i++)
{
// Make value same as index.
myArray[i] = i;
}
s += myArray.toLocaleString();
return(s);
}
function toLocaleStringDate() {
// Declare variables.
var d = new Date();
var s = "Current date setting is ";
// Convert to current locale.
s += d.toLocaleString();
return(s);
}
function toLocaleStringNumber() {
var n = Math.PI;
var s = "The value of Pi is: ";
s+= n.toLocaleString();
return(s);
}
Requirements
Version 1
See Also
Methods
Applies To: Array Object | Date Object | Number Object | Object Object
JScript .NET
toLocaleTimeString Method
Returns a time as a string value appropriate to the host environment's current locale.
Remarks
The toLocaleTimeString method returns a string value that contains a time, in the current time zone, in an easily read format.
The time is in the default format of the host environment's current locale. The return value of this method cannot be relied upon
in scripting, as it will vary from computer to computer. The toLocalTimeString method should only be used to format display –
never as part of a computation.
Requirements
Version 5.5
See Also
ToTimeString Method | toLocaleDateString Method
Applies To: Date Object
JScript .NET
toLocaleUpperCase Method
Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's
current locale.
Remarks
The toLocaleUpperCase method converts the characters in a string, taking into account the host environment's current locale. In
most cases, the results are the same as you would obtain with the toUpperCase method. Results differ if the rules for a language
conflict with the regular Unicode case mappings.
Requirements
Version 5.5
See Also
toLocaleLowerCase Method | toUpperCase Method
Applies To: String Object
JScript .NET
toLowerCase Method
Returns a string where all alphabetic characters have been converted to lowercase.
Remarks
The toLowerCase method has no effect on non-alphabetic characters.
Example
Requirements
Version 1
See Also
toUpperCase Method
Applies To: String Object
JScript .NET
toPrecision Method
Returns a string containing a number represented either in exponential or fixed-point notation with a specified number of digits.
Arguments
precision
Optional. Number of significant digits. Must be in the range 1 – 21, inclusive.
Remarks
For numbers in exponential notation, precision - 1 digits are returned after the decimal point. For numbers in fixed notation,
precision significant digits are returned.
If precision is not supplied or is undefined, the toString method is called instead.
Requirements
Version 5.5
See Also
toFixed Method | toExponential Method
Applies To: Number Object
JScript .NET
toString (Método)
Devuelve una representación en forma de cadena de un objeto.
Argumentos
base
Opcional. Especifica una base para convertir los valores numéricos en cadenas. Este valor sólo se usa para números.
Comentarios
El método toString es un miembro de todos los objetos integrados de JScript. El comportamiento depende del tipo de objeto:
Objeto Comportamiento
Array Los elementos de un objeto Array se convierten en cadenas. Las cadenas resultantes se concatenan, se
paradas por comas.
Boolean Si el valor de Boolean es true, devuelve "true". De lo contrario, devuelve "false".
Date Devuelve la representación textual de la fecha.
Error Devuelve una cadena que contiene el mensaje de error asociado.
Function Devuelve una cadena que tiene la forma siguiente, donde functionname es el nombre de la función a c
uyo método toString se llamó:
"function functionname() { [código nativo] }"
Number Devuelve la representación textual del número.
String Devuelve el valor del objeto String.
Default Devuelve "[object objectname]", donde objectname es el nombre del tipo de objeto.
Ejemplo
El siguiente ejemplo muestra el uso del método toString con un argumento base. El valor devuelto por la función que se muestra
a continuación es una tabla de conversión de base.
Requisitos
Versión 2
Vea también
function (Instrucción)
Se aplica a: Array (Objeto) | Boolean (Objeto) | Date (Objeto) | Error (Objeto) | Function (Objeto) | Number (Objeto) |
Object (Objeto) | String (Objeto)
JScript .NET
toTimeString Method
Returns a time as a string value.
Remarks
The toTimeString method returns a string value containing the time, in the current time zone, in a convenient, easily read format.
Requirements
Version 5.5
See Also
toDateString Method | toLocaleTimeString Method
Applies To: Date Object
JScript .NET
toUpperCase Method
Returns a string where all alphabetic characters have been converted to uppercase.
Remarks
The toUpperCase method has no effect on non-alphabetic characters.
Example
Requirements
Version 1
See Also
toLowerCase Method
Applies To: String Object
JScript .NET
toUTCString Method
Returns a date converted to a string using Coordinated Universal Time (UTC).
Remarks
The toUTCString method returns a String object that contains the date formatted using UTC convention in a convenient, easily
read form.
Example
The following example illustrates the use of the toUTCString method.
function toUTCStrDemo(){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
s = "Current setting is ";
s += d.toUTCString(); //Convert to UTC string.
return(s); //Return UTC string.
}
Requirements
Version 3
See Also
toGMTString Method
Applies To: Date Object
JScript .NET
ubound Method
Returns the highest index value used in the specified dimension of the VBArray.
Arguments
dimension
Optional. The dimension of the VBArray for which the higher bound index is wanted. If omitted, ubound behaves as if a 1 was
passed.
Remarks
If the VBArray is empty, the ubound method returns undefined. If dimension is greater than the number of dimensions in the
VBArray, or is negative, the method generates a "Subscript out of range" error.
Example
The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is
JScript code that determines the number of dimensions in the safe array and the upper bound of each dimension. Both of these
parts go into the <HEAD> section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the
other two parts.
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
k = k + 1
Next
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vba)
{
var i, s;
var a = new VBArray(vba);
for (i = 1; i <= a.dimensions(); i++)
{
s = "The upper bound of dimension ";
s += i + " is ";
s += a.ubound(i)+ ".<BR>";
return(s);
}
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT language="jscript">
document.write(VBArrayTest(CreateVBArray()));
</SCRIPT>
</BODY>
Requirements
Version 3
See Also
dimensions Method | getItem Method | lbound Method | toArray Method
Applies To: VBArray Object
JScript .NET
unescape Method
Returns as decoded string from a String object encoded with the escape method.
Arguments
charString
Required. A String object or literal to be decoded.
Remarks
The unescape method returns a string value that contains the contents of charString. All characters encoded with the %xx
hexadecimal form are replaced by their ASCII character set equivalents.
Characters encoded in %uxxxx format (Unicode characters) are replaced with the Unicode character with hexadecimal encoding
xxxx.
Note The unescape method should not be used to decode Uniform Resource Identifiers (URI). Use decodeURI and
decodeURIComponent methods instead.
Requirements
Version 1
See Also
DecodeURI Method | decodeURIComponent Method | escape Method | String Object
Applies To: Global Object
JScript .NET
unshift Method
Inserts specified elements into the beginning of an array.
Arguments
item1, ... , itemN
Optional. Elements to insert at the start of the Array.
Remarks
The unshift method inserts elements into the start of an array, so they appear in the same order in which they appear in the
argument list.
Requirements
Version 5.5
See Also
shift Method
Applies To: Array Object
JScript .NET
UTC Method
Returns the number of milliseconds between midnight, January 1, 1970 Coordinated Universal Time (UTC) (or GMT) and the
supplied date.
function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Num
ber [, seconds : Number [,ms : Number]]]]) : Number
Arguments
year
Required. The full year designation is required for cross-century date accuracy. If year is between 0 and 99 is used, then year is
assumed to be 1900 + year.
month
Required. The month as an integer between 0 and 11 (January to December).
day
Required. The date as an integer between 1 and 31.
hours
Optional. Must be supplied if minutes is supplied. An integer from 0 to 23 (midnight to 11pm) that specifies the hour.
minutes
Optional. Must be supplied if seconds is supplied. An integer from 0 to 59 that specifies the minutes.
seconds
Optional. Must be supplied if milliseconds is supplied. An integer from 0 to 59 that specifies the seconds.
ms
Optional. An integer from 0 to 999 that specifies the milliseconds.
Remarks
The UTC method returns the number of milliseconds between midnight, January 1, 1970 UTC and the supplied date. This return
value can be used in the setTime method and in the Date object constructor. If the value of an argument is greater than its range,
or is a negative number, other stored values are modified accordingly. For example, if you specify 150 seconds, JScript redefines
that number as two minutes and 30 seconds.
The difference between the UTC method and the Date object constructor that accepts a date is that the UTC method assumes
UTC, and the Date object constructor assumes local time.
The UTC method is a static method. Therefore, a Date object does not have to be created before it can be used.
Note If year is between 0 and 99, use 1900 + year for the year.
Example
The following example illustrates the use of the UTC method.
Requirements
Version 1
See Also
setTime Method
Applies To: Date Object
JScript .NET
valueOf Method
Returns the primitive value of the specified object.
Remarks
The valueOf method is defined differently for each intrinsic JScript object.
Object Return Value
Array The elements of the array are converted into strings, and the strings are concatenated together, separat
ed by commas. This behaves the same as the Array.toString and Array.join methods.
Boolean The Boolean value.
Date The stored time value in milliseconds since midnight, January 1, 1970 UTC.
Function The function itself.
Number The numeric value.
Object The object itself. This is the default.
String The string value.
The Math and Error objects do not have a valueOf method.
Requirements
Version 2
See Also
toString Method
Applies To: Array Object | Boolean Object | Date Object | Function Object | Number Object | Object Object | String Object
JScript .NET
Modificadores
Los modificadores de JScript se utilizan para cambiar el comportamiento y la visibilidad de las clases, interfaces o miembros de
clase o interfaz. Se pueden utilizar modificadores para definir clases e interfaces, pero no son necesarios.
En esta sección
abstract (Modificador)
Modificador de herencia que permite la definición de clases y miembros de clase, pero no permite que se den
implementaciones.
expando (Modificador)
Modificador de compatibilidad que marca una clase como ampliable dinámicamente o un método como constructor de objetos
expando.
final (Modificador)
Modificador de herencia que impide que una clase sea ampliada o que un método o una propiedad sean reemplazados.
hide (Modificador)
Modificador de versión segura que impide que un método o una propiedad reemplacen un método o propiedad de una clase
base.
internal (Modificador)
Modificador de visibilidad que hace visible una clase, una interfaz o un miembro sólo en el paquete actual.
override (Modificador)
Modificador de versión segura empleado para reemplazar explícitamente un método en una clase base.
private (Modificador)
Modificador de visibilidad que hace visible un miembro de clase sólo para los miembros de la misma clase.
protected (Modificador)
Modificador de visibilidad que hace visible un miembro de clase o interfaz sólo para la clase o interfaz actual y las clases
derivadas de la clase actual.
public (Modificador)
Modificador de visibilidad que hace visibles a los miembros de una clase o interfaz para cualquier código que tenga acceso a la
clase o interfaz.
static (Modificador)
Modificador que marca un miembro de clase como perteneciente a la clase en cuestión.
Secciones relacionadas
Modificadores de JScript
Información general y conceptual sobre la finalidad y los usos de los modificadores de JScript .NET.
JScript .NET
abstract Modifier
Declares that a class must be extended or that the implementation for a method or property must be provided by a derived class.
abstract statement
Arguments
statement
Required. A class, method, or property definition.
Remarks
The abstract modifier is used for a method or property in a class that has no implementation or for a class that contains such
methods. A class with abstract members cannot be instantiated with the new operator. You can derive both abstract and non-
abstract classes from an abstract base class.
Methods and properties in classes and classes can be marked with the abstract modifier. A class must be marked as abstract if it
contains any abstract members. Interfaces and members of interfaces, which are implicitly abstract, cannot take the abstract
modifier. Fields cannot be abstract.
You may not combine the abstract modifier with the other inheritance modifier (final). By default, class members are neither
abstract nor final. The inheritance modifiers cannot be combined with the static modifier.
Example
Requirements
Version .NET
See Also
Modifiers | final Modifier | static Modifier | var Statement | function Statement | class Statement | Variable Scope | new Operator
JScript .NET
expando Modifier
Declares that instances of a class support expando properties or that a method is an expando object constructor.
expando statement
Arguments
statement
Required. A class or method definition.
Remarks
The expando modifier is used to mark a class as dynamically extensible (one that supports expando properties). Expando
properties on expando class instances must be accessed using the [] notation; they are not accessible with the dot operator. The
expando modifier also marks a method as an expando object constructor.
Classes and methods in classes can be marked with the expando modifier. Fields, properties, interfaces, and members of
interfaces cannot take the expando modifier.
An expando class has a hidden, private property named Item that takes one Object parameter and returns an Object. You are
not allowed to define a property with this signature on an expando class.
Example 1
The following example illustrates a use of the expando modifier on a class. The expando class is like a JScript Object, but there
are some differences that are illustrated here.
10
ten
twelve
twelve
Example 2
The following example illustrates a use of the expando modifier on a method. When the expando method is called in the usual
way, it accesses the field x. When the method is used as an explicit constructor with the new operator, it adds an expando
property to a new object.
class CExpandoExample {
var x : int;
expando function constructor(val : int) {
this.x = val;
return "Method called as a function.";
}
}
Requirements
Version .NET
See Also
Modifiers | static Modifier | var Statement | function Statement | class Statement | Variable Scope | Type Annotation
JScript .NET
final Modifier
Declares that a class cannot be extended or that a method or property cannot be overridden.
final statement
Arguments
statement
Required. A class, method, or property definition.
Remarks
The final modifier is used to specify that a class cannot be extended or that a method or property cannot be overridden. This
prevents other classes from changing the behavior of the class by overriding important functions. Methods with the final
modifier can be hidden or overloaded by methods in derived classes.
Methods and properties in classes and classes can be marked with the final modifier. Interfaces, fields, and members of interfaces
cannot take the final modifier.
You may not combine the final modifier with the other inheritance modifier (abstract). By default, class members are neither
abstract nor final. The inheritance modifiers cannot be combined with the static modifier.
Example
The following example illustrates a use of the final modifier. The final modifier prevents the base-class method from being
overridden by methods from the derived class.
class CBase {
final function methodA() { print("Final methodA of CBase.") };
function methodB() { print("Non-final methodB of CBase.") };
}
The output of this program show that the final method is not overridden:
Requirements
Version .NET
See Also
Modifiers | abstract Modifier | hide Modifier | override Modifier | var Statement | function Statement | class Statement |
Variable Scope | Type Annotation
JScript .NET
hide Modifier
Declares that a method or property hides a method or property in a base class.
hide statement
Arguments
statement
Required. A method or property definition.
Remarks
The hide modifier is used for a method that hides a method in a base class. You are not allowed to use the hide modifier for a
method unless the base class has a member with the same signature.
Methods and properties in classes can be marked with the hide modifier. Classes, fields, interfaces and members of interfaces
cannot take the hide modifier.
You may not combine the hide modifier with the other version-safe modifier (override). The version-safe modifiers cannot be
combined with the static modifier. By default, a method will override a base-class method unless the base-class method has the
final modifier. You cannot hide an abstract method unless you provide an explicit implementation for the abstract, base method.
When running in version-safe mode, one of the version-safe modifiers must be used whenever a base-class method is
overridden.
Example
The following example illustrates a use of the hide modifier. The method in the derived class marked with the hide modifier does
not override the base-class method. The method marked with override does override the base-class method.
class CBase {
function methodA() { print("methodA of CBase.") };
function methodB() { print("methodB of CBase.") };
}
The output of this program shows that a hidden method does not override a base class method.
Hiding methodA.
Overriding methodB.
methodA of CBase.
Overriding methodB.
Requirements
Version .NET
See Also
Modifiers | override Modifier | static Modifier | var Statement | function Statement | class Statement | Variable Scope |
Type Annotation | /versionsafe
JScript .NET
internal Modifier
Declares that a class, class member, interface, or interface member has internal visibility.
internal statement
Arguments
statement
Required. A class, interface, or member definition.
Remarks
The internal modifier makes a class, interface, or member visible only within the current package. Code outside the current
package cannot access internal members.
Classes and interfaces can be marked with the internal modifier. In the global scope, the internal modifier is the same as the
public modifier. Any member of a class or interface can be marked with the internal modifier.
You may not combine the internal modifier with any of the other visibility modifiers (public, private, or protected). Visibility
modifiers are relative to the scope in which they are defined. For example, a public method of an internal class is not publicly
accessible, but any code that has access to the class can access the method.
Requirements
Version .NET
See Also
Modifiers | public Modifier | private Modifier | protected Modifier | var Statement | function Statement | class Statement |
Variable Scope
JScript .NET
override Modifier
Declares that a method or property overrides a method or property in a base class.
override statement
Arguments
statement
Required. A method or property definition.
Remarks
The override modifier is used for a method that overrides a method in a base class. You are not allowed to use the override
modifier for a method unless the base class has a member with the same signature.
Methods and properties in classes can be marked with the override modifier. Classes, fields, interfaces and members of
interfaces cannot take the override modifier.
You may not combine the override modifier with the other version-safe modifier (hide). The version-safe modifiers cannot be
combined with the static modifier. By default, a method will override a base-class method unless the base-class method has the
final modifier. You cannot override a final method. When running in version-safe mode, one of the version-safe modifiers must
be used whenever a base-class method is overridden.
Example
The following example illustrates a use of the override modifier. The method in the derived class marked with the override
modifier overrides the base-class method. The method marked with the hide modifier does not override the base class method.
class CBase {
function methodA() { print("methodA of CBase.") };
function methodB() { print("methodB of CBase.") };
}
The output of this program shows that an override method overrides a base-class method.
Hiding methodA.
Overriding methodB.
methodA of CBase.
Overriding methodB.
Requirements
Version .NET
See Also
Modifiers | hide Modifier | var Statement | function Statement | class Statement | Variable Scope | Type Annotation
JScript .NET
private Modifier
Declares that a class member has private visibility.
private statement
Arguments
statement
Required. A class member definition.
Remarks
The private modifier makes a member of a class visible only within that class. Code outside the current class, including derived
classes, cannot access private members.
Classes and interfaces in the global scope cannot be marked with the private modifier. Any member of a class or interface
(including nested classes and nested interfaces) can be marked with the private modifier.
You may not combine the private modifier with any of the other visibility modifiers (public, protected, or internal).
Requirements
Version .NET
See Also
Modifiers | public Modifier | protected Modifier | internal Modifier | var Statement | function Statement | class Statement |
Variable Scope
JScript .NET
protected Modifier
Declares that a class member or interface member has protected visibility.
protected statement
Arguments
statement
Required. A class member or interface member definition.
Remarks
The protected modifier makes a member of a class or interface visible only within that class or interface and all derived classes of
the current class. Code outside the current class cannot access protected members.
Classes and interfaces in the global scope cannot be marked with the protected modifier. Any member of a class or interface
(including nested classes and nested interfaces) can be marked with the protected modifier.
You may not combine the protected modifier with any of the other visibility modifiers (public, private, or internal).
Requirements
Version .NET
See Also
Modifiers | public Modifier | private Modifier | internal Modifier | var Statement | function Statement | class Statement |
Variable Scope
JScript .NET
public Modifier
Declares that a class, interface, or member has public visibility.
public statement
Arguments
statement
Required. A class, interface, or member definition.
Remarks
The public modifier makes a member of a class visible to any code that has access to the class.
All classes and interfaces are public by default. A member of a class or interface can be marked with the public modifier.
You may not combine the public modifier with any of the other visibility modifiers (private, protected, or internal).
Requirements
Version .NET
See Also
Modifiers | private Modifier | protected Modifier | internal Modifier | var Statement | function Statement | class Statement |
Variable Scope
JScript .NET
static Modifier
Declares that a class member belongs to a class rather than to instances of the class.
static statement
Arguments
statement
Required. A class member definition.
Remarks
The static modifier signifies that a member belongs to the class itself rather than to instances of the class. Only one copy of a
static member exists in a given application even if many instances of the class are created. You can only access static members
with a reference to the class rather than a reference to an instance. However, within a class member declaration, static members
can be accessed with the this object.
Members of classes can be marked with the static modifier. Classes, interfaces, and members of interfaces cannot take the static
modifier.
You may not combine the static modifier with any of the inheritance modifiers (abstract and final) or version-safe modifiers
(hide and override).
Do not confuse the static modifier with the static statement. The static modifier denotes a member that belongs to the class
itself rather than any instance of the class.
Example
The following example illustrates a use of the static modifier.
class CTest {
var nonstaticX : int; // A non-static field belonging to a class instance.
static var staticX : int; // A static field belonging to the class.
}
5
42
Requirements
Version .NET
See Also
Modifiers | expando Modifier | var Statement | function Statement | class Statement | Variable Scope | Type Annotation |
static Statement
JScript .NET
Objetos
Los objetos son colecciones de propiedades y métodos. Las secciones que se muestran a continuación proporcionan vínculos a
información que explica cómo utilizar los objetos de JScript.
Nota El motor de tiempo de ejecución de JScript no está diseñado para ofrecer seguridad con subprocesos. Por
tanto, los objetos y métodos de JScript pueden tener un comportamiento impredecible cuando se utilizan en
aplicaciones multiproceso.
En esta sección
ActiveXObject (Objeto)
Habilita y devuelve una referencia a un objeto de automatización
arguments (Objeto)
Proporciona acceso a los argumentos pasados a la función actual.
Array (Objeto)
Permite la creación de matrices de cualquier tipo de datos.
Boolean (Objeto)
Crea un nuevo valor Boolean.
Date (Objeto)
Permite el almacenamiento básico y la recuperación de fechas y horas.
Enumerator (Objeto)
Habilita la enumeración de los elementos de una colección.
Error (Objeto)
Objeto que contiene información sobre errores que ocurren mientras se ejecuta el código de JScript.
Function (Objeto)
Crea una nueva función.
Global (Objeto)
Objeto intrínseco cuyo propósito es recopilar métodos globales en un objeto.
Math (Objeto)
Objeto intrínseco que proporciona la funcionalidad y las constantes matemáticas básicas.
Number (Objeto)
Representación de objeto del tipo de dato número y marcador para las constantes numéricas.
Object (Objeto)
Proporciona funcionalidad común a todos los objetos de JScript.
RegExp (Objeto)
Almacena información de búsquedas de modelos de expresiones regulares.
Regular Expression (Objeto)
Contiene un modelo de expresión regular.
String (Objeto)
Permite manipular y dar formato a cadenas de texto y determinar y ubicar subcadenas dentro de cadenas.
VBArray (Objeto)
Proporciona acceso a las matrices seguras de Visual Basic.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Métodos
Enumera por orden alfabético los métodos disponibles en JScript y proporciona vínculos a cada una de las categorías de los
métodos.
Propiedades
Proporciona una lista de las propiedades disponibles en JScript y vínculos a los temas que explican la sintaxis de uso correcta de
cada propiedad.
Objetos de JScript
Detalla el concepto de objeto en JScript, explica cómo los objetos están relacionados con las propiedades y los métodos, e
incluye vínculos a temas que proporcionan más detalles sobre los objetos que JScript admite.
JScript .NET
ActiveXObject Object
An object that provides an interface to an Automation object.
Arguments
ProgID
Required. A string of the form "serverName.typeName", where serverName is the name of the application providing the object,
and typeName is the name of the type or class of the object to create.
location
Optional. The name of the network server where the object is to be created.
Remarks
Typically, an automation server provides at least one type of object. For example, a word-processing application may provide an
application object, a document object, and a toolbar object.
The following code starts an application (in this case, a Microsoft Excel worksheet) by calling the ActiveXObject object
constructor. The ActiveXObject allows you to refer to the application in your code. Using the following example, you can access
properties and methods of the new object using the object variable ExcelSheet and other Excel objects, including the Application
object and the ActiveSheet.Cells collection.
Creating an object on a remote server can only be accomplished when Internet security is turned off. You can create an object on
a remote networked computer by passing the name of the computer to the servername argument of ActiveXObject. That name
is the same as the machine name portion of a sharename. For a network share named "\\MyServer\public", the servername is
"MyServer". In addition, you can specify servername using DNS format or an IP address.
The following code returns the version number of an instance of Excel running on a remote network computer named
"MyServer":
function GetAppVersion() {
var Excel = new ActiveXObject("Excel.Application", "MyServer");
return(Excel.Version);
}
An error occurs if the specified remote server does not exist or cannot be found.
Properties and Methods
An ActiveXObject object has no intrinsic properties or methods; it allows you to access the properties and methods of the
Automation object.
Requirements
Version 1
See Also
new Operator | GetObject Function
JScript .NET
arguments Object
An object representing the currently executing function, its arguments, and the function that called it. This object cannot be
constructed explicitly.
Remarks
An arguments object is instantiated for each function when it begins execution. The arguments object is directly accessible only
within the scope of its associated function.
All parameters passed to a function and the number of parameters are stored in the arguments object. The arguments object is
not an array, but the individual arguments are accessed using [ ] notation, the same way array elements are accessed.
You can use the arguments object to create functions that can accept an arbitrary number of arguments. This functionality can
also be achieved by using the parameter array construction when defining your function. For more information, see the function
statement topic.
Note The arguments object is not available when running in fast mode, the default for JScript .NET. To compile a
program from the command line that uses the arguments object, you must turn off the fast option by using /fast-. It
is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the arguments object.
Properties
arguments Object Properties
Methods
The arguments object has no methods.
Requirements
Version 1
See Also
new Operator | function Statement | /fast
JScript .NET
Array Object
Provides support for expando arrays of any data type. There are three forms of the Array constructor.
Arguments
size
Optional. The size of the array. As arrays are zero-based, created elements will have indexes from zero to size -1.
varargs
Optional. A typed array that contains all the parameters passed to the constructor. These parameters are used as the first
elements of the array.
array
Optional. An array to be copied to the array being constructed.
Remarks
If only one argument is passed to the Array constructor and the argument is a number, it must be an unsigned 32-bit integer (any
integer less than approximately four billion). The passed value is the size of the array. If the value is a number that is less than zero
or is not an integer, a run-time error occurs.
A variable of data type System.Array can be passed to the Array constructor. This produces a JScript array that is a copy of the
input array. The System.Array must have only one dimension.
If a single value is passed to the Array constructor and it is not a number or an array, the length property of the array is set to 1,
and the value of the first element of the array (element 0) becomes the single, passed-in argument. If several arguments are
passed to the constructor, the length of the array is set to the number of arguments, and those arguments will be the first
elements in the new array.
Notice that JScript arrays are sparse arrays; that is, although you can allocate an array with many elements, only the elements that
actually contain data exist. This reduces the amount of memory used by the array.
The Array object interoperates with System.Array data type. Consequently, an Array object can call the methods and properties
of the System.Array data type, and a System.Array data type can call the methods and properties of the Array object.
Furthermore, Array objects are accepted by functions that take System.Array data types, and vice versa. For more information,
see Array Members.
When an Array object is passed to a function that takes a System.Array or when System.Array methods are called from an
Array object, the contents of the Array are copied. Thus, the original Array object cannot be modified by the System.Array
methods or by passing it to a function that accepts a System.Array. Only nondestructive Array methods can be called on a
System.Array.
Tip Array objects are convenient when you want a generic stack or a list of items and performance is not a top
concern. In all other contexts, typed array data types should be used. A typed array, which has much of the same
functionality as the Array object, also provides type safety, performance improvements, and better interaction with
other languages.
Note The Array object interoperates with the .NET Framework System.Array data type within JScript .NET. However,
other Common Language Specification (CLS) languages cannot use the Array object because only JScript .NET
provides the object; it is not derived from a .NET Framework type. Consequently, when type-annotating the
parameters and return types of CLS-compliant methods, make sure to use the System.Array data type instead of the
Array object. However, you may use the Array object to type annotate identifiers other than the parameters or return
types. For more information, see Writing CLS-Compliant Code.
Example
The individual elements of the array can be accessed using [ ] notation. For example:
Since arrays in Microsoft JScript are zero-based, the final statement in the preceding example accesses the fifth element of the
array. That element contains the value 4.
Properties and Methods
Array Object Properties and Methods
Requirements
Version 2
See Also
new Operator | Typed Arrays
JScript .NET
See Also
Properties | Methods | JScript Reference
JScript .NET
Boolean Object
The Boolean object references a Boolean value.
Arguments
boolValue
Optional. The initial Boolean value for the new object. If boolValue is omitted, or is false, 0, null, NaN, or an empty string, the
initial value of the Boolean object is false. Otherwise, the initial value is true.
Remarks
The Boolean object is a wrapper for Boolean data. The primary purposes for the Boolean object are to collect its properties into
one object and to allow Boolean values to be converted into strings via the toString method. The Boolean object is similar to the
boolean data type. However, they have different properties and methods.
Note You rarely need to construct a Boolean object explicitly. The boolean data type should be used in most
circumstances. Since the Boolean object interoperates with the boolean data type, all Boolean object methods and
properties are available to a variable of type Boolean. For more information, see boolean Data Type.
The data type of a Boolean object is Object, not boolean.
Properties and Methods
Boolean Object Properties and Methods
Requirements
Version 2
See Also
Object Object | | Boolean Structure | new Operator | var Statement
JScript .NET
Date Object
An object that enables basic storage and retrieval of dates and times. There are two forms of the Date constructor.
Arguments
dateVal
Optional. If a numeric value, dateVal represents the number of milliseconds in Coordinated Universal Time between the
specified date and midnight January 1, 1970. If a string, dateVal is parsed according to the rules in the parse method. The
dateVal can also be a .NET date value.
year
Required. The full year, for example, 1976 (not 76).
month
Required. The month as an integer between 0 and 11 (January to December).
date
Required. The date as an integer between 1 and 31.
hours
Optional. Must be supplied if minutes is supplied. An integer from 0 to 23 (midnight to 11pm) that specifies the hour.
minutes
Optional. Must be supplied if seconds is supplied. An integer from 0 to 59 that specifies the minutes.
seconds
Optional. Must be supplied if milliseconds is supplied. An integer from 0 to 59 that specifies the seconds.
ms
Optional. An integer from 0 to 999 that specifies the milliseconds.
Remarks
A Date object contains a number representing a particular instance in time to within a millisecond. If the value of an argument is
greater than its range or is a negative number, other stored values are modified accordingly. For example, if you specify 150
seconds, JScript redefines that number as two minutes and 30 seconds.
If the number is NaN, the object does not represent a specific instance in time. If you pass no parameters to the Date constructor,
it is initialized to the current time (UTC). A variable of type Date must be initialized before you can use it.
The range of dates that can be represented in a Date object is approximately 285,616 years on either side of January 1, 1970.
The Date object has two static methods, parse and UTC, that are called without creating a Date object.
If the Date constructor is called without the new operator, the Date object that is returned contains the current date regardless of
the arguments passed to the constructor.
Note The Date object interoperates with the .NET Framework System.DateTime data type within JScript .NET.
However, other Common Language Specification (CLS) languages cannot use the Date object because only JScript
.NET provides the object; it is not derived from a .NET Framework type. Consequently, when type-annotating the
parameters and return types of CLS-compliant methods, make sure to use the System.DateTime data type instead of
the Date object. However, you may use the Date object to type annotate identifiers other than the parameters or
return types. For more information, see Writing CLS-Compliant Code.
Example
The following example uses the Date object.
See Also
Enumerator Object
Enables enumeration of items in a collection.
Arguments
varName
Required. The variable name to which the enumerator is assigned.
collection
Optional. Any object that implements the IEnumerable interface, such as an array or collection.
Remarks
Every collection is automatically enumerable in JScript .NET. Consequently, you do not need to use the Enumerator object to
access members of a collection. You can access any member directly using the for...in statement. The Enumerator object is
provided for backwards compatibility.
Collections differ from arrays in that the members of a collection are not directly accessible. Instead of using indexes, as you
would with arrays, you can only move the current item pointer to the first or next element of a collection.
The Enumerator object, which provides a way to access any member of a collection, behaves in a manner similar to the
For...Each statement in VBScript.
You can create a collection in JScript by defining a class that implements IEnumerable. Collections can also be created using
another language (such as Visual Basic) or by an ActiveXObject object.
Example 1
The following code uses the Enumerator object to print the letters of the available drives and their names (if available):
// Declare variables.
var n, x;
var fso : ActiveXObject = new ActiveXObject("Scripting.FileSystemObject");
// Create Enumerator on Drives.
var e : Enumerator = new Enumerator(fso.Drives);
for (;!e.atEnd();e.moveNext()) { // Loop over the drives collection.
x = e.item();
if (x.DriveType == 3) // See if network drive.
n = x.ShareName; // Get share name
else if (x.IsReady) // See if drive is ready.
n = x.VolumeName; // Get volume name.
else
n = "[Drive not ready]";
print(x.DriveLetter + " - " + n);
}
Example 2
The code in Example 1 can be rewritten to work without using the Enumerator object. Here, members of an enumeration are
accessed directly.
// Declare variables.
var n, x;
var fso : ActiveXObject = new ActiveXObject("Scripting.FileSystemObject");
// The following three lines are not needed.
// var e : Enumerator = new Enumerator(fso.Drives);
// for (;!e.atEnd();e.moveNext()) {
// x = e.item();
// Access the members of the enumeration directly.
for (x in fso.Drives) { // Loop over the drives collection.
if (x.DriveType == 3) // See if network drive.
n = x.ShareName; // Get share name
else if (x.IsReady) // See if drive is ready.
n = x.VolumeName; // Get volume name.
else
n = "[Drive not ready]";
print(x.DriveLetter + " - " + n);
}
Properties
The Enumerator object has no properties.
Methods
Enumerator Object Methods
Requirements
Version 3
See Also
new Operator | for...in Statement
JScript .NET
Error Object
Contains information about errors. There are two forms of the Error constructor.
Arguments
number
Optional. Numeric value assigned to the error, specifying the value of the number property. Zero if omitted.
description
Optional. Brief string that describes the error, specifying the initial value of the description and message properties. Empty
string if omitted.
Remarks
Error objects can be explicitly created using the constructor shown above. You can add properties to the Error object to expand its
capabilities. An Error object is also created whenever a run-time error occurs to describe the error.
Typically, an Error object is thrown with the throw statement and the expectation that it will be caught by a try...catch statement.
You can use a throw statement to pass any type of data as an error; the throw statement will not implicitly create an Error object.
However, by throwing an Error object, a catch block can treat JScript run-time errors and user-defined errors similarly.
The Error object has four intrinsic properties: the description of the error (description and message properties), the error
number (number property), and the name of the error (name property). The description and message properties refer to the
same message; the description property provides backwards compatibility, while the message property complies with the
ECMA standard.
An error number is a 32-bit value. The upper 16-bit word is the facility code, while the lower word is the actual error code. To read
off the actual error code, use the & (bitwise And) operator to combine the number property with the hexadecimal number 0xFFFF.
Caution Attempting to use the JScript Error object in an ASP.NET page may product unintended results. This results
from the potential ambiguity between the JScript Error object and the Error event of the ASP.NET page. Use the
System.Exception class instead of the Error object for error handling in ASP.NET pages.
Note Only JScript .NET provides the Error object. Since it is not derived from a .NET Framework type, other Common
Language Specification (CLS) languages cannot use it. Consequently, when type-annotating the parameters and return
types of CLS-compliant methods, make sure to use the System.Exception data type instead of the Error object.
However, you may use the Error object to type annotate identifiers other than parameters or return types. For more
information, see Writing CLS-Compliant Code.
Example
The following example illustrates a use of the Error object.
try {
// Throw an error.
throw new Error(42,"No question");
} catch(e) {
print(e)
// Extract the error code from the error number.
print(e.number & 0xFFFF)
print(e.description)
}
Error: No question
42
No question
Properties and Methods
Error Object Properties and Methods
Requirements
Version 5
See Also
new Operator | throw Statement | try...catch...finally Statement | var Statement | System.Web.UI.Page Members
JScript .NET
toString Method
See Also
Properties | Methods | JScript Reference
JScript .NET
Function Object
Creates a new function.
Arguments
param1, ..., paramN
Optional. The parameters of the function. Each parameter may have type annotation. The last parameter may be a parameter
array, which is denoted by three periods (...) followed by a parameter array name and a typed array type annotation.
body
Optional. A string that contains the block of JScript code to be executed when the function is called.
Remarks
The Function constructor allows a script to create functions at run time. The parameters passed to the Function constructor (all
but the last parameter) are used as the parameters of the new function. The last parameter passed to the constructor is
interpreted as the code for the body of the function.
JScript compiles the object created by the Function constructor at the time the constructor is called. Although this allows your
script to have great flexibility in redefining functions at run time, it is also makes the code much slower. Use the Function
constructor as little as possible to avoid slow scripts.
When calling a function to evaluate, always include the parentheses and required arguments. Calling a function without
parentheses returns the Function object for that function. The text of a function can be obtained by using the toString method of
the Function object.
Note Only JScript .NET provides the Function object. Since it is not derived from a .NET Framework type, other
Common Language Specification (CLS) languages cannot use it. Consequently, when type-annotating the parameters
and return types of CLS-compliant methods, make sure to use the System.EventHandler data type instead of the
Function object. However, you may use the Function object to type annotate identifiers other than parameters or
return types. For more information, see Writing CLS-Compliant Code.
Example
The following example illustrates a use of the Function object.
Methods
apply Method
call Method
toString Method
valueOf Method
See Also
Properties | Methods | JScript Reference
JScript .NET
Global Object
An intrinsic object whose purpose is to collect global methods into one object.
The Global object has no syntax. You call its methods directly.
Remarks
The Global object is never used directly and cannot be created using the new operator. It is created when the scripting engine is
initialized, thus making its methods and properties available immediately.
Properties and Methods
Global Object Properties and Methods
Requirements
Version 5
See Also
Object Object
JScript .NET
Math Object
An intrinsic object that provides basic mathematics functionality and constants. This object cannot be constructed explicitly.
Remarks
The new operator cannot create the Math object and returns an error if you attempt to do so. The scripting engine creates the
Math object when the engine is loaded. All of its methods and properties are available to a script at all times.
Example
The following example illustrates a use of the Math object. Note that since floating-point numbers have limited precision,
calculations involving them can accumulate small rounding errors. You can use the toFixed method of the Number object to
display numbers without small rounding errors.
3.141592653589793
-1
0.0000000000
See Also
Number Object
JScript .NET
Number Object
An object representation of numeric data and placeholder for numeric constants.
Arguments
value
Required. The numeric value of the Number object being created.
Remarks
The Number object is a wrapper for numeric data. The primary purposes for the Number object are to collect its properties into
one object and to allow numbers to be converted into strings via the toString method. The Number object is similar to the
Number data type. However, they have different properties and methods.
Note You rarely need to construct a Number object explicitly. The Number data type should be used in most
circumstances. Since the Number object interoperates with the Number data type, all Number object methods and
properties are available to a variable of type Number. For more information, see Number Data Type.
The Number object is stores numeric data as an eight-byte, double-precision, floating-point number. It represents a double-
precision 64-bit IEEE 754 value. The Number object can represent numbers in the range negative 1.79769313486231570E+308
through positive 1.79769313486231570E+308, inclusive. The smallest number that can be represented is 4.94065645841247E-
324. The Number object can also represent NaN (Not a Number), positive and negative infinity, and positive and negative zero.
The data type of a Number object is Object, not Number.
Properties and Methods
Number Object Properties and Methods
Requirements
Version 1
See Also
Object Object | Number Data Type | Math Object | new Operator
JScript .NET
Methods
toExponential Method
toFixed Method
toLocaleString Method
toPrecision Method
toString Method
valueOf Method
See Also
Properties | Methods | JScript Reference
JScript .NET
Object Object
Provides functionality common to all JScript objects.
Arguments
value
Optional. Any one of the JScript primitive data types. If value is an object, the object is returned unmodified. If value is null,
undefined, or not supplied, an object with no content is created.
Remarks
The Object object forms the basis of all other JScript objects; all of its methods and properties are available in all other objects.
The methods, which can be redefined in user-defined objects, are called by JScript at appropriate times. The toString method is
an example of a frequently redefined Object method.
Variables defined without a type annotation are implicitly of type Object. Each JScript object has, in addition to its own properties
and methods, all the properties and methods of the Object object.
Properties and Methods
Object object Properties and Methods
Requirements
Version 3
See Also
new Operator | Function Object | Global Object
JScript .NET
RegExp Object
An intrinsic global object that stores information about the results of regular expression pattern matches. This object cannot be
constructed explicitly.
Remarks
The RegExp object cannot be created directly, but it is always available. Until a successful regular expression search has been
completed, the initial values of the various properties of the RegExp object are as follows:
Property Shorthan Initial Value
d
index -1
input $_ Empty string
lastIndex -1
lastMatch $& Empty string.
lastParen $+ Empty string.
leftContext $` Empty string.
rightContext $' Empty string.
$1 - $9 Empty string.
The global RegExp object should not be confused with the Regular Expression object. Although they sound similar, they are
separate and distinct. The properties of the global RegExp object contain continually updated information about each match as it
occurs, while the properties of the Regular Expression object contain only information about the matches that occur with a
single instance of the Regular Expression.
Note The properties of RegExp are not available when running in fast mode, the default for JScript .NET. To compile
a program from the command line that uses these properties, you must turn off the fast option by using /fast-. It is
not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the global RegExp object. This example must be compiled with the /fast- option.
$1 contains: bB
$2 contains: d
$3 contains:
Properties
RegExp Object Properties
Methods
The RegExp object has no methods.
Requirements
Version 3
See Also
Regular Expression Object | Regular Expression Syntax | String Object | /fast
JScript .NET
Syntax 2
/pattern/[flags]
Arguments
pattern
Required. The regular expression pattern to use. If you use Syntax 1, the pattern must be a string. If you use Syntax 2, the
pattern is delimited by the "/" characters.
flags
Optional. If you use Syntax 1, the flags must be in a string. If you use Syntax 2, the flags characters immediately follow the last
"/" character. Available flags, which may be combined, are:
g (global search for all occurrences of pattern)
i (ignore case)
m (multiline search)
regexObj
Required. A Regex object that contains the regular expression pattern to use.
Remarks
The Regular Expression object should not be confused with the global RegExp object. Although they sound similar, they are easily
distinguishable. The properties of the Regular Expression object contain information about only one particular Regular Expression
instance, while the properties of the global RegExp object contain continually updated information about each match as it occurs.
Regular Expression objects store patterns used to search strings for character combinations. After the Regular Expression object is
created, it is either passed to a string method, or a string is passed a method of the Regular Expression object. Information about
the most recent search performed is stored in the global RegExp object.
Use Syntax 1 when the search string changes frequently or is unknown, such as strings derived from user input. Use Syntax 2
when you know the search string ahead of time.
In JScript the pattern argument is compiled into an internal format before use. For Syntax 1, pattern is compiled just before use or
when the compile method is called. For Syntax 2, pattern is compiled as the script loads.
Note The Regular Expression object interoperates with the .NET Framework
System.Text.RegularExpressions.Regex data type within JScript .NET. However, other Common Language
Specification (CLS) languages cannot use the Regular Expression object because only JScript .NET provides the object;
it is not derived from a .NET Framework type. Consequently, when type-annotating the parameters and return types of
CLS-compliant methods, make sure to use the System.Text.RegularExpressions.Regex data type instead of the
Regular Expression object. However, you may use the Regular Expression object to type annotate identifiers other than
the parameters or return types. For more information, see Writing CLS-Compliant Code.
Example
The following example illustrates the use of the Regular Expression object. Objects re1 and re2 are created and contain regular
expression patterns with the associated flags. In this case, the resulting Regular Expression objects are then used by the match
method:
Spain
in
Requirements
Version 3
See Also
new Operator | RegExp Object | Regular Expression Syntax | String Object | Regex Class
JScript .NET
compile Method
exec Method
test Method
See Also
Properties | Methods | JScript Reference
JScript .NET
String Object
Allows manipulation and formatting of text strings and determines and locates substrings within strings.
Arguments
stringLiteral
Optional. Any group of Unicode characters.
Remarks
String objects can be created implicitly using string literals. String objects created in this fashion (referred to as "primitive"
strings) are treated differently from String objects created using the new operator. Although you can read properties and call
methods on primitive strings, you cannot create new properties or add methods to them.
Escape sequences can be used in string literals to represent special characters that cannot be used directly in a string, such as the
newline character or Unicode characters. At the time a script is compiled, each escape sequence in a string literal is converted into
the characters it represents. For additional information, see String Data.
JScript also defines a String data type, which provides different properties and methods from the String object. You cannot
create properties or add methods to variables of the String data type, while you can for instances of the String object.
The String object interoperates with String data type (which is the same as the System.String data type). This means that a
String object can call the methods and properties of the String data type, and a String data type can call the methods and
properties of the String object. For more information, see String Members. Furthermore, String objects are accepted by functions
that take String data types, and vice versa.
The data type of a String object is Object, not String.
Example 1
This script demonstrates that although the length property can be read and the toUpperCase method can be called, the custom
property myProperty cannot be set on the primitive string:
16
THIS IS A STRING
undefined
Example 2
For String objects created with the new statement, custom properties can be set:
VBArray Object
Provides access to Visual Basic safe arrays.
Arguments
varName
Required. The variable name to which the VBArray is assigned.
safeArray
Required. A VBArray value.
Remarks
The safeArray argument must have a VBArray value before being passed to the VBArray constructor. This can be acquired by
retrieving the value from an existing ActiveX or other object.
Note Arrays created in JScript .NET and arrays created in Visual Basic .NET both interoperate with .NET Framework
arrays. Consequently, the elements of an array created in Visual Basic are directly accessible in JScript .NET. The
VBArray object is only provided for backwards compatibility. For more information on arrays, see Array Object,
Dim Statement, and Array Members.
A VBArray can have multiple dimensions. The indices of each dimension can be different. The dimensions method retrieves the
number of dimensions in the array; the lbound and ubound methods retrieve the range of indices used by each dimension.
Properties
The VBArray object has no properties.
Methods
VBArray Object Methods
Requirements
Version 3
See Also
new Operator | Array Object | Array Class
JScript .NET
Operadores
JScript incluye una serie de operaciones que se agrupan en las siguientes categorías: aritmética, lógica, bit a bit, asignación y
varios. Las secciones que se muestran a continuación proporcionan vínculos a información que explica cómo utilizar los
operadores.
En esta sección
Operador de asignación y suma (+=)
Suma dos números o concatena dos cadenas, y asigna el resultado al primer argumento.
Operador de suma (+)
Suma dos números o concatena dos cadenas.
Operador de asignación (=)
Asigna un valor a una variable.
Operador de asignación y AND bit a bit (&=)
Realiza una operación AND bit a bit en dos expresiones y asigna el resultado al primer argumento.
Operador AND bit a bit (&)
Realiza una operación AND bit a bit en dos expresiones.
Operador de desplazamiento bit a bit a la izquierda (<<)
Desplaza los bits de una expresión a la izquierda.
Operador NOT bit a bit (~)
Realiza una operación NOT (negación) bit a bit en una expresión.
Operador de asignación y OR bit a bit (|=)
Realiza una operación OR bit a bit en dos expresiones y asigna el resultado al primer argumento.
Operador OR bit a bit (|))
Realiza una operación OR bit a bit en dos expresiones.
Operador de desplazamiento bit a bit a la derecha (>>)
Desplaza los bits de una expresión a la derecha, conservando el signo.
Operador de asignación y XOR bit a bit (^=)
Realiza una operación OR bit a bit exclusiva en dos expresiones y asigna el resultado al primer argumento.
Operador XOR bit a bit (^)
Realiza una operación OR exclusiva bit a bit en dos expresiones.
Operador coma (,)
Hace que dos expresiones se ejecuten secuencialmente.
Operadores de comparación
Variedad de operadores (==, >, >=, ===, !=, <, <=, !==) que devuelven un valor de tipo Boolean que indica el resultado de la
comparación.
Operador condicional ternario (?:)
Elige una de dos instrucciones para ejecutarla dependiendo de una condición.
Operador delete
Elimina una propiedad de un objeto o quita un elemento de una matriz.
Operador de asignación y división (/=)
Divide dos números y devuelve un resultado numérico que asigna al primer argumento.
Operador de división (/)
Divide dos números y devuelve el resultado numérico.
in (Operador)
Comprueba la existencia de una propiedad en un objeto.
Operadores de incremento (++) y decremento ( -- )
El operador de incremento (++) incrementa una variable en uno; el operador de decremento (--) disminuye una variable en
uno.
Operador instanceof
Devuelve un valor booleano que indica si un objeto es instancia de una clase concreta.
Operador de asignación y desplazamiento a la izquierda (<<=)
Desplaza los bits de una expresión hacia la izquierda y asigna el resultado al primer argumento.
Operador lógico AND (&&)
Realiza una conjunción lógica en dos expresiones.
Operador lógico NOT (!)
Realiza una negación lógica en una expresión.
Operador lógico OR (|)|)
Realiza una disyunción lógica en dos expresiones.
Operador de asignación y módulo (%=)
Divide dos números y asigna el resto al primer argumento.
Operador de módulo (%)
Divide dos números y devuelve el resto.
Operador de asignación y multiplicación (*=)
Divide dos números y asigna el resultado al primer argumento.
Operador de multiplicación (*)
Multiplica dos números.
new (Operador)
Crea un nuevo objeto.
Operador de asignación y desplazamiento a la derecha (>>=)
Desplaza los bits de una expresión hacia la derecha manteniendo el signo y asigna el resultado al primer argumento.
Operador de asignación y resta (-=)
Resta un número a otro y asigna el resultado al primer argumento.
Operador de resta (-)
Indica el valor negativo de una expresión numérica o resta un número a otro.
Operador typeof
Devuelve una cadena que identifica el tipo de datos de una expresión.
Operador de asignación y desplazamiento a la derecha sin signo (>>>=)
Realiza un desplazamiento a la derecha sin signo de los bits de una expresión y asigna el resultado al primer argumento.
Operador de desplazamiento bit a bit a la derecha (>>>)
Realiza un desplazamiento a la derecha sin signo de los bits de una expresión.
Operador void
Evita que una expresión devuelva un valor.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Operadores de JScript
Proporciona información general y conceptual sobre los operadores utilizados en JScript y ofrece vínculos a temas que explican
la sintaxis correcta de cada operador y la importancia de la prioridad de los operadores.
Precedencia de operadores
Proporciona una lista que contiene información sobre la prioridad de ejecución de los operadores de JScript.
Resumen de operadores
Enumera los operadores de JScript y ofrece vínculos a los temas que explican su correcto uso.
JScript .NET
result += expression
Arguments
result
Any variable.
expression
Any expression.
Remarks
Using this operator is almost the same as specifying result = result + expression, except that result is only evaluated once.
Requirements
Version 1
See Also
Addition Operator (+) | Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
expression1 + expression2
Arguments
expression1
Any expression.
expression2
Any expression.
Remarks
The type of the expressions determines the behavior of the + operator.
If Then Result Type
Both expressions are char Concatenate String
Both expressions are numeric Add numeric
Both expressions are strings Concatenate String
One expression is char and the other is numeric Add char
One expression is char and the other is a string Concatenate String
One expression is numeric and the other is a string Concatenate String
For concatenation, numbers are coerced into a string representation of the numeric value, and chars are considered to be strings
of length 1. For addition of a char and a number, the char is coerced into a numeric value, and the two numbers are added.
Note In scenarios where type annotation is not used, numeric data may be stored as a strings. Use explicit type
conversion or type annotate variables to ensure that the addition operator does not treat numbers as strings, or vice
versa.
Example
The following example illustrates how the addition operator processes expressions of different types.
Requirements
Version 1
See Also
Addition Assignment Operator (+=) | Operator Precedence | Operator Summary | Type Conversion
JScript .NET
result = expression
Arguments
result
Any variable.
expression
Any expression.
Remarks
The = operator returns the value of expression and assigns that value into variable. This means that you can chain assignment
operators as follows:
j = k = l = 0;
The data type of expression must be coercible to the data type of result.
Requirements
Version 1
See Also
Operator Precedence | Operator Summary
JScript .NET
Argumentos
result
Cualquier variable numérica.
expression
Cualquier expresión numérica.
Comentarios
Si se utiliza este operador, el resultado es prácticamente el mismo que si se especifica result = result & expression, con la
diferencia de que result se evalúa sólo una vez.
El operador &= convierte los argumentos en tipos de datos coincidentes. Entonces, el operador &= obtiene la representación
binaria de los valores de los argumentos result y expression y realiza una operación AND bit a bit en ellos.
El resultado de esta operación se comporta de esta forma:
0101 (result)
1100 (expression)
----
0100 (output)
Cada vez que ambas expresiones tengan un 1 en un dígito, el resultado tendrá un 1 en ese dígito. En caso contrario, el resultado
tendrá un 0 en ese dígito.
Requisitos
Versión 1
Vea también
Operador AND bit a bit (&) | Operador de asignación (=) | Precedencia de operadores | Resumen de operadores |
Conversión realizada por operadores bit a bit
JScript .NET
Arguments
expression1
Any numeric expression.
expression2
Any numeric expression.
Remarks
The << operator shifts the bits of expression1 left by the number of bits specified in expression2. The data type of expression1
determines the data type returned by this operator.
The << operator masks expression2 to avoid shifting expression1 by too much. Otherwise, if the shift amount exceeded the
number of bits in the data type of expression1, all the original bits would be shifted away to give a trivial result. To ensure that
each shift leaves at least one of the original bits, the shift operators use the following formula to calculate the actual shift amount:
mask expression2 (using the bitwise AND operator) with one less than the number of bits in expression1.
Example
For example:
var temp
temp = 14 << 2
The variable temp has a value of 56 because 14 (00001110 in binary) shifted left two bits equals 56 (00111000 in binary).
To illustrate how the masking works, consider the following example.
Requirements
Version 1
See Also
Left Shift Assignment Operator (<<=)| Bitwise Right Shift Operator (>>) | Unsigned Right Shift Operator (>>>) |
Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
~ expression
Arguments
expression
Any numeric expression.
Remarks
The ~ operator looks at the binary representation of the values of the expression and does a bitwise negation operation on it. The
result of this operation behaves as follows:
0101 (expression)
----
1010 (result)
Any digit that is a 1 in the expression becomes a 0 in the result. Any digit that is a 0 in the expression becomes a 1 in the result.
When the ~ operator acts on an operand of an integral data type, it performs no coercion and returns a value of the same data
type as the operand. When the operand is of a non-integral data type, the value is coerced to type int before the operation is
performed, and the return value of the operator is of type int.
Requirements
Version 1
See Also
Logical NOT Operator (!) | Operator Precedence | Operator Summary
JScript .NET
result |= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result | expression, except that result is only evaluated once.
The |= operator coerces the arguments to matching data types. Then the |= operator looks at the binary representation of the
values of result and expression and does a bitwise OR operation on them. The result of this operation behaves like this:
0101 (result)
1100 (expression)
----
1101 (output)
Any time either of the expressions has a 1 in a digit, the result has a 1 in that digit. Otherwise, the result has a 0 in that digit.
Requirements
Version 1
See Also
Bitwise OR Operator (|) | Assignment Operator (=) | Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
expression1 | expression2
Argumentos
expression1
Cualquier expresión numérica.
expression2
Cualquier expresión numérica.
Comentarios
El operador |= convierte los argumentos en tipos de datos coincidentes. Entonces, el operador | obtiene la representación binaria
de los valores de dos expresiones y realiza una operación OR bit a bit en ellas. Los tipos de datos de los argumentos determinan
el tipo de datos devuelto por este operador.
El resultado de esta operación se comporta de la siguiente manera:
0101 (expression1)
1100 (expression2)
----
1101 (result)
Cada vez que cualquiera de las dos expresiones tenga un 1 en un dígito, el resultado tendrá un 1 en ese dígito. En caso contrario,
el resultado tendrá un 0 en ese dígito.
Requisitos
Versión 1
Vea también
Operador de asignación y OR bit a bit (|=) | Precedencia de operadores | Resumen de operadores |
Conversión realizada por operadores bit a bit
JScript .NET
Arguments
expression1
Any numeric expression.
expression2
Any numeric expression.
Remarks
The >> operator shifts the bits of expression1 right by the number of bits specified in expression2. The sign bit of expression1 is
used to fill the digits from the left. Digits shifted off to the right are discarded. The data type of expression1 determines the data
type returned by this operator.
The >> operator masks expression2 to avoid shifting expression1 by too much. Otherwise, if the shift amount exceeded the
number of bits in the data type of expression1, all the original bits would be shifted away to give a trivial result. To ensure that
each shift leaves at least one of the original bits, the shift operators use the following formula to calculate the actual shift amount:
mask expression2 (using the bitwise AND operator) with one less than the number of bits in expression1.
Example
For example, after the following code is evaluated, temp has a value of -4: -14 (11110010 in binary) shifted right two bits equals -
4 (11111100 in binary).
var temp
temp = -14 >> 2
Requirements
Version 1
See Also
Bitwise Left Shift Operator (<<) | Right Shift Assignment Operator (>>=) | Unsigned Right Shift Operator (>>>) |
Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
result ^= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result ^ expression, except that result is only evaluated once.
The ^= operator coerces the arguments to matching data types. Then the ^= operator looks at the binary representation of the
values of two expressions and does a bitwise exclusive OR operation on them. The result of this operation behaves as follows:
0101 (result)
1100 (expression)
----
1001 (result)
When one, and only one, of the expressions has a 1 in a digit, the result has a 1 in that digit. Otherwise, the result has a 0 in that
digit.
Requirements
Version 1
See Also
Bitwise XOR Operator (^) | Assignment Operator (=) | Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
expression1 ^ expression2
Arguments
expression1
Any numeric expression.
expression2
Any numeric expression.
Remarks
The ^ operator coerces the arguments to matching data types. Then the ^ operator looks at the binary representation of the
values of two expressions and does a bitwise exclusive OR operation on them. The data types of the arguments determine the
data type returned by this operator.
The result of this operation behaves as follows:
0101 (expression1)
1100 (expression2)
----
1001 (result)
When one, and only one, of the expressions has a 1 in a digit, the result has a 1 in that digit. Otherwise, the result has a 0 in that
digit.
Requirements
Version 1
See Also
Bitwise XOR Assignment Operator (^=) | Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
expression1, expression2
Arguments
expression1
Any expression.
expression2
Any expression.
Remarks
The , operator causes the expressions on either side of it to be executed in left-to-right order, and obtains the value of the
expression on the right. The most common use for the , operator is in the increment expression of a for loop. For example:
var i, j, k;
for (i = 0; i < 10; i++, j++) {
k = i + j;
}
The for statement only allows a single expression to be executed at the end of every pass through a loop. The , operator is used to
allow multiple expressions to be treated as a single expression, thereby getting around the restriction.
Requirements
Version 1
See Also
for Statement | Operator Precedence | Operator Summary
JScript .NET
Comparison Operators
Returns a Boolean value indicating the result of the comparison.
Arguments
expression1
Any expression.
comparisonoperator
Any comparison operator (<, >, <=, >=, ==, !=, ===, !==)
expression2
Any expression.
Remarks
When comparing strings, JScript uses the Unicode character value of the string expression.
The following describes how the different groups of operators behave depending on the types and values of expression1 and
expression2:
Relational (<, >, <=, >=)
Attempt to convert both expression1 and expression2 into numbers.
If both expressions are strings, do a lexicographical string comparison.
If either expression is NaN, return false.
Negative zero equals Positive zero.
Negative Infinity is less than everything including itself.
Positive Infinity is greater than everything including itself.
Equality (==, !=)
If the types of the two expressions are different, attempt to convert them to string, number, or Boolean.
NaN is not equal to anything including itself.
Negative zero equals positive zero.
null equals both null and undefined.
Values are considered equal if they are identical strings, numerically equivalent numbers, the same object, identical Boolean
values, or (if different types) they can be coerced into one of these situations.
Every other comparison is considered unequal.
Identity (===, !==)
These operators behave identically to the equality operators except no type conversion is done, and the types must be the same to
be considered equal.
Requirements
Version 1
See Also
Operator Precedence | Operator Summary
JScript .NET
Arguments
test
Any Boolean expression.
expression1
An expression returned if test is true. May be a comma expression.
expression2
An expression returned if test is false. May be a comma expression.
Remarks
The ?: operator can be used as a shortcut for an if...else statement. It is typically used as part of a larger expression where an
if...else statement would be awkward. For example:
The example creates a string containing "Good evening." if it is after 6pm. The equivalent code using an if...else statement would
look as follows:
Requirements
Version 1
See Also
if...else Statement | Operator Precedence | Operator Summary
JScript .NET
delete Operator
Deletes a property from an object, removes an element from an array, or removes an entry from an IDictionary object.
delete expression
Arguments
expression
Required. Any expression that results in a property reference, array element, or IDictionary object.
Remarks
If the result of expression is an object, the property specified in expression exists, and the object will not allow it to be deleted,
false is returned.
In all other cases, true is returned.
Example
The following example illustrates a use of the delete operator.
Requirements
Version 3
See Also
IDictionary Interface | Operator Precedence | Operator Summary
JScript .NET
result /= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result / expression, except that result is only evaluated once.
Requirements
Version 1
See Also
Division Operator (/) | Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
number1 / number2
Arguments
number1
Any numeric expression.
number2
Any numeric expression.
Remarks
If number1 is a finite, non-zero number, and number2 is zero, the result of the division is Infinity if the number1 is positive, and -
Infinity if negative. If both number1 and number2 are zero, the result is NaN.
Requirements
Version 1
See Also
Division Assignment Operator (/=) | Operator Precedence | Operator Summary
JScript .NET
in Operator
Tests for the existence of a property in an object.
property in object
Arguments
property
Required. An expression that evaluates to a string.
object
Required. Any object.
Remarks
The in operator checks if an object has a property named property. It also checks the object's prototype to see if property is part
of the prototype chain. If property is in the object or prototype chain, the in operator returns true, otherwise it returns false.
The in operator should not be confused with the for...in statement.
Note To test if the object itself has a property, and does not inherit the property from the prototype chain, use the
object's hasOwnProperty method.
Example
The following example illustrates a use of the in operator.
Requirements
Version 1
See Also
Operator Precedence | Operator Summary | for...in Statement | hasOwnProperty Method
JScript .NET
++variable
--variable
variable++
variable--
Argumentos
variable
Cualquier variable numérica.
Comentarios
Los operadores de incremento y decremento se utilizan como una forma abreviada de modificar el valor almacenado en una
variable y tener acceso a éste. En la sintaxis de prefijos y postfijos se puede utilizar cualquier operador.
Si... Acción equivalente Valor devuelto
++variable variable += 1 valor de variable tras incrementar
variable++ variable += 1 valor de variable antes de incrementa
r
--variable variable -= 1 valor de variable tras disminuir
variable-- variable -= 1 valor de variable antes de disminuir
Ejemplo
En el ejemplo siguiente se ilustran las diferencias entre la sintaxis de los prefijos y de los postfijos en el operador ++.
Requisitos
Versión 1
Vea también
Precedencia de operadores | Resumen de operadores
JScript .NET
instanceof Operator
Returns a Boolean value that indicates whether or not an object is an instance of a particular class or constructed function.
Arguments
object
Required. Any object expression.
class
Required. Any object class or constructed function.
Remarks
The instanceof operator returns true if object is an instance of class or constructed function. It returns false if object is not an
instance of the specified class or function, or if object is null.
The JScript Object is special. An object is only considered an instance of Object if and only if the object was constructed with the
Object constructor.
Example 1
The following example illustrates a use of the instanceof operator to check the type of a variable.
Example 2
The following example illustrates a use of the instanceof operator to check instances of a constructed function.
true
false
Example 3
The following example illustrates how the instanceof operator checks if objects are instances of Object.
ob = new Object;
print(ob instanceof Object);
false
true
Requirements
Version 5
See Also
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result << expression, except that result is only evaluated once.
The <<= operator shifts the bits of result left by the number of bits specified in expression. The operator masks expression to
avoid shifting result by too much. Otherwise, if the shift amount exceeded the number of bits in the data type of result, all the
original bits would be shifted away to give a trivial result. To ensure that each shift leaves at least one of the original bits, the shift
operators use the following formula to calculate the actual shift amount: mask expression (using the bitwise AND operator) with
one less than the number of bits in result.
Example
For example:
var temp
temp = 14
temp <<= 2
The variable temp has a value of 56 because 14 (00001110 in binary) shifted left two bits equals 56 (00111000 in binary). Bits are
filled in with zeroes when shifting.
To illustrate how the masking works, consider the following example.
Requirements
Version 1
See Also
Bitwise Left Shift Operator (<<) | Bitwise Right Shift Operator (>>) | Unsigned Right Shift Operator (>>>) |
Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
!expression
Arguments
expression
Any expression.
Remarks
The following table illustrates how the result is determined.
If expression coerces to Then result is
true false
false true
All unary operators, such as the ! operator, evaluate expressions as follows:
If applied to undefined or null expressions, a run-time error is raised.
Objects are converted to strings.
Strings are converted to numbers if possible. If not, a run-time error is raised.
Boolean values are treated as numbers (0 if false, 1 if true).
The operator is applied to the resulting number.
For the ! operator, if expression is nonzero, result is zero. If expression is zero, result is 1.
Requirements
Version 1
See Also
Bitwise NOT Operator (~) | Operator Precedence | Operator Summary
JScript .NET
expression1 || expression2
Arguments
expression1
Any expression.
expression2
Any expression.
Remarks
If either or both expressions evaluate to true, the result is true. The following table illustrates how the result is determined:
If expression1 coerces to And expression2 coerces to The result is The result coerces to
true true expression1 true
true false expression1 true
false true expression2 true
false false expression2 false
JScript uses the following rules for converting non-Boolean values to Boolean values:
All objects are considered true.
Strings are considered false if and only if they are empty.
null and undefined are considered false.
Numbers are false if, and only if, they are 0.
Requirements
Version 1
See Also
Operator Precedence | Operator Summary
JScript .NET
result %= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result % expression, except that result is only evaluated once.
Requirements
Version 1
See Also
Modulus Operator (%) | Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
number1 % number2
Arguments
number1
Any numeric expression.
number2
Any numeric expression.
Remarks
The modulus, or remainder, operator divides number1 by number2 and returns only the remainder. The sign of the result is the
same as the sign of number1. The value of the result is between 0 and the absolute value of number2.
The arguments to the modulus operator may be floating-point numbers, so that 5.6 % 0.5 returns 0.1.
Example
The following example illustrates a use of the modulus operator.
Requirements
Version 1
See Also
Modulus Assignment Operator (%=) | Operator Precedence | Operator Summary
JScript .NET
result *= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result * expression, except that result is only evaluated once.
Requirements
Version 1
See Also
Multiplication Operator (*) | Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
number1 * number2
Arguments
number1
Any numeric expression.
number2
Any numeric expression.
Remarks
The multiplication operator multiplies number1 by number2 and returns the result. If either number is NaN, the result is NaN.
Multiplication of Infinity by zero gives a result of NaN, while multiplying Infinity by any non-zero number (including Infinity)
gives a result of Infinity.
Requirements
Version 1
See Also
Multiplication Assignment Operator (*=) | Operator Precedence | Operator Summary
JScript .NET
new Operator
Creates a new object.
Arguments
constructor
Required. Object's construction. The parentheses can be omitted if the constructor takes no arguments.
arguments
Optional. Any arguments to be passed to the new object's constructor.
Remarks
The new operator performs the following tasks:
It creates an object with no members.
It calls the constructor for that object, passing a reference to the newly created object as the this pointer.
The constructor then initializes the object according to the arguments passed to the constructor.
Example
These examples demonstrate some uses of the new operator.
Requirements
Version 1
See Also
function Statement
JScript .NET
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result >> expression, except that result is only evaluated once.
The >>= operator shifts the bits of result right by the number of bits specified in expression. The sign bit of result is used to fill the
digits from the left. Digits shifted off to the right are discarded. The operator masks expression to avoid shifting result by too
much. Otherwise, if the shift amount exceeded the number of bits in the data type of result, all the original bits would be shifted
away to give a trivial result. To ensure that each shift leaves at least one of the original bits, the shift operators use the following
formula to calculate the actual shift amount: mask expression (using the bitwise AND operator) with one less than the number of
bits in result.
Example
For example, after the following code is evaluated, temp has a value of -4: 14 (11110010 in binary) shifted right two bits equals -4
(11111100 in binary).
var temp
temp = -14
temp >>= 2
Requirements
Version 1
See Also
Bitwise Left Shift Operator (<<) | Bitwise Right Shift Operator (>>) | Unsigned Right Shift Operator (>>>) |
Assignment Operator (=) | Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
result -= expression
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result - expression, except that result is only evaluated once.
Requirements
Version 1
See Also
Subtraction Operator (-) | Assignment Operator (=) | Operator Precedence | Operator Summary
JScript .NET
number1 - number2
Syntax 2
-number
Arguments
number1
Any numeric expression.
number2
Any numeric expression.
number
Any numeric expression.
Remarks
In Syntax 1, the - operator is the arithmetic subtraction operator used to find the difference between two numbers. In Syntax 2, the
- operator is used as the unary negation operator to indicate the negative value of an expression.
For Syntax 2, as for all unary operators, expressions are evaluated as follows:
If applied to undefined or null expressions, a run-time error is raised.
Objects are converted to strings.
Strings are converted to numbers if possible. If not, a run-time error is raised.
Boolean values are treated as numbers (0 if false, 1 if true).
The operator is applied to the resulting number. In Syntax 2, if the resulting number is nonzero, result is equal to the resulting
number with its sign reversed. If the resulting number is zero, result is zero.
Requirements
Version 1
See Also
Subtraction Assignment Operator (-=) | Operator Precedence | Operator Summary
JScript .NET
typeof Operator
Returns a string that identifies the data type of an expression.
typeof[(]expression[)] ;
Arguments
expression
Required. Any expression.
Remarks
The typeof operator returns type information as a string. There are six possible values that typeof returns: "number", "string",
"boolean", "object", "function", and "undefined".
The parentheses are optional in the typeof syntax.
Note : All expressions in JScript .NET have a GetType method. This method returns the data type (not a string
representing the data type) of the expression. The GetType method provides more information than the typeof
operator.
Example
Requirements
Version 1
See Also
Operator Precedence | Operator Summary | GetType Method
JScript .NET
Arguments
result
Any numeric variable.
expression
Any numeric expression.
Remarks
Using this operator is almost the same as specifying result = result >>> expression, except that result is only evaluated once.
The >>>= operator shifts the bits of result right by the number of bits specified in expression. Zeroes are filled in from the left.
Digits shifted off to the right are discarded. The operator masks expression to avoid shifting result by too much. Otherwise, if the
shift amount exceeded the number of bits in the data type of result, all the original bits would be shifted away to give a trivial
result. To ensure that each shift leaves at least one of the original bits, the shift operators use the following formula to calculate
the actual shift amount: mask expression (using the bitwise AND operator) with one less than the number of bits in result.
Example
For example:
var temp
temp = -14
temp >>>= 2
The variable temp has a value of 1073741820 as -14 (11111111 11111111 11111111 11110010 in binary) shifted right two bits
equals 1073741820 (00111111 11111111 11111111 11111100 in binary).
To illustrate how the masking works, consider the following example.
Requirements
Version 1
See Also
Unsigned Right Shift Operator (>>>) | Bitwise Left Shift Operator (<<) | Bitwise Right Shift Operator (>>) |
Assignment Operator (=) | Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
Arguments
expression1
Any numeric expression.
expression2
Any numeric expression.
Remarks
The >>> operator shifts the bits of expression1 right by the number of bits specified in expression2. Zeroes are filled in from the
left. Digits shifted off to the right are discarded. The data type of expression1 determines the data type returned by this operator.
The >>> operator masks expression2 to avoid shifting expression1 by too much. Otherwise, if the shift amount exceeded the
number of bits in the data type of expression1, all the original bits would be shifted away to give a trivial result. To ensure that
each shift leaves at least one of the original bits, the shift operators use the following formula to calculate the actual shift amount:
mask expression2 (using the bitwise AND operator) with one less than the number of bits in expression1.
Example
For example:
var temp
temp = -14 >>> 2
The variable temp has a value of 1073741820 as -14 (11111111 11111111 11111111 11110010 in binary) shifted right two bits
equals 1073741820 (00111111 11111111 11111111 11111100 in binary).
To illustrate how the masking works, consider the following example.
Requirements
Version 1
See Also
Unsigned Right Shift Assignment Operator (>>>=) | Bitwise Left Shift Operator (<<) | Bitwise Right Shift Operator (>>) |
Operator Precedence | Operator Summary | Coercion By Bitwise Operators
JScript .NET
void Operator
Prevents an expression from returning a value.
void expression
Arguments
expression
Required. Any expression.
Remarks
The void operator evaluates its expression, and returns undefined. It is most useful in situations where you want an expression
evaluated but do not want the results visible to the remainder of the script.
Requirements
Version 2
See Also
Operator Precedence | Operator Summary
JScript .NET
Propiedades
Una propiedad es un valor o un conjunto de valores (en forma de matriz u objeto) que es miembro de un objeto. Las secciones
que se muestran a continuación proporcionan vínculos a información que explica cómo utilizar las propiedades en JScript.
En esta sección
0...n (Propiedades)
Devuelve el valor real de argumentos individuales de un objeto arguments devuelto por la propiedad arguments de una
función en ejecución.
$1...$9 (Propiedades)
Devuelve las nueve partes memorizadas más recientemente que se encontraron durante la comparación de modelos.
arguments (Propiedad)
Devuelve el objeto arguments para la propiedad object.caller del objeto Function que se está ejecutando actualmente.
callee (Propiedad)
Devuelve el objeto Function que se está ejecutando, que es el texto del cuerpo del objeto Function especificado.
caller (Propiedad)
Devuelve una referencia a la función invocada por la función actual.
constructor (Propiedad)
Especifica la función que crea un objeto.
description (Propiedad)
Devuelve o establece la cadena descriptiva asociada a un error específico.
E (Propiedad)
Devuelve la constante matemática e, base de los logaritmos naturales.
global (Propiedad)
Devuelve un valor Boolean que indica el estado del indicador global (g) utilizado con una expresión regular.
ignoreCase (Propiedad)
Devuelve un valor Boolean que indica el estado del indicador ignoreCase (i) que se utiliza con una expresión regular.
index (Propiedad)
Devuelve la posición del carácter donde comienza la primera coincidencia correcta en una cadena de búsqueda.
Infinity (Propiedad)
Devuelve el valor inicial de Number.POSITIVE_INFINITY.
input ($_) (Propiedad)
Devuelve la cadena con la que se realizó la búsqueda de una expresión regular.
lastIndex (Propiedad)
Devuelve la posición del carácter donde comienza la siguiente coincidencia en una cadena de búsqueda.
lastMatch ($&) (Propiedad)
Devuelve los últimos caracteres coincidentes de cualquier búsqueda de expresiones regulares.
lastParen ($+) (Propiedad)
Devuelve la última subcoincidencia entre paréntesis, si la hubiera, de una búsqueda de expresiones regulares.
leftContext ($`) (Propiedad)
Devuelve los caracteres entre el principio de una cadena de búsqueda y la posición anterior al principio de la última
coincidencia.
length (Propiedad, arguments)
Devuelve el número real de argumentos pasados a una función por el llamador.
length (Propiedad, Array)
Devuelve un valor entero que supera en uno al elemento mayor definido en una matriz.
length (Propiedad, Function)
Devuelve el número de argumentos definidos para una función.
length (Propiedad, String)
Devuelve la longitud de un objeto String.
LN10 (Propiedad)
Devuelve el logaritmo natural de 10.
LN2 (Propiedad)
Devuelve el logaritmo natural de 2.
LOG10E (Propiedad)
Devuelve el logaritmo en base 10 de e, base de los logaritmos naturales.
LOG2E (Propiedad)
Devuelve el logaritmo en base 2 de e, base de los logaritmos naturales.
MAX_VALUE (Propiedad)
Devuelve el mayor número que se puede representar en JScript. Es igual a aproximadamente 1,79E+308.
message (Propiedad)
Devuelve una cadena con un mensaje de error.
MIN_VALUE (Propiedad)
Devuelve el número más próximo a cero que se puede representar en JScript. Es igual a aproximadamente 5,00E-324.
multiline (Propiedad)
Devuelve un valor Boolean que indica el estado del indicador multilínea (m) que se utiliza con una expresión regular.
name (Propiedad)
Devuelve el nombre de un error.
NaN (Propiedad)
Valor especial que indica que una expresión aritmética ha devuelto un valor que no es un número.
NaN (Propiedad, Global)
Devuelve el valor especial NaN que indica que una expresión no es un número.
NEGATIVE_INFINITY (Propiedad)
Devuelve un valor negativo superior al mayor número negativo (-Number.MAX_VALUE) que se puede representar en JScript.
number (Propiedad)
Devuelve un valor negativo superior al mayor número negativo (-Number.MAX_VALUE) que se puede representar en JScript.
PI (Propiedad)
Devuelve la relación entre la longitud de una circunferencia y su diámetro, que es aproximadamente 3,141592653589793.
POSITIVE_INFINITY (Propiedad)
Devuelve un valor superior al mayor número (Number.MAX_VALUE) que se puede representar en JScript.
propertyIsEnumerable (Propiedad)
Devuelve un valor Boolean que indica si una propiedad especificada forma parte de un objeto y si se puede enumerar.
prototype (Propiedad)
Devuelve una referencia al prototipo correspondiente a una clase de objetos.
rightContext ($') (Propiedad)
Devuelve los caracteres entre la posición siguiente a la última coincidencia y el final de la cadena de búsqueda.
source (Propiedad)
Devuelve una copia del texto del modelo de una expresión regular.
SQRT1_2 (Propiedad)
Devuelve la raíz cuadrada de 0,5 o uno dividido por la raíz cuadrada de 2.
SQRT2 (Propiedad)
Devuelve la raíz cuadrada de 2.
undefined (Propiedad)
Devuelve el valor inicial de undefined.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Referencia de .NET Framework
Muestra vínculos a temas que explican la sintaxis y estructura de la biblioteca de clases de .NET Framework y otros elementos
esenciales.
JScript .NET
0...n Properties
Returns the value of individual arguments from an arguments object returned by the arguments property of an executing
function.
[function.]arguments[[n]]
Arguments
function
Optional. The name of the currently executing Function object.
n
Required. Non-negative integer in the range of 0 to arguments.length-1 where 0 represents the first argument and
arguments.length-1 represents the final argument.
Remarks
The values returned by the 0...n properties are the values passed to the executing function. While the arguments object is not an
array, the individual arguments that comprise the arguments object are accessed the same way that array elements are accessed.
Note The arguments object is not available when running in fast mode, the default for JScript .NET. To compile a
program from the command line that uses the arguments object, you must turn off the fast option by using /fast-. It
is not safe to turn off the fast option in ASP.NET because of threading issues. For more information, see
arguments Object.
Example
The following example illustrates the use of the 0...n properties of the arguments object.
function argTest(){
var s = "";
s += "The individual arguments are:\n"
for (var n=0; n< arguments.length; n++){
s += "argument " + n;
s += " is " + argTest.arguments[n] + "\n";
}
return(s);
}
print(argTest(1, 2, "hello", new Date()));
After compiling this program with the /fast- option, the output of this program is:
Requirements
Version 5.5
See Also
Properties
Applies To: arguments Object | Function object
JScript .NET
$1...$9 Properties
Returns the nine most-recently memorized portions found during pattern matching. Read-only.
RegExp.$n
Arguments
RegExp
Required. The global RegExp object.
n
Required. An integer from 1 through 9.
Remarks
The value of the $1...$9 properties is modified whenever a successful parenthesized match is made. Any number of parenthesized
substrings may be specified in a regular expression pattern, but only the nine most recent can be stored.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the $1...$9 properties:
var s : String;
var re : RegExp = new RegExp("d(b+)(d)","ig");
var str : String = "cdbBdbsbdbdz";
var arr : Array = re.exec(str);
s = "$1 contains: " + RegExp.$1 + "\n";
s += "$2 contains: " + RegExp.$2 + "\n";
s += "$3 contains: " + RegExp.$3;
print(s);
After compiling with the /fast- option, the output of this program is:
$1 contains: bB
$2 contains: d
$3 contains:
Requirements
Version 1
See Also
Regular Expression Syntax
Applies To: RegExp Object
JScript .NET
arguments Property
Returns the arguments object for the currently executing Function object.
[function.]arguments
Arguments
function
Optional. The name of the currently executing Function object.
Remarks
The arguments property allows a function to handle a variable number of arguments. The length property of the arguments
object contains the number of arguments passed to the function. The individual arguments contained in the arguments object
can be accessed in the same way array elements are accessed.
Note The arguments object is not available when running in fast mode, the default for JScript .NET. To compile a
program from the command line that uses the arguments object, you must turn off the fast option by using /fast-. It
is not safe to turn off the fast option in ASP.NET because of threading issues. For more information, see
arguments Object.
Example
The following example illustrates the use of the arguments property.
function argTest(){
var s = "";
s += "The individual arguments are:\n"
for (var n=0; n< arguments.length; n++){
s += "argument " + n;
s += " is " + argTest.arguments[n] + "\n";
}
return(s);
}
print(argTest(1, 2, "hello", new Date()));
After compiling this program with the /fast- option, the output of this program is:
Requirements
Version 2
See Also
Arguments Object | function Statement
Applies To: Function Object
JScript .NET
callee Property
Returns the Function object being executed, that is, the body text of the specified Function object.
[function.]arguments.callee
Arguments
function
Optional. The name of the currently executing Function object.
Remarks
The callee property is a member of the arguments object that becomes available only when the associated function is executing.
The initial value of the callee property is the Function object being executed. This allows anonymous functions to be recursive.
Note The arguments object is not available when running in fast mode, the default for JScript .NET. To compile a
program from the command line that uses the arguments object, you must turn off the fast option by using /fast-. It
is not safe to turn off the fast option in ASP.NET because of threading issues. For more information, see
arguments Object.
Example
function factorial(n) {
if (n <= 0)
return 1;
else
return n * arguments.callee(n - 1)
}
print(factorial(3));
After compiling this program with the /fast- option, the output of this program is:
Requirements
Version 5.5
See Also
function Statement
Applies To: arguments Object | Function object
JScript .NET
caller Property
Returns a reference to the function that invoked the current function.
function.caller
Arguments
function
Required. The name of the currently executing Function object.
Remarks
The caller property is only defined for a function while that function is executing. If the function is called from the top level of a
JScript program, caller contains null.
If the caller property is used in a string context, the result is the same as functionName.toString, that is, the decompiled text of
the function is displayed.
Note The caller property is not available when running in fast mode, the default for JScript .NET. To compile a
program from the command line that uses the caller property, you must turn off the fast option by using /fast-. It is
not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the caller property.
function callLevel(){
if (callLevel.caller == null)
print("callLevel was called from the top level.");
else {
print("callLevel was called by:");
print(callLevel.caller);
}
}
function testCall() {
callLevel()
}
// Call callLevel directly.
callLevel();
// Call callLevel indirectly.
testCall();
After compiling this program with the /fast- option, the output of this program is:
Requirements
Version 2
See Also
function Statement
Applies To: arguments Object | Function object
JScript .NET
constructor Property
Specifies the function that creates an object.
object.constructor
Arguments
object
Required. The name of an object or function.
Remarks
The constructor property is a member of the prototype of every object that has a prototype. This includes all intrinsic JScript
objects except the arguments, Enumerator, Error, Global, Math, RegExp, Regular Expression, and VBArray objects. The
constructor property contains a reference to the function that constructs instances of that particular object.
Class-based objects do not have a constructor property.
Example
The following example illustrates the use of the constructor property.
function testObject(ob) {
if (ob.constructor == String)
print("Object is a String.");
else if (ob.constructor == MyFunc)
print("Object is constructed from MyFunc.");
else
print("Object is neither a String or constructed from MyFunc.");
}
// A constructor function.
function MyFunc() {
// Body of function.
}
Object is a String.
Object is constructed from MyFunc.
Requirements
Version 2
See Also
prototype Property
Applies To: Array Object | Boolean Object | Date Object | Function Object | Number Object | Object Object | String Object
JScript .NET
description (Propiedad)
Devuelve o establece la cadena descriptiva asociada a un error específico.
object.description
Argumentos
object
Necesario. Una instancia de un objeto Error.
Comentarios
La propiedad description es una cadena que contiene el mensaje de error asociado a un error específico. Utilice el valor
contenido en esta propiedad para avisar a un usuario de un error que no puede controlar la secuencia de comandos.
Las propiedades description y message hacen referencia al mismo mensaje; la propiedad description proporciona
compatibilidad con versiones anteriores, mientras que la propiedad message cumple el estándar ECMA.
Ejemplo
En el siguiente ejemplo se produce una excepción y se muestra la descripción del error.
function getAge(age) {
if(age < 0)
throw new Error("An age cannot be negative.")
print("Age is "+age+".");
}
Requisitos
Versión 5
Vea también
number (Propiedad) | message (Propiedad) | name (Propiedad)
Se aplica a: Error (objeto)
JScript .NET
E Property
Returns the mathematical constant e, the base of natural logarithms.
Math.E
Arguments
Math
Required. The global Math object.
Remarks
The E property is approximately equal to 2.718.
Requirements
Version 1
See Also
exp Method
Applies To: Math Object
JScript .NET
global Property
Returns a Boolean value indicating the state of the global flag (g) used with a regular expression.
rgExp.global
Arguments
rgExp
Required. An instance of a Regular Expression object.
Remarks
The global property is read-only, and returns true if the global flag is set for a regular expression, and returns false if it is not.
The default value is false.
The global flag, when used, indicates that a search should find all occurrences of the pattern within the searched string, not just
the first one. This is also known as global matching.
Example
The following example illustrates the use of the global property.
Requirements
Version 5.5
See Also
ignoreCase Property | multiline Property | Regular Expression Syntax
Applies To: Regular Expression Object
JScript .NET
ignoreCase Property
Returns a Boolean value indicating the state of the ignoreCase flag (i) used with a regular expression.
rgExp.ignoreCase
Arguments
rgExp
Required. An instance of a Regular Expression object.
Remarks
The ignoreCase property is read-only, and returns true if the ignoreCase flag is set for a regular expression, and returns false if
it is not. The default value is false.
The ignoreCase flag, when used, indicates that a search should ignore case sensitivity when matching the pattern within the
searched string.
Example
The following example illustrates the use of the ignoreCase property.
Requirements
Version 5.5
See Also
global property | multiline Property | Regular Expression Syntax
Applies To: Regular Expression Object
JScript .NET
index Property
Returns the character position where the first successful match begins in a searched string.
{RegExp | reArray}.index
Arguments
RegExp
Required. The global RegExp object.
reArray
Required. An array returned by the exec method of a Regular Expression object.
Remarks
The index property is zero-based.
The initial value of the RegExp.index property is –1. Its value is read-only and changes whenever a successful match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the index property. This function iterates a search string and prints out the index and
lastIndex values for each word in the string.
var src : String = "The rain in Spain falls mainly in the plain.";
var re : RegExp = /\w+/g;
var arr : Array;
while ((arr = re.exec(src)) != null)
print(arr.index + "-" + arr.lastIndex + "\t" + arr);
0-3 The
4-8 rain
9-11 in
12-17 Spain
18-23 falls
24-30 mainly
31-33 in
34-37 the
38-43 plain
Requirements
Version 3
See Also
Regular Expression Syntax | exec Method
Applies To: RegExp Object
JScript .NET
Infinity Property
Returns the value of Number.POSITIVE_INFINITY.
Infinity
Remarks
The Infinity property is a member of the Global object, and is made available when the scripting engine is initialized.
Requirements
Version 3
See Also
POSITIVE_INFINITY Property | NEGATIVE_INFINITY Property
Applies To: Global Object
JScript .NET
{RegExp | reArray}.input
Syntax 2
The $_ property may be used as shorthand for the input property for the RegExp object.
RegExp.$_
Arguments
RegExp
Required. The global RegExp object.
reArray
Required. An array returned by the exec method of a Regular Expression object.
Remarks
The value of input property is the string against which a regular expression search was performed.
The initial value of the RegExp.input property is an empty string, "". Its value is read-only and changes whenever a successful
match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the input property:
Requirements
Version 3
See Also
Regular Expression Syntax | exec Method
Applies To: RegExp Object
JScript .NET
lastIndex Property
Returns the character position where the next match begins in a searched string.
{RegExp | reArray}.lastIndex
Arguments
RegExp
Required. The global RegExp object.
reArray
Required. An array returned by the exec method of a Regular Expression object.
Remarks
The lastIndex property is zero-based, that is, the index of the first character is zero. Its initial value is –1. Its value is modified
whenever a successful match is made.
The lastIndex property of the RegExp object is modified by the exec and test methods of the RegExp object, and the match,
replace, and split methods of the String object.
The following rules apply to values of lastIndex:
If there is no match, lastIndex is set to -1.
If lastIndex is greater than the length of the string, test and exec fail and lastIndex is set to -1.
If lastIndex is equal to the length of the string, the regular expression matches if the pattern matches the empty string.
Otherwise, the match fails and lastIndex is reset to -1.
Otherwise, lastIndex is set to the next position following the most recent match.
The initial value of the RegExp.lastIndex property is –1. Its value is read-only and changes whenever a successful match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the lastIndex property. This function iterates a search string and prints out the index
and lastIndex values for each word in the string.
var src : String = "The rain in Spain falls mainly in the plain.";
var re : RegExp = /\w+/g;
var arr : Array;
while ((arr = re.exec(src)) != null)
print(arr.index + "-" + arr.lastIndex + "\t" + arr);
0-3 The
4-8 rain
9-11 in
12-17 Spain
18-23 falls
24-30 mainly
31-33 in
34-37 the
38-43 plain
Requirements
Version 3
See Also
RegExp.lastParen
Arguments
RegExp
Required. The global RegExp object.
Remarks
The initial value of the lastParen property is an empty string. The value of the lastParen property changes whenever a successful
match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the lastParen property:
After compiling this program with the /fast- option, the output of this program is:
$1 returns: bB
$2 returns: d
$3 returns:
input returns : cdbBdbsbdbdz
lastMatch returns: dbBd
leftContext returns: c
rightContext returns: bsbdbdz
lastParen returns: d
Requirements
Version 5.5
See Also
$1...$9 Properties | index Property | input Property ($_) | lastIndex Property | lastMatch Property ($&) | leftContext Property ($`) |
rightContext Property ($')
Applies To: RegExp Object
JScript .NET
RegExp.leftContext
Arguments
RegExp
Required. The global RegExp object.
Remarks
The initial value of the leftContext property is an empty string. The value of the leftContext property changes whenever a
successful match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the leftContext property:
After compiling this program with the /fast- option, the output of this program is:
$1 returns: bB
$2 returns: d
$3 returns:
input returns : cdbBdbsbdbdz
lastMatch returns: dbBd
leftContext returns: c
rightContext returns: bsbdbdz
lastParen returns: d
Requirements
Version 5.5
See Also
$1...$9 Properties | index Property | input Property ($_) | lastIndex Property | lastMatch Property ($&) | lastParen Property ($+) |
rightContext Property ($')
Applies To: RegExp Object
JScript .NET
[function.]arguments.length
Arguments
function
Optional. The name of the currently executing Function object.
Remarks
The length property of the arguments object is initialized by the scripting engine to the actual number of arguments passed to a
Function object when execution begins in that function.
Example
The following example illustrates the use of the length property of the arguments object.
print(argTest(42));
print(argTest(new Date(1999,8,7),"Sam",Math.PI));
After compiling with the /fast- option, the output of this program is:
Requirements
Version 5.5
See Also
arguments Property | length Property (Array) | length Property (String)
Applies To: arguments Object
JScript .NET
arrayObj.length
Arguments
arrayObj
Required. Any Array object.
Remarks
As the elements in a JScript array do not have to be contiguous, the length property is not necessarily the number of elements in
the array.
If a value smaller than its previous value is assigned to the length property, the array is truncated, and any elements with array
indexes equal to or greater than the new value of the length property are lost.
If a value larger than its previous value is assigned to the length property, the array is formally expanded, but no new elements
are created.
Example
The following example illustrates the use of the length property. An array is declared, and two elements are added to it. Since the
largest index in the array is 6, the length is 7.
Requirements
Version 2
See Also
length Property (Function) | length Property (String)
Applies To: Array Object
JScript .NET
function.length
Arguments
function
Required. The name of the currently executing Function object.
Remarks
The length property of a function is initialized by the scripting engine to the number of arguments in the function's definition
when an instance of the function is created.
What happens when a function is called with a number of arguments different from the value of its length property depends on
the function.
Example
The following example illustrates the use of the length property:
Requirements
Version 2
See Also
arguments Property | length Property (Array) | length Property (String)
Applies To: Function Object
JScript .NET
str.length
Arguments
str
Required. A string literal or the name of a String object.
Remarks
The length property contains an integer that indicates the number of characters in the String object. The last character in the
String object has an index of length - 1.
Requirements
Version 1
See Also
length Property (Array) | length Property (Function)
Applies To: String Object
JScript .NET
LN10 Property
Returns the natural logarithm of 10.
Math.LN10
Arguments
Math
Required. The global Math object.
Remarks
The LN10 property is approximately equal to 2.302.
Requirements
Version 1
See Also
length Property (Array) | length Property (Function)
Applies To: Math Object
JScript .NET
LN2 Property
Returns the natural logarithm of 2.
Math.LN2
Arguments
Math
Required. The global Math object.
Syntax
The LN2 property is approximately equal to 0.693.
Requirements
Version 1
See Also
length Property (Array) | length Property (Function)
Applies To: Math Object
JScript .NET
LOG10E Property
Returns the base-10 logarithm of e, the base of natural logarithms.
Math.LOG10E
Arguments
Math
Required. The global Math object.
Remarks
The LOG10E property, a constant, is approximately equal to 0.434.
Requirements
Version 1
See Also
length Property (Array) | length Property (Function)
Applies To: Math Object
JScript .NET
LOG2E Property
Returns the base-2 logarithm of e, the base of natural logarithms.
Math.LOG2E
Arguments
Math
Required. The global Math object.
Remarks
The LOG2E property, a constant, is approximately equal to 1.442.
Requirements
Version 1
See Also
length Property (Array) | length Property (Function)
Applies To: Math Object
JScript .NET
MAX_VALUE Property
Returns the largest number representable in JScript. Equal to approximately 1.79E+308.
Number.MAX_VALUE
Arguments
Number
Required. The global Number object.
Remarks
The Number object does not have to be created before the MAX_VALUE property can be accessed.
Requirements
Version 2
See Also
MIN_VALUE Property | NaN Property | NEGATIVE_INFINITY Property | POSITIVE_INFINITY Property | toString Method
Applies To: Number Object
JScript .NET
message (Propiedad)
Devuelve una cadena con un mensaje de error.
errorObj.message
Argumentos
errorObj
Necesario. Instancia del objeto Error.
Comentarios
La propiedad message es una cadena que contiene un mensaje de error asociado a un error específico. Utilice el valor contenido
en esta propiedad para avisar a un usuario de un error que no se puede o no se desea controlar.
Las propiedades description y message hacen referencia al mismo mensaje; la propiedad description proporciona
compatibilidad con versiones anteriores, mientras que la propiedad message cumple el estándar ECMA.
Ejemplo
En el siguiente ejemplo se produce una excepción y se muestra el mensaje de error.
function getAge(age) {
if(age < 0)
throw new Error("An age cannot be negative.")
print("Age is "+age+".");
}
Requisitos
Versión 5.5
Vea también
description (Propiedad) | name (Propiedad)
Se aplica a: Error (objeto)
JScript .NET
MIN_VALUE Property
Returns the number closest to zero representable in JScript. Equal to approximately 5.00E-324.
Number.MIN_VALUE
Arguments
Number
Required. The global Number object.
Remarks
The Number object does not have to be created before the MIN_VALUE property can be accessed.
Requirements
Version 2
See Also
MAX_VALUE Property | NaN Property | NEGATIVE_INFINITY Property | POSITIVE_INFINITY Property | toString Method
Applies To: Number Object
JScript .NET
multiline Property
Returns a Boolean value indicating the state of the multiline flag (m) used with a regular expression.
rgExp.multiline
Arguments
rgExp
Required. An instance of a Regular Expression object.
Remarks
The multiline property is read-only, and returns true if the multiline flag is set for a regular expression, and returns false if it is
not. The multiline property is true if the regular expression object was created with the m flag. The default value is false.
If multiline is false, "^" matches the position at the beginning of a string, and "$" matches the position at the end of a string. If
multiline is true, "^" matches the position at the beginning of a string as well as the position following a "\n" or "\r", and "$"
matches the position at the end of a string and the position preceding "\n" or "\r".
Example
The following example illustrates the use of the multiline property.
Requirements
Version 5.5
See Also
global property | ignoreCase Property | Regular Expression Syntax
Applies To: Regular Expression Object
JScript .NET
name (Propiedad)
Devuelve el nombre de un error.
errorObj.name
Argumentos
errorObj
Necesario. Instancia del objeto Error.
Comentarios
La propiedad name devuelve el nombre o el tipo de excepción de un error. Cuando se produce un error en tiempo de ejecución,
esta propiedad se establece en uno de los siguientes tipos de excepción nativos:
Tipo de excepción Significado
Error Este error es un error definido por el usuario, creado utilizando el constructor del objeto Error.
ConversionError Este error se produce cuando se intenta convertir un objeto en algo en lo que no se puede conve
rtir.
RangeError Este error se produce cuando se proporciona una función con un argumento que ha superado su
intervalo permitido. Por ejemplo, este error se produce si se intenta crear un objeto Array con u
na longitud que no sea un entero positivo válido.
ReferenceError Este error se produce cuando se ha detectado una referencia no válida. Por ejemplo, este error se
producirá si una referencia que se espera es null.
RegExpError Este error se produce cuando tiene lugar un error de compilación con una expresión regular. Sin
embargo, una vez compilada la expresión regular, este error no se puede producir. Por ejemplo,
este error se producirá si una expresión regular se declara con un modelo cuya sintaxis no sea vá
lida, o si los indicadores son distintos de i, g o m, o si contiene el mismo indicador más de una v
ez.
SyntaxError Este error se produce cuando se analiza el texto de origen y su sintaxis no es correcta. Por ejempl
o, este error se producirá si se llama a la función eval con un argumento que no sea un texto de
programa válido.
TypeError Este error se produce cuando el tipo real de un operando no coincide con el tipo que se espera.
Un ejemplo de este error consiste en una llamada a una función realizada sobre algo que no es u
n objeto o que no admite la llamada.
URIError Este error se produce cuando se detecta un indicador de recursos uniforme (URI, Uniform Resour
ce Indicator) que no es válido. Por ejemplo, este error se producirá si se encuentra un carácter no
válido en una cadena que se va a codificar o descodificar.
Ejemplo
En el siguiente ejemplo se produce una excepción y se muestra el error y su descripción.
function getAge(age) {
if(age < 0)
throw new Error("An age cannot be negative.")
print("Age is "+age+".");
}
// Pass the getAge an invalid argument.
try {
getAge(-5);
} catch(e) {
print(e.name);
print(e.description);
}
Requisitos
Versión 5.5
Vea también
description (Propiedad) | message (Propiedad) | number (Propiedad)
Se aplica a: Error (objeto)
JScript .NET
NaN Property
A special value that indicates an arithmetic expression returned a value that was not a number.
Number.NaN
Arguments
Number
Required. The global Number object.
Remarks
The Number object does not have to be created before the NaN property can be accessed.
NaN does not compare equal to any value, including itself. To test if a value is equivalent to NaN, use the isNaN method of the
Global object..
Requirements
Version 2
See Also
isNaN Method | MAX_VALUE Property | MIN_VALUE Property | NEGATIVE_INFINITY Property | POSITIVE_INFINITY Property |
toString Method
Applies To: Number Object
JScript .NET
NaN
Remarks
The NaN property (not a number) is a member of the Global object, and is made available when the scripting engine is
initialized.
NaN does not compare equal to any value, including itself. To test if a value is equivalent to NaN, use the isNaN method of the
Global object..
Requirements
Version 3
See Also
isNaN Method
Applies To: Global Object
JScript .NET
NEGATIVE_INFINITY Property
Returns a value more negative than the largest negative number (-Number.MAX_VALUE) representable in JScript.
Number.NEGATIVE_INFINITY
Arguments
Number
Required. The global Number object.
Remarks
The Number object does not have to be created before the NEGATIVE_INFINITY property can be accessed.
JScript displays NEGATIVE_INFINITY values as -Infinity. This value behaves mathematically as infinity.
Requirements
Version 2
See Also
MAX_VALUE Property | MIN_VALUE Property | NaN Property | POSITIVE_INFINITY Property | toString Method
Applies To: Number Object
JScript .NET
number Property
Returns or sets the numeric value associated with a specific error.
object.number
Arguments
object
Any instance of the Error object.
Remarks
An error number is a 32-bit value. The upper 16-bit word is the facility code, while the lower word is the actual error code. To read
off the actual error code, use the & (bitwise And) operator to combine the number property with the hexadecimal number 0xFFFF.
Example
The following example causes an exception to be thrown, and displays the error number.
function getAge(age) {
if(age < 0)
throw new Error(100)
print("Age is "+age+".");
}
100
Requirements
Version 5
See Also
description Property | message Property | name Property
Applies To: Error Object
JScript .NET
PI Property
Returns the value of the mathematical constant pi.
Math.PI
Arguments
Math
Required. The global Math object.
Syntax
The PI property is a constant approximately equal to 3.14159. It represents the ratio of the circumference of a circle to its
diameter.
Requirements
Version 1
See Also
Properties
Applies To: Math Object
JScript .NET
POSITIVE_INFINITY Property
Returns a value larger than the largest number (Number.MAX_VALUE) that can be represented in JScript.
Number.POSITIVE_INFINITY
Arguments
Number
Required. The global Number object.
Remarks
The Number object does not have to be created before the POSITIVE_INFINITY property can be accessed.
JScript displays POSITIVE_INFINITY values as Infinity. This value behaves mathematically as infinity.
Requirements
Version 2
See Also
MAX_VALUE Property | MIN_VALUE Property | NaN Property | NEGATIVE_INFINITY Property | toString Method
Applies To: Number Object
JScript .NET
propertyIsEnumerable Property
Returns a Boolean value indicating whether a specified property is part of an object and if it is enumerable.
object.propertyIsEnumerable(propName)
Arguments
object
Required. Instance of an object.
propName
Required. String value of a property name.
Remarks
The propertyIsEnumerable property returns true if propName exists in object and can be enumerated using a For...In loop. The
propertyIsEnumerable property returns false if object does not have a property of the specified name or if the specified
property is not enumerable. Typically, predefined properties are not enumerable while user-defined properties are always
enumerable.
The propertyIsEnumerable property does not consider objects in the prototype chain.
Example
The following example illustrates the use of the propertyIsEnumerable property.
true
Requirements
Version 5.5
See Also
Properties
Applies To: Object Object
JScript .NET
prototype Property
Returns a reference to the prototype for a class of objects.
object.prototype
Arguments
object
Required. The name of an object.
Remarks
Use the prototype property to provide a base set of functionality to a class of objects. New instances of an object "inherit" the
behavior of the prototype assigned to that object.
All intrinsic JScript objects have a prototype property that is read-only. Functionality may be added to the prototype, as in the
example, but the object may not be assigned a different prototype. However, user-defined objects may be assigned a new
prototype.
The method and property lists for each intrinsic object in this language reference indicate which ones are parts of the object's
prototype, and which are not.
Note The prototype property of a built-in object cannot be modified when running in fast mode, the default for
JScript .NET. To compile a program from the command line that uses the prototype property, you must turn off the
fast option by using /fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
Say you want to add a method to the Array object that returns the value of the largest element of the array. To do this, declare the
function, add it to Array.prototype, and then use it.
function array_max() {
var i, max = this[0];
for (i = 1; i < this.length; i++) {
if (max < this[i])
max = this[i];
}
return max;
}
Array.prototype.max = array_max;
var x = new Array(1, 2, 3, 4, 5, 6);
print(x.max());
After compiling the with the /fast- option, the output of the programs is:
Requirements
Version 2
See Also
constructor Property
Applies To: Array Object | Boolean Object | Date Object | Function Object | Number Object | Object Object | String Object
JScript .NET
RegExp.rightContext
Arguments
RegExp
Required. The global RegExp object.
Remarks
The initial value of the rightContext property is an empty string. The value of the rightContext property changes whenever a
successful match is made.
Note The properties of the RegExp object are not available when running in fast mode, the default for JScript .NET.
To compile a program from the command line that uses these properties, you must turn off the fast option by using
/fast-. It is not safe to turn off the fast option in ASP.NET because of threading issues.
Example
The following example illustrates the use of the rightContext property:
After compiling this program with the /fast- option, the output of this program is:
$1 returns: bB
$2 returns: d
$3 returns:
input returns : cdbBdbsbdbdz
lastMatch returns: dbBd
leftContext returns: c
rightContext returns: bsbdbdz
lastParen returns: d
Requirements
Version 5.5
See Also
$1...$9 Properties | index Property | input Property ($_) | lastIndex Property | lastMatch Property ($&) | lastParen Property ($+) |
leftContext Property ($`)
Applies To: RegExp Object
JScript .NET
source (Propiedad)
Devuelve una copia del texto del modelo de una expresión regular. Sólo lectura.
rgExp.source
Argumentos
rgExp
Necesario. Un objeto Regular Expression.
Comentarios
El argumento rgExp puede ser una variable que almacena un objeto Regular Expression o puede ser un literal de expresión
regular.
Ejemplo
El siguiente ejemplo muestra el uso de la propiedad source:
Requisitos
Versión 3
Vea también
Regular Expression (Objeto) | Sintaxis de expresiones regulares
Se aplica a: Regular Expression (Objeto)
JScript .NET
SQRT1_2 Property
Returns the square root of 0.5, or one divided by the square root of 2.
Math.SQRT1_2
Arguments
Math
Required. The global Math object.
Remarks
The SQRT1_2 property, a constant, is approximately equal to 0.707.
Requirements
Version 1
See Also
sqrt Method | SQRT2 Property
Applies To: Math Object
JScript .NET
SQRT2 Property
Returns the square root of 2.
Math.SQRT2
Arguments
Math
Required. The global Math object.
Syntax
The SQRT2 property, a constant, is approximately equal to 1.414.
Requirements
Version 1
See Also
sqrt Method | SQRT1_2 Property
Applies To: Math Object
JScript .NET
undefined Property
Returns the value of undefined.
undefined
Remarks
The undefined property is a member of the Global object, and becomes available when the scripting engine is initialized. When
a variable has been declared but not initialized, its value is undefined.
If a variable has not been declared, you cannot compare it to undefined, but you can compare the type of the variable to the
string "undefined". Undeclared variables cannot be used in fast mode.
The undefined property is useful when explicitly testing or setting a variable to undefined.
Example
The following example illustrates the use of the undefined property:
Requirements
Version 5.5
See Also
Undefined Values
Applies To: Global Object
JScript .NET
Instrucciones
Una instrucción es un fragmento de código de JScript que realiza una acción. Algunas instrucciones declaran elementos definidos
por el usuario, como variables, funciones, clases y enumeraciones, mientras que otras instrucciones controlan el flujo del
programa. Las secciones que se muestran a continuación proporcionan vínculos a información que explica cómo utilizar las
instrucciones en JScript.
En esta sección
break (Instrucción)
Finaliza el bucle actual o, si se usa junto con una etiqueta, finaliza la instrucción asociada.
class (Instrucción)
Define una clase y sus miembros.
@cc_on (Instrucción)
Activa la compatibilidad con la compilación condicional.
Comment (Instrucciones)
Hace que el analizador de JScript pase por alto los comentarios, ya sean de una única línea (//) o multilínea (/* */).
const (Instrucción)
Define un identificador de constante y su valor.
continue (Instrucción)
Detiene la iteración actual de un bucle e inicia una nueva iteración.
debugger (Instrucción)
Inicia el depurador instalado.
do...while (Instrucción)
Ejecuta un bloque de instrucciones una vez y, a continuación, repite la ejecución del bucle hasta que la evaluación de una
expresión de condición devuelva False.
enum (Instrucción)
Declara una enumeración y sus valores.
for (Instrucción)
Ejecuta un bloque de instrucciones mientras la condición especificada sea igual a True.
for...in (Instrucción)
Ejecuta una o varias instrucciones para cada elemento de un objeto o una matriz.
function (Instrucción)
Declara una nueva función.
function get (Instrucción)
Declara el establecedor de una propiedad.
function set (Instrucción)
Declara el captador de una propiedad.
@if...@elif...@else...@end (Instrucción)
Ejecuta de forma condicional un grupo de instrucciones, dependiendo del valor de una expresión.
if...else (Instrucción)
Ejecuta de forma condicional un grupo de instrucciones, dependiendo del valor de una expresión.
import (Instrucción)
Habilita el acceso a una biblioteca externa.
interface (Instrucción)
Declara una interfaz y sus miembros.
Instrucción con etiqueta
Proporciona un identificador para una instrucción.
package (Instrucción)
Proporciona un modo de empaquetar clases e interfaces en componentes con nombre.
print (Instrucción)
Proporciona una forma de mostrar información de un programa ejecutado desde la línea de comandos.
return (Instrucción)
Sale de la función actual y devuelve un valor desde esa función.
@set (Instrucción)
Crea variables utilizadas con instrucciones de compilación condicional.
static (Instrucción)
Declara un bloque de código que inicializa una clase.
super (Instrucción)
Hace referencia a la clase base del objeto actual.
switch (Instrucción)
Permite la ejecución de una o más instrucciones cuando el valor de una expresión especificada coincide con una etiqueta.
this (Instrucción)
Hace referencia al objeto actual.
throw (Instrucción)
Genera una condición de error que se puede controlar con una instrucción try...catch.
try...catch...finally (Instrucción)
Implementa el control de errores para JScript.
var (Instrucción)
Declara una variable.
while (Instrucción)
Ejecuta una instrucción hasta que la condición especificada sea igual a False.
with (Instrucción)
Establece el objeto predeterminado para una instrucción.
Secciones relacionadas
Referencia de JScript
Enumera los elementos que comprende la Referencia del lenguaje JScript e incluye vínculos a temas que explican con más
detalle el uso correcto de los elementos del lenguaje.
Referencia de .NET Framework
Muestra vínculos a temas que explican la sintaxis y estructura de la biblioteca de clases de .NET Framework y otros elementos
esenciales.
JScript .NET
break Statement
Terminates the current loop, or if in conjunction with a label, terminates the associated statement.
break [label];
Arguments
label
Optional. Specifies the label of the statement you are breaking from.
Remarks
You typically use the break statement in switch statements and while, for, for...in, or do...while loops. You most commonly use
the label argument in switch statements, but it can be used in any statement, whether simple or compound.
Executing the break statement causes the program flow to exit the current loop or statement. Program flow resumes with the
next statement immediately following the current loop or statement.
Example 1
The following example illustrates the use of the break statement.
function breakTest(breakpoint){
var i = 0;
while (i < 100) {
if (i == breakpoint)
break;
i++;
}
return(i);
}
Example 2
The following example illustrates the use of the labeled break statement.
Requirements
Version 1
See Also
continue Statement | do...while Statement | for Statement | for...in Statement | Labeled Statement | while Statement
JScript .NET
class Statement
Declares the name of a class as well as a definition of the variables, properties, and methods that comprise the class.
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the class.
classname
Required. Name of the class; follows standard variable naming conventions.
extends
Optional. Keyword indicating that the class classname extends baseclass. If this keyword is not used, a standard JScript base
class is created that extends System.Object.
baseclass
Optional. The name of the class being extended.
implements
Optional. Keyword indicating that the class classname implements one or more interfaces.
interfaces
Optional. A comma-delimited list of interface names.
classmembers
Optional. classmembers can be method or constructor declarations (defined with the function statement), property
declarations (defined with the function get and function set statements), field declarations (defined with the var or const
statements), initializer declarations (defined with the static statement), enumeration declarations (defined with the enum
statement), or nested class declarations.
Remarks
Classes can be used to create instances or serve as the base for other classes, depending on the modifiers of the class. If a class is
marked with the abstract modifier, the class can serve as a base class for other classes to extend, but instances of an abstract
class cannot be created. If a class is marked with the final modifier, instances of the class can be created with the new operator,
but the class cannot serve as a base.
Methods and constructors may be overloaded in a class. Consequently, multiple methods (or constructors) may have the same
names. Overloaded class members are distinguished by their unique signatures, which are comprised of the name of the member
and the data type of each of its formal parameters. Overloads allow a class to group methods with similar functionality.
A class can inherit the functionality of an existing base class by using the extends keyword. Methods of the base class can be
overridden by declaring a new method with the same signature as the new class method. Methods in the new class can access
overridden members of the base class using the super statement.
A class can be patterned on one or more interfaces using the implements keyword. A class cannot inherit any behavior from an
interface because an interface does not provide an implementation for any member. An interface does provide the class with a
'signature' that can be used when interacting with other classes. Unless the class that implements an interface is abstract, an
implementation must be provided for every method defined in the interface.
Modifiers can be used to make a class instance behave more like a JScript object. To allow a class instance to handle dynamically
added properties, use the expando modifier, which automatically creates a default indexed property for the class. Only expando
properties are accessible using the square bracket notation of the JScript Object object.
Example 1
The following example creates a CPerson class with various fields and methods, the details of which have been omitted. The
CPerson class serves as the base class for the CCustomer class in the second example.
-blank-
John Doe
15 Broad Street, Atlanta, GA 30315
Example 2
A CCustomer class is derived from CPerson, having additional fields and methods not applicable to a generic member of the
CPerson class.
Requirements
Version .NET
See Also
Modifiers | interface Statement | function Statement | function get Statement | function set Statement | var Statement |
const Statement | static Statement | new Operator | this Statement | super Statement
JScript .NET
@cc_on Statement
Activates conditional compilation support.
@cc_on
Remarks
The @cc_on statement activates conditional compilation in the scripting engine.
It is strongly recommended that you use the @cc_on statement in a comment, so that browsers that do not support conditional
compilation will accept your script as valid syntax:
/*@cc_on*/
// The remainder of the script.
Alternatively, an @if or @set statement outside of a comment also activates conditional compilation.
Requirements
Version 3
See Also
Conditional Compilation | Conditional Compilation Variables | @if Statement | @set Statement
JScript .NET
Comment Statements
Causes comments to be ignored by the JScript parser.
Syntax 1
Single-line comment:
// comment
Syntax 2
Multiline comment:
/*
comment
*/
The comment is the text of any comment you want to include in your script.
Syntax 3
Single-line conditional comment:
//@CondStatement
Syntax 4
/*@
condStatement
@*/
The condStatement argument is conditional compilation code to be used if conditional compilation is activated. If Syntax 3 is used,
there can be no space between the "//" and "@" characters.
Remarks
Use comments to keep parts of a script from being read by the JScript parser. You can use comments to include explanatory
remarks in a program.
If Syntax 1 is used, the parser ignores any text between the comment marker and the end of the line. If Syntax 2 is used, it ignores
any text between the beginning and end markers.
Syntaxes 3 and 4 are used to support conditional compilation while retaining compatibility with browsers that do not support that
feature. These browsers treat those forms of comments as syntaxes 1 and 2 respectively.
Example
The following example illustrates the most common uses of the comment statement.
Requirements
Version 1
See Also
Conditional Compilation | Conditional Compilation Variables | @cc_on Statement | @set Statement
JScript .NET
const Statement
Declares a constant.
Syntax for declaring a constant of global scope or function scope.
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the field.
name1, ..., nameN
Required. The names of the constants being declared.
type1, ..., typeN
Optional. The types of the constants being declared.
value1, ..., valueN
The values assigned to the constants.
Remarks
Use the const statement to declare constants. A constant may be bound to a specific data type to ensure type safety. These
constants must be assigned values when they are declared, and these values cannot be changed later in the script.
A constant field in a class is similar to a global or function constant, except that it is scoped to the class and it can have various
modifiers governing its visibility and usage.
Note When a constant is bound to a reference data type (such as an Object, Array, class instance, or typed array),
the data referenced by the constant may be changed. This is allowed because the const statement makes only the
reference type constant; the data to which it refers is not constant.
Example
The following examples illustrate the use of the const statement.
class CSimple {
// A static public constant field. It will always be 42.
static public const constantValue : int = 42;
}
const index = 5;
const name : String = "Thomas Jefferson";
const answer : int = 42, oneThird : float = 1./3.;
const things : Object[] = new Object[50];
things[1] = "thing1";
// Changing data referenced by the constant is allowed.
Requirements
Version .NET
See Also
Modifiers | var Statement | function Statement | class Statement | Scope of Variables and Constants | Type Annotation
JScript .NET
continue Statement
Stops the current iteration of a loop, and starts a new iteration.
continue [label];
Arguments
label
Optional. Specifies the statement to which continue applies.
Remarks
You can use the continue statement inside while, do...while, for, or for...in loops only. Executing the continue statement stops the
current iteration of the loop and continues program flow with the beginning of the loop. This has the following effects on the
different types of loops:
while and do...while loops test their condition, and if true, execute the loop again.
for loops execute their increment expression, and if the test expression is true, execute the loop again.
for...in loops proceed to the next field of the specified variable and execute the loop again.
Example
The following example illustrates the use of the continue statement.
function skip5(){
var s = "", i=0;
while (i < 10) {
i++;
// Skip 5
if (i==5) {
continue;
}
s += i;
}
return(s);
}
Requirements
Version 1
See Also
break Statement | do...while Statement | for Statement | for...in Statement | Labeled Statement | while Statement
JScript .NET
debugger Statement
Launches the debugger.
debugger
Remarks
The debugger statement launches the installed debugger. The effect is similar to setting a breakpoint in the program where the
debugger statement is used.
If no debugger is installed, the debugger statement has no effect.
Requirements
Version 3
See Also
Statements | Writing, Compiling, and Debugging JScript Code
JScript .NET
do...while Statement
Executes a statement block once, and then repeats execution of the loop until a condition expression evaluates to false.
do
statement
while (expression)
Arguments
statement
Required. Statement to be executed if expression is true. Can be a compound statement.
expression
Required. An expression that can be coerced to Boolean true or false. If expression is true, the loop is executed again. If
expression is false, the loop is terminated.
Remarks
The value of expression is not checked until after the first iteration of the loop, guaranteeing that the loop is executed at least once.
Thereafter, it is checked after each succeeding iteration of the loop.
Example
The following example illustrates the use of the do...while statement to iterate the Drives collection.
function GetDriveList(){
var fso, s, n, e, x;
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives);
s = "";
do {
x = e.item();
s = s + x.DriveLetter;
s += " - ";
if (x.DriveType == 3)
n = x.ShareName;
else if (x.IsReady)
n = x.VolumeName;
else
n = "[Drive not ready]";
s += n + "\n";
e.moveNext();
}
while (!e.atEnd());
return(s);
}
Requirements
Version 3
See Also
break Statement | continue Statement | for Statement | for...in Statement | while Statement | Labeled Statement
JScript .NET
enum Statement
Declares the name of an enumerated data type and the names of the members of the enumeration.
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the enumeration.
enumName
Required. Name of the enumerated type.
typeAnnotation
Optional. The underlying data type of the enumeration. Must be an integral data type. The default is int.
enumValue1, enumValue2, ..., enumValueN
Optional. An enumerated type member.
initializer1, initializer2, ..., initializerN
Optional. A constant expression that overrides the default numerical value of an enumeration member.
Remarks
An enum declaration introduces a new enumerated data type into the program. An enum declaration can appear only in contexts
where a class declaration can appear, that is, at global scope, at package scope, or at class scope, but not inside a function or
method.
You can declare the underlying type of an enumeration to be any integral data type (int, short, long, byte, uint, ushort, ulong,
or sbyte). Enumeration members implicitly coerce to and from the underlying data type, allowing for direct assignments of
numeric data to variables typed as enum. By default, the underlying data type of an enumeration is int.
Each enumerated type member has a name and an optional initializer. An initializer must be a compile-time, constant expression
that is of the same type as the enumeration specified, or convertible to that type. The value of the first enumerated type member
is zero or the value of the initializer, if provided. The value of each subsequent enumerated type member is one more then the
previous member or the value of the initializer, if provided.
An enum value is accessed in a manner that's similar to accessing a static class member. The name of the member must be
qualified with the name of the enumeration, for example Color.Red. When assigning a value to a variable of an enum type, one
of following may be used: a fully qualified name (such as Color.Red), a string representation of the name (such as "Red"), or a
numeric value.
If an enum is assigned a string that is known at compile time, the compiler will perform the necessary conversion. For example,
"Red" would be replaced with Color.Red. If the string is not known at compile time, a conversion will be made at run time. That
conversion may fail if the string is not a valid member of the enumerated type. Because the conversion takes time and run-time
errors may be generated, avoid assigning an enum to a variable string.
A variable of an enumerated type can hold values outside the range of declared values. One use of this feature is to allow
combinations of members used as bit flags, as in done in the example below. Converting an enum variable to a string results in
the string representation of the member name.
Example 1
The following example shows the behavior of enumerations. It declares a simple enumeration named CarType that has members
Honda, Toyota, and Nissan.
enum CarType {
Honda, // Value of zero, since it is first.
Toyota, // Value of 1, the successor of zero.
Nissan // Value of 2.
}
// Declare a variable of type CarType, and give it the value Honda.
var myCar : CarType = CarType.Honda;
print(int(myCar) + ": " + myCar);
myCar = "Nissan"; // Change the value to "Nissan".
print(int(myCar) + ": " + myCar);
0: Honda
2: Nissan
1: Toyota
Example 2
The following example shows how to use an enumeration to hold bit flags and also that an enum variable must be able to hold
values not explicitly in the member list. It defines an enumeration FormatFlags that is used to modify the behavior of a Format
function.
// Explicitly set the type to byte, as there are only a few flags.
enum FormatFlags : byte {
// Can't use the default values, since we need explicit bits
ToUpperCase = 1, // Should not combine ToUpper and ToLower.
ToLowerCase = 2,
TrimLeft = 4, // Trim leading spaces.
TrimRight = 8, // Trim trailing spaces.
UriEncode = 16 // Encode string as a URI.
}
function Format(s : String, flags : FormatFlags) : String {
var ret : String = s;
if(flags & FormatFlags.ToUpperCase) ret = ret.toUpperCase();
if(flags & FormatFlags.ToLowerCase) ret = ret.toLowerCase();
if(flags & FormatFlags.TrimLeft) ret = ret.replace(/^\s+/g, "");
if(flags & FormatFlags.TrimRight) ret = ret.replace(/\s+$/g, "");
if(flags & FormatFlags.UriEncode) ret = encodeURI(ret);
return ret;
}
Requirements
Version .NET
See Also
for Statement
Executes a block of statements for as long as a specified condition is true.
Arguments
initialization
Required. An expression. This expression is executed only once, before the loop is executed.
test
Required. A Boolean expression. If test is true, statement is executed. If test if false, the loop is terminated.
increment
Required. An expression. The increment expression is executed at the end of every pass through the loop.
statement
Optional. Statement to be executed if test is true. Can be a compound statement.
Remarks
You usually use a for loop when the loop is to be executed a known number of times.
Example
The following example demonstrates a for loop.
Requirements
Version 1
See Also
for...in Statement | while Statement
JScript .NET
for...in Statement
Executes one or more statements for each property of an object, or each element of an array or collection.
Arguments
variable
Required. A variable that can be any property name of object, any index of array, or any element of collection.
object
A JScript object over which to iterate.
array
An array over which to iterate. Can be a JScript Array object or a .NET Framework array.
collection
A collection over which to iterate. Can be any class that implements the IEnumerable or IEnumerator interfaces from the .NET
Framework.
statement
Optional. Statements to be executed for each property of object or each element of array or collection. Can be a compound
statement.
Remarks
Before each iteration of a loop, variable is assigned the next property name of object, the next index of array, or the next element
of collection. You can use variable in any of the statements inside the loop to reference the property of object or the element of
array.
When iterating over an object, there is no way to determine or control the order in which the member names of the object are
assigned to variable. The for...in statement cannot loop over the members of non-JScript objects, such as .NET Framework
objects.
Arrays are iterated in element order, starting with the smallest index and ending with the largest index. Because JScript Array
objects can be sparse, the for...in statement accesses only the defined elements of the array. JScript Array objects may also have
expando properties, in which case variable is assigned array indexes as property names. If the array is a multidimensional .NET
Framework array, only the first dimension is enumerated.
For iteration over a collection, the elements are assigned to variable in the order in which they appear in the collection.
Example 1
The following example illustrates the use of the for ... in statement with an object used as an associative array.
function ForInDemo1() {
var ret = "";
// Initialize the object with properties and values.
var obj : Object = {"a" : "Athens" ,
"b" : "Belgrade",
"c" : "Cairo"};
return(ret);
} // ForInDemo1
a: Athens
b: Belgrade
c: Cairo
Example 2
This example illustrates the use of the for ... in statement with a JScript Array object which has expando properties.
function ForInDemo2() {
var ret = "";
// Initialize the array.
var arr : Array = new Array("zero","one","two");
// Add a few expando properties to the array.
arr["orange"] = "fruit";
arr["carrot"] = "vegetable";
0: zero
1: one
2: two
orange: fruit
carrot: vegetable
Example 3
The following example illustrates the use of the for ... in statement with a collection. Here, the GetEnumerator method of the
System.String object provides a collection of the characters in the string.
function ForInDemo3() {
var ret = "";
// Initialize collection.
var str : System.String = "Test.";
var chars : System.CharEnumerator = str.GetEnumerator();
0: T
1: e
2: s
3: t
4: .
Requirements
Version 5
Note Looping over collections requires Version .NET.
See Also
function Statement
Declares a new function. This can be used in several contexts:
Syntax 1: In the global scope
Arguments
attributes
Optional. Attributes that control the visibility and behavior of the method.
modifiers
Optional. Modifiers that control the visibility and behavior of the method.
functionname
Required. The name of the function or method.
paramlist
Optional. A comma delimited parameter list for the function or method. Each parameter may include a type specification. The
last parameter may be a parameter array, which is denoted by three periods (...) followed by a parameter array name followed
by a type annotation of a typed array.
type
Optional. Return type of the method.
body
Optional. One or more statements that define how the function or method operates.
Remarks
Use the function statement to declare a function for later use. The code contained in the body is not executed until the function is
called from elsewhere in the script. The return statement is used to return a value from the function. You do not have to use a
return statement, the program will return when it gets to the end of the function.
Methods are similar to global functions, except that they are scoped to the class or interface where they are defined and may
have various modifiers governing their visibility and behavior. A method in an interface cannot have a body, while a method in a
class must have a body. There is an exception to this rule; if a method in a class is abstract or the class is abstract, the method
cannot have a body.
You may use type annotation to declare what data type the function or method returns. If void is specified as the return type, no
value may be returned by any of the return statements inside the function. If any return type other than void is specified, all
return statements in the function must return a value that is coercible to the specified return type. The value undefined is
returned if a return type is specified, but a return statement appears with no value or if the end of the function is reached without
a return statement. Constructor functions cannot specify a return type, since the new operator automatically returns the object
being created.
If no explicit return type is specified for the function, the return type is set to either Object or void. The void return type is
selected only when there are no return statements or the return statements appear with no value in the function body.
A parameter array can be used as the last the parameter of a function. Any additional arguments passed to the function (if any)
after the required parameters will be entered into the parameter array. The type annotation of the parameter is not optional; it
must a typed array. To accept parameters of arbitrary types, use Object[] as the typed array. When calling a function that can
accept a variable number of arguments, an explicit array of the expected type may be used in place of supplying a list of
parameters.
When calling a function, make sure that you always include the parentheses and any required arguments. Calling a function
without parentheses causes the text of the function to be returned instead of the results of the function.
Example 1
The following example illustrates the use of the function statement in the first syntax:
interface IForm {
// This is using function in Syntax 3.
function blank() : String;
}
25
This is blank.
This is blank.
Example 2
In this example, a function printFacts takes as input a String and a used a parameter array to accept a variable number of
Objects.
Requirements
Version 1 (for syntax 1)
Version .NET (for syntaxes 2 and 3)
See Also
Modifiers | new Operator | class Statement | interface Statement | return Statement | Scope of Variables and Constants |
Type Annotation | Typed Arrays
JScript .NET
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the property.
propertyname
Required. Name of property being created. Must be unique within the class except the same propertyname can be used with
both get and set accessors to identify a property than can be read from and written to.
type
Optional. Return type of the get accessor. This must match the parameter type of the set accessor, if defined.
body
Optional. One or more statements that define how a get accessor operates.
Remarks
The properties of an object are accessed in much the same way as a field is accessed, except that properties allow for more control
over the values that are stored in and returned from the object. Properties can be read-only, write-only, or read-write depending
on the combination of get and set property accessors defined within the class. Properties are often used to ensure that only
appropriate values are stored in a private or protected field. You may not assign a value to a read-only property or read a value
from a write-only property.
A get accessor, which must specify a return type, does not have any arguments. A get accessor may be paired with a set accessor,
which has one argument and does not have a return type. If both accessors are used for a property, the return type of the get
accessor must match the argument type of the set accessor.
A property may have either a get accessor or set accessor or both. Only the get accessor (or set accessor if there is no get
accessor) of a property may have custom attributes that apply to the property as a whole. Both the get and set accessors can
have modifiers and custom attributes that apply to the individual accessor. Property accessors cannot be overloaded, but they can
be hidden or overridden.
Properties can be specified in the definition of an interface, but no implementation can be given in the interface.
Example
The following example shows several property declarations. An Age property is defined as read from and written to. A read-only
FavoriteColor property is also defined.
class CPerson {
// These variables are not accessible from outside the class.
private var privateAge : int;
private var privateFavoriteColor : String;
Requirements
Version .NET
See Also
Modifiers | class Statement | interface Statement | function Statement | function set Statement | Type Annotation
JScript .NET
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the property.
propertyname
Required. Name of property being created. Must be unique within the class except the same propertyname can be used with
both get and set accessors to identify a property than can be read from and written to.
parameter
Required. Formal parameter accepted by the set accessor.
type
Optional. Parameter type of the set accessor. This must match the return type of the get accessor, if defined.
body
Optional. One or more statements that define how a set accessor operates.
Remarks
The properties of an object are accessed in much the same way as a field is accessed, except that properties allow for more control
over the values that are stored in and returned from the object. Properties can be read-only, write-only, or read-write depending
on the combination of get and set property accessors defined within the class. Properties are often used to ensure that only
appropriate values are stored in a private or protected a field. You may not assign a value to a read-only property or read a
value from a write-only property.
A set accessor must have exactly one argument, and it cannot specify a return type. The set accessor may be paired with a get
accessor, which does not have any arguments and must specify a return type. If both accessors are used for a property, the return
type of the get accessor must match the argument type of the set accessor.
A property may have either a get accessor or set accessor or both. Only the get accessor (or set accessor if there is no get
accessor) of a property may have custom attributes that apply to the property as a whole. Both the get and set accessors can
have modifiers and custom attributes that apply to the individual accessor. Property accessors cannot be overloaded, but they can
be hidden or overridden.
Properties can be specified in the definition of an interface, but no implementation can be given in the interface.
Example
The following example shows several property declarations. An Age property is defined as read from and write to. A read-only
FavoriteColor property is also defined.
class CPerson {
// These variables are not accessible from outside the class.
private var privateAge : int;
private var privateFavoriteColor : String;
Requirements
Version .NET
See Also
Modifiers | class Statement | interface Statement | function Statement | function get Statement | Type Annotation
JScript .NET
@if...@elif...@else...@end Statement
Conditionally executes a group of statements, depending on the value of an expression.
@if (
condition1
)
text1
[@elif (
condition2
)
text2]
[@else
text3]
@end
Arguments
condition1, condition2
Required. An expression that can be coerced into a Boolean expression.
text1
Optional. Text to be parsed if condition1 is true.
text2
Optional. Text to be parsed if condition1 is false and condition2 is true.
text3
Optional. Text to be parsed if both condition1 and condition2 are false.
Remarks
When you write an @if statement, you do not have to place each clause on a separate line. You can use multiple @elif clauses.
However, all @elif clauses must come before an @else clause.
You commonly use the @if statement to determine which text among several options should be used for text output.
Example
@if (@_win32)
print("Operating system is 32-bit.");
@else
print("Operating system is not 32-bit.");
@end
Requirements
Version 3
See Also
Conditional Compilation | Conditional Compilation Variables | @cc_on Statement | @set Statement
JScript .NET
if...else Statement
Conditionally executes a group of statements, depending on the value of an expression.
if (condition)
statement1
[else
statement2]
Arguments
condition
Required. A Boolean expression. If condition is null or undefined, condition is treated as false.
statement1
Required. The statement to be executed if condition is true. Can be a compound statement.
statement2
Optional. The statement to be executed if condition is false. Can be a compound statement.
Remarks
It is generally good practice to enclose statement1 and statement2 in braces ({}) for clarity and to avoid inadvertent errors.
Example
In the following example, you may intend that the else be used with the first if statement, but it is used with the second one.
if (x == 5)
if (y == 6)
z = 17;
else
z = 20;
if (x == 5)
{
if (y == 6)
z = 17;
}
else
z = 20;
Similarly, if you want to add a statement to statement1, and you don not use braces, you can accidentally create an error:
if (x == 5)
z = 7;
q = 42;
else
z = 19;
In this case, there is a syntax error, because there is more than one statement between the if and else statements. Braces are
required around the statements between if and else.
Requirements
Version 1
See Also
Conditional (Ternary) Operator (?:)
JScript .NET
import Statement
Enables access to a namespace contained either within the current script or in an external library.
import namespace
Arguments
namespace
Required. Name of the namespace to import.
Remarks
The import statement creates a property on the global object with the name supplied as namespace and initializes it to contain
the object that corresponds to the namespace being imported. Any properties created using the import statement cannot be
assigned to, deleted, or enumerated. All import statements are executed when a script starts.
The import statement makes a namespace available to your script. The namespace may be defined in the script by using the
package statement, or an external assembly may provide it. If the namespace is not found within the script, JScript searches for
an assembly that matches the name of the namespace in the specified assembly directories, unless the program is being compiled
and the /autoref option is turned off. For example, if you import the namespace Acme.Widget.Sprocket and the namespace is not
defined within the current script, JScript will search for the namespace in the following assemblies:
Acme.Widget.Sprocket.dll
Acme.Widget.dll
Acme.dll
You can explicitly specify the name of the assembly to include. This must be done if the /autoref option is turned off or if the name
of the namespace does not match the assembly name. The command line compiler uses the /reference option to specify the
assembly name, while ASP.NET uses the @ Import and @ Assembly directives to accomplish this. For example, to explicitly
include the assembly mydll.dll, from the command line you would type
When a class is referenced in code, the compiler first searches for the class in the local scope. If the compiler finds no matching
class, the compiler searches for the class in each namespace, in the order in which they were imported, and stops when it finds a
match. You can use the fully qualified name of the class to be certain from which namespace the class derives.
JScript does not automatically import nested namespaces; each namespace must be imported using the fully qualified
namespace. For example, to access classes from a namespace named Outer and a nested namespace named Outer.Inner, both
namespaces must be imported.
Example
The following example defines three simple packages and imports the namespaces into the script. Typically, each package would
be in a separate assembly to allow maintenance and distribution of the package content.
Greetings!
Bonjour!
Guten tag!
Eiffel Tower
meter
meter
Requirements
Version .NET
See Also
package Statement | /autoref | /lib | @ Assembly | @ Import
JScript .NET
interface Statement
Declares the name of an interface, as well as the properties and methods that comprise the interface.
Arguments
modifiers
Optional. Modifiers that control the visibility and behavior of the property.
interfacename
Required. The name of the interface; follows standard variable naming conventions.
implements
Optional. Keyword indicating that the named interface implements, or adds members to, a previously defined interface. If this
keyword is not used, a standard JScript base interface is created.
baseinterfaces
Optional. A comma-delimited list of interface names that are implemented by interfacename.
interfacemembers
Optional. interfacemembers can be either method declarations (defined with the function statement) or property declarations
(defined with the function get and function set statements).
Remarks
The syntax for interface declarations in JScript is similar to that for class declarations. An interface is like a class in which every
member is abstract; it can only contain property and method declarations without function bodies. An interface may not contain
field declarations, initializer declarations, or nested class declarations. An interface can implement one or more interfaces by
using the implements keyword.
A class may extend only one base class, but a class may implement many interfaces. Such implementation of multiple
interfaces by a class allows for a form of multiple inheritance that is simpler than in other object-oriented languages, for
example, in C++.
Example
The following code shows how one implementation can be inherited by multiple interfaces.
interface IFormA {
function displayName();
}
// Interface IFormB shares a member name with IFormA.
interface IFormB {
function displayName();
}
// Class CForm implements both interfaces, but only one implementation of
// the method displayName is given, so it is shared by both interfaces and
// the class itself.
class CForm implements IFormA, IFormB {
function displayName() {
print("This the form name.");
}
}
// Three variables with different data types, all referencing the same class.
var c : CForm = new CForm();
var a : IFormA = c;
var b : IFormB = c;
Requirements
Version .NET
See Also
Modifiers | class Statement | function Statement | function get Statement | function set Statement
JScript .NET
Labeled Statement
Provides an identifier for a statement.
label :
[statements]
Arguments
label
Required. A unique identifier used when referring to the labeled statement.
statements
Optional. One or more statements associated with label.
Remarks
Labels are used by the break and continue statements to specify the statement to which the break and continue apply.
Example
In the following statement the continue statement uses a labeled statement to create an array in which the third column of each
row contains and undefined value:
function labelDemo() {
var a = new Array();
var i, j, s = "", s1 = "";
Outer:
for (i = 0; i < 5; i++) {
Inner:
for (j = 0; j < 5; j++) {
if (j == 2)
continue Inner;
else
a[i,j] = j + 1;
}
}
for (i = 0;i < 5; i++) {
s = ""
for (j = 0; j < 5; j++) {
s += a[i,j];
}
s1 += s + "\n";
}
return(s1)
}
Requirements
Version 3
See Also
break Statement | continue Statement
JScript .NET
package Statement
Creates a JScript package that enables the convenient packaging of named components.
package pname {
[[modifiers1] pmember1]
...
[[modifiersN] pmemberN]
}
Arguments
pname
Required. The name of the package being created.
modifiers1, ..., modifiersN
Optional. Modifiers that control the visibility and behavior of the pmember.
pmember1, ..., pmemberN
Optional. Class, interface, or enumeration definition.
Remarks
Only classes, interfaces, and enumerations are allowed inside a package. Package members may be marked with visibility
modifiers to control access to the member. In particular, the internal modifier marks a member as being visible only within the
current package.
Once a package has been imported, package members can be accessed directly by name, except when a member has the same
name as another declaration visible to the importing scope. When that happens, the member must be qualified using its package
name.
JScript does not support declaring nested packages; only class, interface, and enumeration declarations may appear inside a
package. A package name can include a '.' character to indicate that it should be considered as nested in another package. For
example, a package named Outer and a package named Outer.Inner do not need to have a special relationship to each other;
they are both packages at the global scope. However, the names imply that Outer.Inner should be considered as nested within
Outer.
Example
The following example defines three simple packages and imports the namespaces into the script. Typically, each package would
be in a separate assembly to allow maintenance and distribution of the package content.
Greetings!
Bonjour!
Guten tag!
Eiffel Tower
meter
meter
Requirements
Version .NET
See Also
import Statement | internal Modifier | Modifiers
JScript .NET
print Statement
Sends a string to the console followed by a newline character.
Parameters
str
Optional. String to send to the console.
Remarks
The print statement allows you to display data from a JScript program compiled with the JScript command-line compiler,
jsc.exe. The print statement takes a single string as a parameter and displays that string followed by a newline character by
sending it to the console.
You can use escape sequences in the strings you pass to the print statement to format the output. Escape sequences are character
combinations consisting of a backslash (\) followed by a letter or by a combination of digits. Escape sequences can be used to
specify actions such as carriage returns and tab movement. More information about escape characters can be found in the String
object topic. The System.Console.WriteLine method can be used when fine control over the format of console output is
required.
The print statement is enabled by default in the JScript command-line compiler, jsc.exe. The print statement is disabled in
ASP.NET, and you can disable it for the command-line compiler by using the /print- option.
When there is no console to which to print (for example, in a Windows GUI application), the print statement will silently fail.
Output from the print statement can be redirected to a file from the command line. If you expect that the output of a program will
be redirected, you should include the \r escape character at the end of each line printed. This causes output redirected to a file to
be correctly formatted, and it does not affect the way lines are displayed on the console.
Example
The following example demonstrates a use of the print statement.
Name: Fred
Age: 42
See Also
/print | Displaying from a Command Line Program | String Object | Console Class
JScript .NET
return Statement
Exits from the current function and returns a value from that function.
return[(][expression][)]
Arguments
expression
Optional. The value to be returned from the function. If omitted, the function does not return a value.
Remarks
You use the return statement to stop execution of a function and return the value of expression. If expression is omitted, or no
return statement is executed from within the function, the expression that called the current function is assigned the value
undefined.
Execution of the function stops when the return statement is executed, even if there are other statements still remaining in the
function body. The exception to this rule is if the return statement occurs within a try block, and there is a corresponding finally
block, the code in the finally block will execute before the function returns.
If a function returns because it reaches the end of the function body without executing a return statement, the value returned is
the undefined value (this means the function result cannot be used as part of a larger expression).
Note The code in a finally block is run after a return statement in a try or catch block is encountered, but before
that return statement is executed. In this situation, a return statement in the finally block is executed before the
initial return statement, allowing for a different return value. To avoid this potentially confusing situation, do not use a
return statement in a finally block.
Example
The following example illustrates the use of the return statement.
Requirements
Version 1
See Also
function Statement | try...catch...finally Statement
JScript .NET
@set Statement
Creates variables used with conditional compilation statements.
Arguments
varname
Required. Valid JScript variable name. Must be preceded by an "@" character at all times.
term
Required. Zero or more unary operators followed by a constant, conditional compilation variable, or parenthesized expression.
Remarks
Numeric and Boolean variables are supported for conditional compilation. Strings are not. Variables created using @set are
generally used in conditional compilation statements, but can be used anywhere in JScript code.
Examples of variable declarations look like this:
@set @myvar1 = 12
@set @myvar2 = (@myvar1 * 20)
@set @myvar3 = @_jscript_version
If a variable is used before it has been defined, its value is NaN. NaN can be checked for using the @if statement:
This works because NaN is the only value not equal to itself.
Requirements
Version 3
See Also
Conditional Compilation | Conditional Compilation Variables | @cc_on Statement | @if Statement
JScript .NET
static Statement
Declares a new class initializer inside a class declaration.
static identifier {
[body]
}
Arguments
identifier
Required. The name of the class that contains the initializer block.
body
Optional. The code that comprises the initializer block.
Remarks
A static initializer is used to initialize a class object (not object instances) before its first use. This initialization occurs only once,
and it can be used to initialize fields in the class that have the static modifier.
A class may contain several static initializer blocks interspersed with static field declarations. To initialize the class, all the static
blocks and static field initializers are executed in the order in which they appear in the class body. This initialization is performed
before the first reference to a static field.
Do not confuse the static modifier with the static statement. The static modifier denotes a member that belongs to the class
itself, not any instance of the class.
Example
The following example shows a simple class declaration in which the static initializer is used to perform a calculation that only
needs to be done one time. In this example, a table of factorials is calculated once. When factorials are needed they are read from
the table. This approach is faster than calculating factorials recursively if large factorials are needed many times in the program.
The static modifier is used for the factorial method.
class CMath {
// Dimension an array to store factorial values.
// The static modifier is used in the next two lines.
static const maxFactorial : int = 5;
static const factorialArray : int[] = new int[maxFactorial];
static CMath {
// Initialize the array of factorial values.
// Use factorialArray[x] = (x+1)!
factorialArray[0] = 1;
for(var i : int = 1; i< maxFactorial; i++) {
factorialArray[i] = factorialArray[i-1] * (i+1);
}
// Show when the initializer is run.
print("Initialized factorialArray.");
}
Table of factorials:
Initialized factorialArray.
1! = 1
2! = 2
3! = 6
4! = 24
5! = 120
Requirements
Version .NET
See Also
class Statement | static Modifier
JScript .NET
super Statement
Refers to the base object of the current object. This can be used in two contexts.
Syntax 1: Calls the base-class constructor with arguments.
super(arguments)
super.member
Arguments
arguments
Optional in syntax 1. A comma delimited list of arguments for the base-class constructor.
member
Required in syntax 2. Member of the base class to access.
Remarks
The super keyword is typically used in one of two situations. You can use it to explicitly call the base-class constructor with one or
more arguments. You can also use it to access base-class members that have been overridden by the current class.
Example 1
In the following example, super refers to the constructor of the base class.
class baseClass {
function baseClass() {
print("Base class constructor with no parameters.");
}
function baseClass(i : int) {
print("Base class constructor. i is "+i);
}
}
class derivedClass extends baseClass {
function derivedClass() {
// The super constructor with no arguments is implicitly called here.
print("This is the derived class constructor.");
}
function derivedClass(i : int) {
super(i);
print("This is the derived class constructor.");
}
}
new derivedClass;
new derivedClass(42);
Example 2
In the following example, super allows access to an overridden member of the base class.
class baseClass {
function test() {
print("This is the base class test.");
}
}
class derivedClass extends baseClass {
function test() {
print("This is the derived class test.");
super.test(); // Call the base class test.
}
}
var obj : derivedClass = new derivedClass;
obj.test();
Requirements
Version .NET
See Also
switch Statement
Enables the execution of one or more statements when a specified expression's value matches a label.
switch (expression) {
case label1 :
[statementlist1]
[break;]
[ ...
[ case labelN :
[statementlistN]
[break;] ] ]
[ default :
[statementlistDefault]]
}
Arguments
expression
Required. The expression to be evaluated.
label1, ..., labelN
Required. An identifier to be matched against expression. If label === expression, execution starts with the statement list
immediately after the colon, and continues until it encounters either a break statement, which is optional, or the end of the
switch statement.
statementlist1, ..., statementlistN, statementlistDefault
Optional. One or more statements to be executed.
Remarks
Use the default clause to provide a statement to be executed if none of the label values matches expression. It can appear
anywhere within the switch code block.
Zero or more label blocks may be specified. If no label matches the value of expression, and a default case is not supplied, no
statements are executed.
Execution flows through a switch statement as follows:
Evaluate expression and look at label in order until a match is found.
If a label value equals expression, execute its accompanying statement list.
Continue execution until a break statement is encountered, or the switch statement ends. This means that multiple label
blocks are executed if a break statement is not used.
If no label equals expression, go to the default case. If there is no default case, go to last step.
Continue execution at the statement following the end of the switch code block.
Example
The following ASP.NET example tests an object for its type. In this case, only one type is used, but you should be able to clearly see
how the function works with other object types.
Requirements
Version 3
See Also
break Statement | if...else Statement
JScript .NET
this Statement
Refers to the current object.
this.property
Arguments
property
Required. The identifier of a property of the current object.
Remarks
The this keyword is typically used in object constructors to refer to the current object.
Example
In the following example, this refers to the newly created Car object, and assigns values to three properties:
For client versions of JScript, this refers to the window object if used outside of the context of any other object.
Requirements
Version 1
See Also
new Operator
JScript .NET
throw Statement
Generates an error condition that can be handled by a try...catch...finally statement.
throw [exception]
Arguments
exception
Optional. Any expression.
Remarks
The throw statement can be used without an argument, but only if the throw statement is contained within a catch block. In that
situation, the throw statement re-throws the error caught by the enclosing catch statement. When an argument is provided, the
throw statement throws the value of exception.
Example
The following example throws an error based on a passed-in value, then illustrates how that error is handled in a hierarchy of
try...catch...finally statements:
function TryCatchDemo(x){
try {
try {
if (x == 0) // Evalute argument.
throw "x equals zero"; // Throw an error.
else
throw "x does not equal zero"; // Throw a different error.
}
catch(e) { // Handle "x=0" errors here.
if (e == "x equals zero") // Check for a handled error.
return(e + " handled locally."); // Return error message.
else // Can't handle error here.
throw e; // Rethrow the error for next
} // error handler.
}
catch(e) { // Handle other errors here.
return(e + " error handled higher up."); // Return error message.
}
}
print(TryCatchDemo(0)+ "\n");
print(TryCatchDemo(1));
Requirements
Version 5
See Also
try...catch...finally Statement | Error Object
JScript .NET
try...catch...finally Statement
Implements error handling for JScript.
try {
[tryStatements]
} catch(exception) {
[catchStatements]
} finally {
[finallyStatements]}
Arguments
tryStatements
Optional. Statements where an error can occur.
exception
Required. Any variable name. The initial value of exception is the value of the thrown error.
catchStatements
Optional. Statements to handle errors occurring in the associated tryStatements.
finallyStatements
Optional. Statements that are unconditionally executed after all other error processing has occurred.
Remarks
The try...catch...finally statement provides a way to handle some or all of the possible errors that may occur in a given block of
code, while still running code. If errors occur that the programmer has not handled, JScript simply provides its normal error
message to a user, as if there was no error handling.
The tryStatements contain code where an error can occur, while catchStatements contain the code to handle any error that does
occur. If an error occurs in the tryStatements, program control is passed to catchStatements for processing. The initial value of
exception is the value of the error that occurred in tryStatements. If no error occurs, catchStatements are never executed.
If the error cannot be handled in the catchStatements associated with the tryStatements where the error occurred, use the throw
statement to propagate, or re-throw, the error to a higher-level error handler.
After all statements in tryStatements have been executed and any error handling has occurred in catchStatements, the statements
in finallyStatements are unconditionally executed.
Notice that the code inside finallyStatements is executed even if a return statement occurs inside the try or catch blocks, or if an
error is thrown from a catch block. finallyStatments are guaranteed to always run.
Example
The following example shows how JScript exception handling works.
try {
print("Outer try running...");
try {
print("Nested try running...");
throw "an error";
} catch(e) {
print("Nested catch caught " + e);
throw e + " re-thrown";
} finally {
print("Nested finally is running...");
}
} catch(e) {
print("Outer catch caught " + e);
} finally {
print("Outer finally running");
}
Requirements
Version 5
See Also
throw Statement | Error Object
JScript .NET
var Statement
Declares a variable.
Syntax 1
Syntax for declaring a variable of global scope or function scope:
Syntax 2
[attributes] [modifiers] var name1 [: type1] [= value1] [, ... [, nameN [: typeN] [= valueN].
]]
Arguments
attributes
Optional. Attributes that control the visibility and behavior of the field.
modifiers
Optional. Modifiers that control the visibility and behavior of the field.
name1, ..., nameN
Required. The names of the variables being declared.
type1, ..., typeN
Optional. The types of the variables being declared.
value1, ..., valueN
Optional. The initial value assigned to the variable.
Remarks
Use the var statement to declare variables. A variable may be bound to a specific data type to ensure type safety. These variables
may be assigned values when they are declared, and these values may be changed later in the script. Variables that are not
explicitly initialized are assigned the default value of undefined (coerced to the type of the variable if necessary).
A variable field in a class is similar to a global or function variable, except that it is scoped to the class and it can have various
attributes governing its visibility and usage.
Example
The following example illustrates some uses of the var statement.
class Simple {
// A field declaration of the private Object myField.
private var myField : Object;
// Define sharedField to be a static, public field.
// Only one copy exists, and is shared by all instances of the class.
static public var sharedField : int = 42;
}
var index;
var name : String = "Thomas Jefferson";
var answer : int = 42, counter, numpages = 10;
var simpleInst : Simple = new Simple;
Requirements
Version 1
See Also
Modifiers | const Statement | function Statement | new Operator | Scope of Variables and Constants | Type Annotation
JScript .NET
while Statement
Executes a statement until a specified condition is false.
while (expression)
statement
Arguments
expression
Required. A Boolean expression checked before each iteration of the loop. If expression is true, the loop is executed. If expression
is false, the loop is terminated.
statement
Required. Statement to be executed if expression is true. Can be a compound statement.
Remarks
The while statement checks expression before a loop is first executed. If expression is false at this time, the loop is never executed.
Example
The following example illustrates the use of the while statement.
function BreakTest(breakpoint){
var i = 0;
while (i < 100) {
if (i == breakpoint)
break;
i++;
}
return(i);
}
Requirements
Version 1
See Also
break Statement | continue Statement | do...while Statement | for Statement | for...in Statement
JScript .NET
with Statement
Establishes the default object for a statement.
with (object)
statement
Arguments
object
Required. The new default object.
statement
Required. Statements for which object is the default object. Can be a compound statement.
Remarks
The with statement is commonly used to shorten the amount of code that you have to write in certain situations.
Example
var x, y;
x = Math.cos(3 * Math.PI) + Math.sin(Math.LN10);
y = Math.tan(14 * Math.E);
When you use the with statement, your code becomes shorter and easier to read:
var x, y;
with (Math){
x = cos(3 * PI) + sin (LN10);
y = tan(14 * E);
}
Requirements
Version 1
See Also
this Statement
JScript .NET
In This Section
See Also
JScript Compiler Options | JScript Compiler Options Listed by Category | Building from the Command Line
JScript .NET
See Also
JScript Compiler Options | JScript Compiler Options Listed Alphabetically | Building from the Command Line
JScript .NET
Vea también
Opciones del compilador de JScript | Compilar código JScript desde la línea de comandos
JScript .NET
@response_file
Argumentos
response_file
Archivo que especifica opciones del compilador o archivos de código fuente para compilar.
Comentarios
La opción @ permite especificar un archivo que contiene opciones del compilador y archivos de código fuente para compilar.
Estas opciones de compilador y archivos de código fuente serán procesados por el compilador como si fuesen especificados en la
línea de comandos.
Para especificar varios archivos de respuesta en una compilación, hay que especificar varias opciones de archivo de respuesta. Por
ejemplo:
@file1.rsp @file2.rsp
En una misma línea de un archivo de respuesta, pueden aparecer varias opciones del compilador y archivos de código fuente. Una
especificación de opción del compilador debe aparecer en una única línea (no puede abarcar varias líneas).
Los archivos de respuesta pueden contener comentarios que empiezan con el símbolo #.
Especificar opciones del compilador desde un archivo de respuesta produce el mismo efecto que incluir esos comandos en la
línea de comandos. Para obtener más información, vea Generar desde la línea de comandos.
El compilador procesa las opciones de comando a medida que las detecta, como si fuesen escritas en la línea de comandos. Por
ello, las opciones de un archivo de respuesta pueden ser incompatibles con las de otro archivo de respuesta o las opciones de
línea de comandos. Esto puede generar errores.
Los archivos de respuesta no se pueden anidar. No se puede incluir @response_file en un archivo de respuesta. El compilador de
JScript genera un error en estos casos.
Ejemplo
A continuación, se muestran algunas líneas de un archivo de respuesta de ejemplo:
Vea también
Opciones del compilador de JScript
JScript .NET
/autoref
Automatically references assemblies if they have the same name as an imported namespace or as a type annotation when
declaring a variable.
/autoref[+ | -]
Arguments
+|-
On by default, unless /nostdlib+ is specified. Specifying /autoref+, or just /autoref, causes the compiler to automatically
reference assemblies based on imported namespaces and fully qualified names.
Remarks
The /autoref option instructs the compiler to reference assemblies without having to pass the assembly to /reference. When you
use import to import a namespace, or you use a fully qualified type name in your code, the JScript compiler searches for an
assembly that contains the type. See /lib for a discussion of how the JScript compiler searches for assemblies.
The compiler does not try to reference an assembly if it has the same name as the output file of the program you are building.
Example
The following program will compile and run when /autoref+ is in effect; the compiler will reference System.dll as a result of the
type annotation when declaring a variable.
var s: System.Collections.Specialized.StringCollection =
new System.Collections.Specialized.StringCollection();
print(s);
The following program will compile and run when /autoref+ is in effect; the compiler will reference System.dll as a result of the
import statement.
import System;
var s = new System.Collections.Specialized.StringCollection();
print(s);
These examples also show how the compiler looks for assembly names based on type annotation or import statements. When
the compiler did not find an assembly called System.Collections.Specialized.dll that contained StringCollection, it looked for
System.Collections.dll. Failing to find that file, it looked for System.dll, which it did find to contain StringCollection.
See Also
import Statement | /reference | JScript Compiler Options
JScript .NET
/codepage
Specifies the code page to use for all source code files in the compilation.
/codepage:id
Arguments
id
The id of the code page for all the source code files in the compilation.
Remarks
If you compile one or more source code files that when created did not designate use of the default code page on your computer,
you can use the /codepage option to specify which code page should be used. /codepage applies to all source code files in your
compilation.
If the source code files were created with the same codepage that is in effect on your computer or if the source code files were
created with UNICODE or UTF-8, you need not use /codepage.
See Also
JScript Compiler Options
JScript .NET
/debug
Emits debugging information.
/debug[+ | -]
Arguments
+|-
Specifying /debug+, or just /debug, causes the compiler to generate debugging information and place it in an output .pdb
file(s). /debug- which is in effect by default if you do not specify /debug does not generate any debug information or create an
output file(s) to contain debug information.
Remarks
For information on how to configure the debug performance of an application, see Making an Image Easier to Debug.
Example
Place debugging information in output file app.exe:
See Also
JScript Compiler Options
JScript .NET
/define
Defines preprocessor symbols.
/define:name1[=value1][,name2[=value1]]
Arguments
name1, name2
The name of one or more symbols that you want to define.
value1, value2
Values for the symbols to take. These can be booleans or numbers.
Remarks
The /define option defines names as symbols in your program.
You can define multiple symbols with /define by using a comma to separate symbol names. For example:
/define:DEBUG,trace=true,max_Num=100
print("testing")
/*@cc_on @*/
/*@if (@xx)
print("xx defined")
@else @*/
print("xx not defined")
/*@end @*/
See Also
/fast
Enables faster program execution.
/fast[+ | -]
Arguments
+|-
/fast is on by default. /fast or /fast+ causes the compiler to generate an output file that is speed-optimized, however, if this
option is used certain language features from previous versions will not be supported. Specifying /fast-, on the other hand, will
provide for backward language compatibility, but the compiler will produce an output file that is not optimized for speed.
Remarks
When /fast is in effect,
All variables must be declared.
Functions become constants and you cannot assign to them or redefine them.
Predefined properties of built-in objects are marked DontEnum, DontDelete, ReadOnly.
Properties on the built-in objects may not be expanded, other than the Global object (which is also the global scope).
The arguments variable is not available within function calls.
Assignments to read-only variables, fields, or methods generate errors.
Note The /fast- compilation mode is provided to help developers build standalone executables from legacy
JScript code. When developing new executables or libraries, use the /fast+ compilation mode. This ensures
better performance and better compatibility with other assemblies.
Security Note The /fast- compilation mode enables the use of language features from previous versions not
available in /fast+ mode. Misuse of these features can result in a less secure program. For more information, see
Security Considerations for JScript.
Example
Create an output file that is speed-optimized at the expense of full backward language compatibility :
jsc test.js
See Also
/help, /?
Displays compiler command-line help.
/help
-or-
/?
Remarks
This option causes the compiler to display a list of compiler options along with a brief description of each option.
See Also
JScript Compiler Options
JScript .NET
/lcid
Specifies code page for compiler messages.
/lcid:id
Arguments
id
The id of the code page to use for printing out messages from the compiler.
See Also
JScript Compiler Options
JScript .NET
/lib
Specifies assembly reference locations.
/lib:dir1[, dir2]
Arguments
dir1
A directory for the compiler to look in if a referenced assembly is not found in the current working directory (the directory from
which the compiler is invoked) or in the common language runtime's system directory.
dir2
One or more additional directories for searching for assembly references. Separate additional directory names with a comma or
semicolon.
Remarks
The /lib option specifies the location of assemblies referenced via the /reference option.
The compiler searches for assembly references that are not fully qualified in the following order:
1. Current working directory. This is the directory from which the compiler is invoked.
2. The common language runtime system directory.
3. Directories specified by /lib.
4. Directories specified by the LIB environment variable.
Use /reference to specify an assembly reference.
/lib is additive; specifying it more than once appends to any prior values.
Example
Compile t2.js to create an .exe. The compiler will look in the working directory and in the root directory of the C drive for assembly
references.
See Also
JScript Compiler Options
JScript .NET
/linkresource
Creates a link to a managed resource.
/linkresource:filename[,name[,public|private]]
-or-
/linkres:filename[,name[,public|private]]
Arguments
filename
The resource file to link to the assembly.
name[,public|private] (optional)
The logical name for the resource; the name used to load the resource. The default is the name of the file. Optionally, you can
specify whether the file is public or private in the assembly manifest. For example, /linkres:filename.res,myname.res,public. By
default, filename is public in the assembly.
Remarks
The /linkresource option does not embed the resource file in the output file. Use the /resource option to embed a resource file in
the output file.
If filename is a .NET Framework resource file created, for example, by the Resource File Generator (Resgen.exe) or in the
development environment, it can be accessed with members in the System.Resources namespace (see
System.Resources.ResourceManager for more information). For all other resources, use the GetManifestResource* methods in
System.Reflection.Assembly class to access the resource at run time.
filename can be any file format. For example, you may want to make a native DLL part of the assembly, so it can be installed into
the Global Assembly Cache and accessed from managed code in the assembly.
/linkres is the short form of /linkresource.
Example
Compile in.js and link to resource file rf.resource:
See Also
JScript Compiler Options
JScript .NET
/nologo
Suppresses banner information.
/nologo
Remarks
The /nologo option suppresses display of the banner when the compiler starts.
See Also
/nostdlib
Does not import a standard library.
/nostdlib[+ | -]
Arguments
+|-
/nostdlib or /nostdlib+ option causes the compiler to not import mscorlib.dll. Use this option if you want to define or create
your own System namespace and objects. If you do not specify /nostdlib, mscorlib.dll will be imported into your program (same
as specifying /nostdlib-).
Remarks
Specifying /nostdlib+ also specifies /autoref-.
Example
If you have a component called System. String (or any other name in mscorlib) the only way you could get at your component
would be to use
/nostdlib /r:your_library,mscorlib
to search your library before mscorlib. Commonly, you would not a define a namespace in your application called System.
See Also
/out
Sets output filename.
/out:filename
Arguments
filename
The name of the output file created by the compiler.
Remarks
The /out option specifies the name of the output file. The compiler expects to find one or more source code files following the /out
option.
If you do not specify the name of the output file:
An .exe will take its name from the first source code file used to build the output file.
A .dll will take its name from the first source code file used to build the output file.
On the command line, it is possible to specify multiple output files for a compilation. All source code files specified after an /out
option will be compiled into the output file specified by that /out option.
Specify the full name and extension of the file you want to create. The extension must be either .exe or .dll. It is possible to specify
a .dll extension for /t:exe projects.
Example
Compile t2.js and create output file t2.exe and build t3.js and create output file t3.exe:
See Also
JScript Compiler Options
JScript .NET
/print
Enables print command.
/print[+ | -]
Arguments
+|-
By default, /print or /print+ causes the compiler to enable the use of the print statement. An example of a print statement is,
print("hello world");
See Also
JScript Compiler Options
JScript .NET
/reference
Imports metadata.
/reference:file[;file2]
Arguments
file, file2
One or more files that contains an assembly manifest. To import more than one file, separate file names with either a comma or
a semicolon.
Remarks
The /reference option directs the compiler to make public type information in the specified files available to the project you are
currently compiling.
The file(s) you reference must be assemblies. For example, the referenced files must have been created with the /target:library
compiler option in Visual C#, JScript or Visual Basic, or the /clr /LD compiler options of Visual C++.
/reference cannot take a module as input.
At run time, you should anticipate that only one .exe assembly can be loaded per process, even though, there may be times when
more than one .exe might be loaded in the same process.. Therefore, you are recommended to not pass an assembly built with
/target:exe or /target:winexe to /reference if you are compiling with /target:winexe or /target:exe. This condition may be modified
in future versions of the common language runtime.
If you reference an assembly (Assembly A), which itself references another assembly (Assembly B), you will need to reference
assembly B if:
A type you use from Assembly A inherits from a type or implements an interface from Assembly B.
If you invoke a field, property, event, or method that has a return type or parameter type from Assembly B.
Use /lib to specify the directory in which one or more of your assembly references is located.
In order for the compiler to recognize a type in an assembly (not a module), it needs to be forced to resolve the type, which you
can do, for example, by defining an instance of the type. There are other ways to resolve type names in an assembly for the
compiler, for example, if you inherit from a type in an assembly, the type name will then become known to the compiler.
/r is the short form of /reference.
Note The JScript .NET compiler, jsc.exe, can reference assemblies created using the same version or an earlier
version of the compiler. However, the JScript .NET compiler might encounter compile-time errors when referencing
assemblies created with later versions of the compiler. For example, the JScript .NET 2003 compiler can reference any
assembly created with the JScript .NET 2002 compiler, although the JScript .NET 2002 compiler may fail when
referencing an assembly created with JScript .NET 2003.
Example
Compile source file input.js and import metadata from metad1.dll and metad2.dll to produce out.exe:
See Also
JScript Compiler Options
JScript .NET
/resource
Embeds a managed resource in an assembly.
/resource:filename[,name[,public|private]]
-or-
/res:filename[,name[,public|private]]
Arguments
filename
The resource file you want to embed in the output file.
name[,public|private] (optional)
The logical name for the resource; the name used to load the resource. The default is the name of the file. Optionally, you can
specify whether the file is public or private in the assembly manifest. For example, /res:filename.res,myname.res,public. By
default, filename is public in the assembly.
Remarks
Use the /resource option to link a resource to an assembly and not place the resource file in the output file.
If filename is a .NET Framework resource file created, for example, by the Resource File Generator (Resgen.exe) or in the
development environment, it can be accessed with members in the System.Resources namespace (see
System.Resources.ResourceManager for more information). For all other resources, use the GetManifestResource* methods in
System.Reflection.Assembly class to access the resource at run time.
/res is the short form of /resource.
Example
Compile in.js and attach resource file rf.resource:
See Also
JScript Compiler Options
JScript .NET
/target
Specifies output file format.
The /target compiler option can be specified in one of three forms:
/target:exe
Creates a console .exe file.
/target:library
Creates a (.dll) code library.
/target:winexe
Creates a Windows program.
Remarks
/target causes a .NET Framework assembly manifest to be placed in an output file.
If you create an assembly, you can indicate that all or part of your code is CLS compliant with the CLSCompliantAttribute Class
attribute.
import System;
[assembly:System.CLSCompliant(true)] // specify assembly compliance
See Also
JScript Compiler Options
JScript .NET
/target:exe
Creates a console application.
/target:exe
Remarks
The /target:exe option causes the compiler to create an executable (EXE), console application. The /target:exe option is in effect by
default. The executable file will be created with the .exe extension.
Unless otherwise specified with the /out option, the output file name takes the name of the first source code file in the
compilation for the each output file.
Use /target:winexe to create a Windows program executable.
When specified at the command line, all files up to the next /out or /target:library option are used to create the .exe. The
/target:exe option is in effect for all files since the previous /out or /target:library option.
/t is the short form of /target.
Example
Each of the following command lines will compile in.js, creating in.exe:
See Also
/target | JScript Compiler Options
JScript .NET
/target:library
Creates a code library.
/target:library
Remarks
The /target:library option causes the compiler to create a DLL rather than an executable file (EXE). The DLL will be created with the
.dll extension.
Unless otherwise specified with the /out option, the output file name takes the name of the first input file.
When specified at the command line, all source files up to the next /out or /target:exe option are used to create the .dll.
/t is the short form of /target.
Note The JScript .NET compiler, jsc.exe, can reference assemblies created using the same version or an earlier
version of the compiler. However, the JScript .NET compiler might encounter compile-time errors when referencing
assemblies created with later versions of the compiler. For example, the JScript .NET 2003 compiler can reference any
assembly created with the JScript .NET 2002 compiler, although the JScript .NET 2002 compiler may fail when
referencing an assembly created with JScript .NET 2003.
Example
Compile in.js, creating in.dll:
See Also
/target | JScript Compiler Options
JScript .NET
/target:winexe
Creates a Windows program.
/target:winexe
Remarks
The /target:winexe option causes the compiler to create an executable (EXE), Windows program. The executable file will be created
with the .exe extension. A Windows program is one that provides a user interface from the .NET Framework library.
Use /target:exe to create a console application.
Unless otherwise specified with the /out option, the output file name takes the name of the first source code file in the
compilation of the output file.
When specified at the command line, all files until the next /out or /target option are used to create the Windows program.
/t is the short form of /target.
Example
Compile in.cs into a Windows program:
See Also
/target | JScript Compiler Options
JScript .NET
/utf8output
Displays compiler output using UTF-8 encoding.
/utf8output[+ | -]
Arguments
+|-
By default /utf8output- displays output directly on the console. Specifying /utf8output or /utf8output+ redirects compiler
output to a file.
Remarks
In some international configurations, compiler output cannot correctly be displayed in the console. In these configurations, use
/utf8output and redirect compiler output to a file.
The default for this option is /utf8output-.
Specifying /utf8output is the same as specifying /utf8output+.
Example
Compile in.js and have the compiler display output using UTF-8 encoding:
See Also
JScript Compiler Options
JScript .NET
/versionsafe
Flags implicit overrides.
/versionsafe[+ | -]
Arguments
+|-
By default, /versionsafe- is in effect and the compiler will not generate an error if it finds an implicit method override.
/versionsafe+, which is the same as /versionsafe, causes the compiler to generate errors for implicit method overrides.
Remarks
Use the hide or override keywords to explicitly indicate the override status of a method. For example, the following code will
generate an error when compiled with /versionsafe:
class c
{
function f()
{
}
}
class d extends c
{
function f()
{
}
}
Example
Compile in.js and have the compiler generate errors if it finds an implicit method override.:
See Also
JScript Compiler Options
JScript .NET
/warn
Specifies warning level.
/warn:option
Arguments
option
The minimum warning level you want displayed for the build. Valid values are 0-4:
Warning level Meaning
0 Turns off emission of all warning messages; display errors only.
1 Displays errors and severe warning messages.
2 Displays all errors and level 1 warnings plus certain, less-severe warnings, such as warnings ab
out hiding class members.
3 Displays errors, level 1 and 2 warnings, plus certain, less-severe warnings, such as warnings ab
out expressions that always evaluate to true or false.
4 Displays all errors, level 1-3 warnings, plus informational warnings. This is the default warning
level at the command line.
Remarks
The /warn option specifies the warning level for the compiler to display.
Use /warnaserror to treat all warnings as errors up to the warning level specified. Higher-level warnings are ignored.
The compiler always displays errors.
/w is the short form of /warn.
Example
Compile in.js and have the compiler only display level 1 warnings:
See Also
JScript Compiler Options
JScript .NET
/warnaserror
Treats warnings as errors.
/warnaserror[+ | -]
Arguments
+|-
The /warnaserror+ option treats all warnings as errors.
Remarks
Any messages that would ordinarily be reported as warnings are instead reported as errors. No output files are created. The build
continues in order to identify as many errors/warnings as possible.
By default, /warnaserror- is in effect, which causes warnings to not prevent the generation of an output file. /warnaserror, which is
the same as /warnaserror+, causes warnings to be treated as errors.
Use /warn to specify the level of warnings that you want the compiler to display.
Example
Compile in.js and have the compiler display no warnings:
See Also
JScript Compiler Options
JScript .NET
/win32res
Inserts a Win32 resource in the output file.
/win32res:filename
Arguments
filename
The resource file that you want to add to your output file.
Remarks
A Win32 resource file can be created with the Resource Compiler.
A Win32 resource can contain version or bitmap (icon) information that would help identify your application in the Windows
Explorer. If you do not specify /win32res, the compiler will generate version information based on the assembly version.
See /linkresource (to reference) or /resource (to attach) a .NET Framework resource file.
Example
Compile in.js and attach a Win32 resource file rf.res to produce in.exe:
See Also
JScript Compiler Options