getBarState()

getBarState()

 

getBarState()

 

Returns a status flag from the Formula Engine indicating the bar processing that is currently taking place.

 

One of 3 flags can be returned:

 

BARSTATE_ALLBARS

BARSTATE_NEWBAR

BARSTATE_CURRENTBAR

 

Examples:

 

nState = getBarState();
if (nState == BARSTATE_ALLBARS) {
 //the bars are being loaded by the script. This happens when a script is first loaded
 debugPrint("Script is loading\n");
}
else if (nState == BARSTATE_NEWBAR) {
 //this flag is set when a new bar is coming in
 debugPrint("The first tick of a new bar has arrived\n");
}
else if (nState == BARSTATE_CURRENTBAR) {
 //this flag is set as each new tick comes in
 debugPrint("A new tick has arrived\n");

}

 

Some typical usages would be to use the BARSTATE_ALLBARS flag to initialize some data when the script first loads:

 

if (getBarState() == BARSTATE_ALLBARS) {
 sSymbol = getSymbol();  //grab the name of the symbol being charted for later use
 nInterval = getInterval();  //grab the bar interval we are using for later use
 return;
}

 

or to cycle an array when a new bars comes in....

 

if (getBarState() == BARSTATE_NEWBAR) {
 myArray.unshift(0);
 myArray.pop();
}