## org.apache.tools.ant.taskdefs.optional.perforce
Class P4Fstat

    java.lang.Object
      |
      +--org.apache.tools.ant.ProjectComponent
            |
            +--org.apache.tools.ant.Task
                  |
                  +--org.apache.tools.ant.taskdefs.optional.perforce.P4Base
                        |
                        +--org.apache.tools.ant.taskdefs.optional.perforce.P4Fstat

public class P4Fstat
extends P4Base

P4Fstat - find out which files are under Perforce control and which are not.
Example Usage:

     <project name="p4fstat" default="p4fstat"
     basedir="C:\dev\gnu">
         <target name="p4fstat" >
             <p4fstat showfilter="all">
                 <fileset dir="depot" includes="**\/*"/>
             </p4fstat>
         </target>
     </project>

Author:
  Miha, Les Hughes, Anli Shundi

Field Summary

Fields inherited from class org.apache.tools.ant.taskdefs.optional.perforce.P4Base
`failOnError, P4Client, P4CmdOpts, P4Opts, P4Port, P4User, P4View, shell, util`

Fields inherited from class org.apache.tools.ant.Task
`description, location, target, taskName, taskType, wrapper`

Fields inherited from class org.apache.tools.ant.ProjectComponent
`project`

Constructor Summary
`P4Fstat()`

Method Summary
`void` `addFileset(FileSet set)` adds a fileset to be examined by p4fstat
`void` `execute()` executes the p4fstat task
`int` `getLengthOfTask()` return the number of files seen
`void` `setChangelist(int changelist)` sets optionally a change list number
`void` `setShowFilter(java.lang.String filter)` sets the filter that one wants applied OptionMeaning allall files under Perforce control or not existingonly files under Perforce control non-existingonly files not under Perforce control or not

Methods inherited from class org.apache.tools.ant.taskdefs.optional.perforce.P4Base
`execP4Command, execP4Command, getErrorMessage, getInError, init, setClient, setCmdopts, setErrorMessage, setFailonerror, setGlobalopts, setInError, setPort, setUser, setView`

Methods inherited from class org.apache.tools.ant.Task
`getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType`

Methods inherited from class org.apache.tools.ant.ProjectComponent
`getProject, setProject`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### P4Fstat

    public P4Fstat()

Method Detail

### setShowFilter

    public void setShowFilter(java.lang.String filter)

  sets the filter that one wants applied

  Option | Meaning
  --- | ---
  all | all files under Perforce control or not
  existing | only files under Perforce control
  non-existing | only files not under Perforce control or not

  Parameters:
    `filter` - should be one of all|existing|non-existing

### setChangelist

    public void setChangelist(int changelist)
                       throws BuildException

  sets optionally a change list number

  Parameters:
    `changelist` - change list that one wants information about
  Throws:
    `BuildException` - if the change list number is negative

### addFileset

    public void addFileset(FileSet set)

  adds a fileset to be examined by p4fstat

  Parameters:
    `set` - the fileset to add

### execute

    public void execute()
                 throws BuildException

  executes the p4fstat task

  Overrides:
    `execute` in class `Task`
  Throws:
    `BuildException` - if no files are specified

### getLengthOfTask

    public int getLengthOfTask()

  return the number of files seen

  Returns:
    the number of files seen

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.