[jawsscripts] Re: stringContainsFromRight

  • From: Doug Lee <doug.lee@xxxxxxxxxxxxxxxx>
  • To: jawsscripts@xxxxxxxxxxxxx
  • Date: Fri, 13 Jun 2014 09:33:21 -0400

The danger of using an undocumented function is that it may go away. A
second danger is that it may be buggy but hard to file a bug against,
since it isn't part of the published interface for scripting. For
these reasons, if I stumble across an undocumented function, I usually
don't start advertising it until I find two things hold true: (1) it
stays in JAWS reliably across a few releases, and (2) it has a clear
and helpful use that continues to work as expected across those
releases.

Even then, sometimes I run afoul of Freedom Scientific's plans.
Witness the FindCaret function: I and others used it for years but
quietly for the most part. Then coincidentally at about he same time,
I and a couple other people started mentioning it, and Freedom
Scientific removed it from JAWS because it was unreliable. And it was
indeed unreliable, unless you were careful when and how to use it. It
was re-added to JAWS later and finally documented; you can find it
today in the FSDN and builtin.jsd.

All that said, StringContainsFromRight is certainly useful, has been
in JAWS for many years and many versions, and would be a good
candidate for added documentation.

I don't have a list of undocumented functions handy by the way. :-)

On Fri, Jun 13, 2014 at 02:33:09PM +1000, Geoff Chapman wrote:
My goodness Doug! This StringContainsFromRight sounds like a rather useful 
puppy to have known about for lots of people! Thanks for sharing it.

I'm gonna write to eric right now and ask him why this function isn't 
included in the list of functions that comes up
in Script manager after hitting control+I then tabbing once to that list of 
functions.
And, of course it begs the question, How many other functions might there be 
like this!

Would you perhaps care to compile a list of them that you know about? Then 
we could ask Erric to get them all included!
I'm looking in version 12 right now though.



----- Original Message ----- 
From: "Doug Lee" <doug.lee@xxxxxxxxxxxxxxxx>
To: <jawsscripts@xxxxxxxxxxxxx>
Sent: Friday, June 06, 2014 8:38 PM
Subject: [jawsscripts] Re: Query about a string function 
stringContainsFromRight


> It works just like stringContains except that it returns the start of
> the last occurrence of the search string rather than that of the first
> occurrence. TaxAct 2006.jss and TritonIM.jss contain uses of this
> function and have for quite a while. I'm actually curious why it's not
> listed in builtin.jsd, but I never remember to ask. :-)
>
> On Fri, Jun 06, 2014 at 09:43:44AM +0530, Jitendra wrote:
> Alright, but how did you find it, and in case we need to use it, is there
> any documentation on it?
> Thank you.
> ----- Original Message ----- 
> From: "Doug Lee" <doug.lee@xxxxxxxxxxxxxxxx>
> To: <jawsscripts@xxxxxxxxxxxxx>
> Sent: Thursday, June 05, 2014 4:24 PM
> Subject: [jawsscripts] Re: Query about a string function
> stringContainsFromRight
>
>
> StringContains searches from the left; I am not aware of a function
> actually called stringContainsFromLeft. As for
> stringContainsFromRight, I found that one a long time ago.
>
> On Thu, Jun 05, 2014 at 04:08:17PM +0530, Jitendra wrote:
> Hello doug, and may be others who know
> I often found your using of the functions, stringContainsFromRight and
> stringContainsFromLeft, but I did not find them in JAWS, where are those
> functions, and how did you find them?
> in case we want to use them, how do we know what parameters are needed.
> Thank you, Jitendra.
> --- Disclaimer --- The information in this mail is confidential and is
> intended solely for addressee. Access to this mail by anyone else is
> unauthorised. Copying or further distribution beyond the original 
> recipient
> may be unlawful. Any opinion expressed in this mail is that of sender and
> does not necessarily reflect that of State Bank group. --- 
> __________???
>
> View the list's information and change your settings at
> http://www.freelists.org/list/jawsscripts
>
> -- 
> Doug Lee, Senior Accessibility Programmer
> SSB BART Group - Accessibility-on-Demand
> mailto:doug.lee@xxxxxxxxxxxxxxxx  http://www.ssbbartgroup.com
> "While they were saying among themselves it cannot be done,
> it was done." --Helen Keller
> __________???
>
> View the list's information and change your settings at
> http://www.freelists.org/list/jawsscripts
>
>
> --- Disclaimer --- The information in this mail is confidential and is 
> intended solely for addressee. Access to this mail by anyone else is 
> unauthorised. Copying or further distribution beyond the original 
> recipient may be unlawful. Any opinion expressed in this mail is that of 
> sender and does not necessarily reflect that of State Bank group. --- 
> __________???
>
> View the list's information and change your settings at
> http://www.freelists.org/list/jawsscripts
>
> -- 
> Doug Lee, Senior Accessibility Programmer
> SSB BART Group - Accessibility-on-Demand
> mailto:doug.lee@xxxxxxxxxxxxxxxx  http://www.ssbbartgroup.com
> "While they were saying among themselves it cannot be done,
> it was done." --Helen Keller
> __________???
>
> View the list's information and change your settings at
> http://www.freelists.org/list/jawsscripts
>
> 

__________???

View the list's information and change your settings at 
http://www.freelists.org/list/jawsscripts

-- 
Doug Lee, Senior Accessibility Programmer
SSB BART Group - Accessibility-on-Demand
mailto:doug.lee@xxxxxxxxxxxxxxxx  http://www.ssbbartgroup.com
"While they were saying among themselves it cannot be done,
it was done." --Helen Keller
__________�

View the list's information and change your settings at 
http://www.freelists.org/list/jawsscripts

Other related posts: