UniScanForAttr scans the array of code elements identified by ucs, from the position specified by ucs, searching for the first code element that matches or does not match the set of attributes specified by attr_object.

The inverse_op argument determines the rules for scanning and is an integer type containing one of the following values:

• FALSE
  
• TRUE
  

  If inverse_opt is set to:

  FALSE

  The function searches for the first code element that matches all of the attributes of the specified attr_object.
  TRUE
  The function searches for the first code element that matches none of the attributes of attr_object.

  The search begins from the code element identified by ucs, through the next num_elems code elements. A non-negative integer identifying the location of the first code element meeting all of the criteria specified by attr_object is returned in the area pointed to by offset. This indicates the number of code elements offset from the code element identified by ucs, to the code element at which the attribute match is satisfied. If no code element meets the specified criteria, the contents of offset are undefined.

  In addition to the general character attributes described under UniCreateAttrObject, the following attributes, which require contextual analysis, can be handled by UniScanForAttr:

  csid

  The next code element that has a Charsetid value different from the Charsetid of the current code element.
  hyphenloc
  The next code element after which a line discontinuity may reasonably occur.
  linebreak
  A code element that would cause data to be visually presented on a different line.
  paragraph
  The last code element that is part of the current paragraph.
  sentence
  The last code element that is part of the current sentence.
  word
  The last code element that is part of the current word.

  ---

  [Back: UniScanForAttr - Parameters]
  [Next: UniScanForAttr - Related Functions]