rsspice 0.1.0

Pure Rust port of the SPICE Toolkit for space geometry
Documentation
//
// GENERATED FILE
//

use super::*;
use crate::SpiceContext;
use f2rust_std::*;

const ISPACE: i32 = 32;

/// Last non-blank character
///
/// Return the index of the last non-blank character in
/// a character string.
///
/// # Brief I/O
///
/// ```text
///  VARIABLE  I/O  DESCRIPTION
///  --------  ---  --------------------------------------------------
///  STRING     I   Input character string.
///
///  The function returns the index of the last non-blank character in
///  STRING.
/// ```
///
/// # Detailed Input
///
/// ```text
///  STRING   is the input character string.
/// ```
///
/// # Detailed Output
///
/// ```text
///  The function returns the index of the last non-blank character in
///  the input string. If there are no non-blank characters in the
///  string, LASTNB is zero.
/// ```
///
/// # Exceptions
///
/// ```text
///  Error free.
/// ```
///
/// # Particulars
///
/// ```text
///  If the string is blank, return zero. Otherwise, step through
///  the string one character at a time until something other than
///  a blank is found. Return the index of that something within
///  the string.
/// ```
///
/// # Examples
///
/// ```text
///  The following examples illustrate the use of LASTNB.
///
///        LASTNB ( 'ABCDE'              )   = 5
///        LASTNB ( 'AN EXAMPLE'         )   = 10
///        LASTNB ( 'AN EXAMPLE        ' )   = 10
///        LASTNB ( '                  ' )   = 0
/// ```
///
/// # Author and Institution
///
/// ```text
///  J. Diaz del Rio    (ODC Space)
///  K.R. Gehringer     (JPL)
///  W.L. Taber         (JPL)
///  I.M. Underwood     (JPL)
/// ```
///
/// # Version
///
/// ```text
/// -    SPICELIB Version 2.1.0, 08-APR-2021 (JDR)
///
///         Added IMPLICIT NONE statement.
///
///         Edited the header to comply with NAIF standard.
///
/// -    SPICELIB Version 2.0.0, 12-MAR-1996 (KRG)
///
///         Modified the comparison to use integer values and the ICHAR()
///         function. This improves the performance of the subroutine.
///
/// -    SPICELIB Version 1.0.2, 10-MAR-1992 (WLT)
///
///         Comment section for permuted index source lines was added
///         following the header.
///
/// -    SPICELIB Version 1.0.1, 07-DEC-1990 (IMU)
///
///         Corrected a misprint in the description of LASTNB.
///
/// -    SPICELIB Version 1.0.0, 31-JAN-1990 (IMU)
/// ```
pub fn lastnb(string: &str) -> i32 {
    let ret = LASTNB(string.as_bytes());
    ret
}

//$Procedure LASTNB ( Last non-blank character )
pub fn LASTNB(STRING: &[u8]) -> i32 {
    let mut LASTNB: i32 = 0;

    //
    // Local parameters
    //

    //
    // Local variables
    //

    //
    // Just like it says in the header.
    //
    if fstr::eq(STRING, b" ") {
        LASTNB = 0;
    } else {
        for I in intrinsics::range(intrinsics::LEN(STRING), 1, -1) {
            if (intrinsics::ICHAR(fstr::substr(STRING, I..=I)) != ISPACE) {
                LASTNB = I;
                return LASTNB;
            }
        }
    }

    LASTNB
}