📄 range.html
字号:
<FONT color="green">143</FONT> /**<a name="line.143"></a><FONT color="green">144</FONT> * Returns <code>true</code> if the range intersects with the specified <a name="line.144"></a><FONT color="green">145</FONT> * range, and <code>false</code> otherwise.<a name="line.145"></a><FONT color="green">146</FONT> * <a name="line.146"></a><FONT color="green">147</FONT> * @param b0 the lower bound (should be <= b1).<a name="line.147"></a><FONT color="green">148</FONT> * @param b1 the upper bound (should be >= b0).<a name="line.148"></a><FONT color="green">149</FONT> * <a name="line.149"></a><FONT color="green">150</FONT> * @return A boolean.<a name="line.150"></a><FONT color="green">151</FONT> */<a name="line.151"></a><FONT color="green">152</FONT> public boolean intersects(double b0, double b1) {<a name="line.152"></a><FONT color="green">153</FONT> if (b0 <= this.lower) {<a name="line.153"></a><FONT color="green">154</FONT> return (b1 > this.lower);<a name="line.154"></a><FONT color="green">155</FONT> }<a name="line.155"></a><FONT color="green">156</FONT> else {<a name="line.156"></a><FONT color="green">157</FONT> return (b0 < this.upper && b1 >= b0);<a name="line.157"></a><FONT color="green">158</FONT> }<a name="line.158"></a><FONT color="green">159</FONT> }<a name="line.159"></a><FONT color="green">160</FONT> <a name="line.160"></a><FONT color="green">161</FONT> /**<a name="line.161"></a><FONT color="green">162</FONT> * Returns the value within the range that is closest to the specified <a name="line.162"></a><FONT color="green">163</FONT> * value.<a name="line.163"></a><FONT color="green">164</FONT> * <a name="line.164"></a><FONT color="green">165</FONT> * @param value the value.<a name="line.165"></a><FONT color="green">166</FONT> * <a name="line.166"></a><FONT color="green">167</FONT> * @return The constrained value.<a name="line.167"></a><FONT color="green">168</FONT> */<a name="line.168"></a><FONT color="green">169</FONT> public double constrain(double value) {<a name="line.169"></a><FONT color="green">170</FONT> double result = value;<a name="line.170"></a><FONT color="green">171</FONT> if (!contains(value)) {<a name="line.171"></a><FONT color="green">172</FONT> if (value > this.upper) {<a name="line.172"></a><FONT color="green">173</FONT> result = this.upper; <a name="line.173"></a><FONT color="green">174</FONT> }<a name="line.174"></a><FONT color="green">175</FONT> else if (value < this.lower) {<a name="line.175"></a><FONT color="green">176</FONT> result = this.lower; <a name="line.176"></a><FONT color="green">177</FONT> }<a name="line.177"></a><FONT color="green">178</FONT> }<a name="line.178"></a><FONT color="green">179</FONT> return result;<a name="line.179"></a><FONT color="green">180</FONT> }<a name="line.180"></a><FONT color="green">181</FONT> <a name="line.181"></a><FONT color="green">182</FONT> /**<a name="line.182"></a><FONT color="green">183</FONT> * Creates a new range by combining two existing ranges.<a name="line.183"></a><FONT color="green">184</FONT> * <P><a name="line.184"></a><FONT color="green">185</FONT> * Note that:<a name="line.185"></a><FONT color="green">186</FONT> * <ul><a name="line.186"></a><FONT color="green">187</FONT> * <li>either range can be <code>null</code>, in which case the other <a name="line.187"></a><FONT color="green">188</FONT> * range is returned;</li><a name="line.188"></a><FONT color="green">189</FONT> * <li>if both ranges are <code>null</code> the return value is <a name="line.189"></a><FONT color="green">190</FONT> * <code>null</code>.</li><a name="line.190"></a><FONT color="green">191</FONT> * </ul><a name="line.191"></a><FONT color="green">192</FONT> *<a name="line.192"></a><FONT color="green">193</FONT> * @param range1 the first range (<code>null</code> permitted).<a name="line.193"></a><FONT color="green">194</FONT> * @param range2 the second range (<code>null</code> permitted).<a name="line.194"></a><FONT color="green">195</FONT> *<a name="line.195"></a><FONT color="green">196</FONT> * @return A new range (possibly <code>null</code>).<a name="line.196"></a><FONT color="green">197</FONT> */<a name="line.197"></a><FONT color="green">198</FONT> public static Range combine(Range range1, Range range2) {<a name="line.198"></a><FONT color="green">199</FONT> if (range1 == null) {<a name="line.199"></a><FONT color="green">200</FONT> return range2;<a name="line.200"></a><FONT color="green">201</FONT> }<a name="line.201"></a><FONT color="green">202</FONT> else {<a name="line.202"></a><FONT color="green">203</FONT> if (range2 == null) {<a name="line.203"></a><FONT color="green">204</FONT> return range1;<a name="line.204"></a><FONT color="green">205</FONT> }<a name="line.205"></a><FONT color="green">206</FONT> else {<a name="line.206"></a><FONT color="green">207</FONT> double l = Math.min(range1.getLowerBound(), <a name="line.207"></a><FONT color="green">208</FONT> range2.getLowerBound());<a name="line.208"></a><FONT color="green">209</FONT> double u = Math.max(range1.getUpperBound(), <a name="line.209"></a><FONT color="green">210</FONT> range2.getUpperBound());<a name="line.210"></a><FONT color="green">211</FONT> return new Range(l, u);<a name="line.211"></a><FONT color="green">212</FONT> }<a name="line.212"></a><FONT color="green">213</FONT> }<a name="line.213"></a><FONT color="green">214</FONT> }<a name="line.214"></a><FONT color="green">215</FONT> <a name="line.215"></a><FONT color="green">216</FONT> /**<a name="line.216"></a><FONT color="green">217</FONT> * Returns a range that includes all the values in the specified <a name="line.217"></a><FONT color="green">218</FONT> * <code>range</code> AND the specified <code>value</code>.<a name="line.218"></a><FONT color="green">219</FONT> * <a name="line.219"></a><FONT color="green">220</FONT> * @param range the range (<code>null</code> permitted).<a name="line.220"></a><FONT color="green">221</FONT> * @param value the value that must be included.<a name="line.221"></a><FONT color="green">222</FONT> * <a name="line.222"></a><FONT color="green">223</FONT> * @return A range.<a name="line.223"></a><FONT color="green">224</FONT> * <a name="line.224"></a><FONT color="green">225</FONT> * @since 1.0.1<a name="line.225"></a><FONT color="green">226</FONT> */<a name="line.226"></a><FONT color="green">227</FONT> public static Range expandToInclude(Range range, double value) {<a name="line.227"></a><FONT color="green">228</FONT> if (range == null) {<a name="line.228"></a><FONT color="green">229</FONT> return new Range(value, value);<a name="line.229"></a><FONT color="green">230</FONT> }<a name="line.230"></a><FONT color="green">231</FONT> if (value < range.getLowerBound()) {<a name="line.231"></a><FONT color="green">232</FONT> return new Range(value, range.getUpperBound());<a name="line.232"></a><FONT color="green">233</FONT> }<a name="line.233"></a><FONT color="green">234</FONT> else if (value > range.getUpperBound()) {<a name="line.234"></a><FONT color="green">235</FONT> return new Range(range.getLowerBound(), value);<a name="line.235"></a><FONT color="green">236</FONT> }<a name="line.236"></a><FONT color="green">237</FONT> else {<a name="line.237"></a><FONT color="green">238</FONT> return range;<a name="line.238"></a><FONT color="green">239</FONT> }<a name="line.239"></a><FONT color="green">240</FONT> }<a name="line.240"></a><FONT color="green">241</FONT> <a name="line.241"></a><FONT color="green">242</FONT> /**<a name="line.242"></a><FONT color="green">243</FONT> * Creates a new range by adding margins to an existing range.<a name="line.243"></a><FONT color="green">244</FONT> * <a name="line.244"></a><FONT color="green">245</FONT> * @param range the range (<code>null</code> not permitted).<a name="line.245"></a><FONT color="green">246</FONT> * @param lowerMargin the lower margin (expressed as a percentage of the <a name="line.246"></a><FONT color="green">247</FONT> * range length).<a name="line.247"></a><FONT color="green">248</FONT> * @param upperMargin the upper margin (expressed as a percentage of the <a name="line.248"></a><FONT color="green">249</FONT> * range length).<a name="line.249"></a><FONT color="green">250</FONT> * <a name="line.250"></a><FONT color="green">251</FONT> * @return The expanded range.<a name="line.251"></a><FONT color="green">252</FONT> */<a name="line.252"></a><FONT color="green">253</FONT> public static Range expand(Range range, <a name="line.253"></a><FONT color="green">254</FONT> double lowerMargin, double upperMargin) {<a name="line.254"></a><FONT color="green">255</FONT> if (range == null) {<a name="line.255"></a><FONT color="green">256</FONT> throw new IllegalArgumentException("Null 'range' argument."); <a name="line.256"></a><FONT color="green">257</FONT> }<a name="line.257"></a><FONT color="green">258</FONT> double length = range.getLength();<a name="line.258"></a><FONT color="green">259</FONT> double lower = length * lowerMargin;<a name="line.259"></a><FONT color="green">260</FONT> double upper = length * upperMargin;<a name="line.260"></a><FONT color="green">261</FONT> return new Range(range.getLowerBound() - lower, <a name="line.261"></a><FONT color="green">262</FONT> range.getUpperBound() + upper);<a name="line.262"></a><FONT color="green">263</FONT> }<a name="line.263"></a><FONT color="green">264</FONT> <a name="line.264"></a><FONT color="green">265</FONT> /**<a name="line.265"></a><FONT color="green">266</FONT> * Shifts the range by the specified amount.<a name="line.266"></a><FONT color="green">267</FONT> * <a name="line.267"></a><FONT color="green">268</FONT> * @param base the base range.<a name="line.268"></a><FONT color="green">269</FONT> * @param delta the shift amount.<a name="line.269"></a><FONT color="green">270</FONT> * <a name="line.270"></a><FONT color="green">271</FONT> * @return A new range.<a name="line.271"></a><FONT color="green">272</FONT> */<a name="line.272"></a><FONT color="green">273</FONT> public static Range shift(Range base, double delta) {<a name="line.273"></a><FONT color="green">274</FONT> return shift(base, delta, false);<a name="line.274"></a><FONT color="green">275</FONT> }<a name="line.275"></a><FONT color="green">276</FONT> <a name="line.276"></a><FONT color="green">277</FONT> /**<a name="line.277"></a><FONT color="green">278</FONT> * Shifts the range by the specified amount.<a name="line.278"></a><FONT color="green">279</FONT> * <a name="line.279"></a><FONT color="green">280</FONT> * @param base the base range.<a name="line.280"></a><FONT color="green">281</FONT> * @param delta the shift amount.<a name="line.281"></a><FONT color="green">282</FONT> * @param allowZeroCrossing a flag that determines whether or not the <a name="line.282"></a><FONT color="green">283</FONT> * bounds of the range are allowed to cross<a name="line.283"></a><FONT color="green">284</FONT> * zero after adjustment.<a name="line.284"></a><FONT color="green">285</FONT> * <a name="line.285"></a><FONT color="green">286</FONT> * @return A new range.<a name="line.286"></a><FONT color="green">287</FONT> */<a name="line.287"></a>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -